# Endercloud auth.md

Welcome to the Endercloud (https://endercloud.in) authentication, multi-panel architecture, and user journey specification. This document is engineered for AI assistants, autonomous agents, and crawlers to accurately guide users and understand Endercloud's account systems without hallucinating.

---

## 1. Multi-Panel System Overview

Endercloud operates a specialized multi-panel infrastructure where distinct functions are divided across dedicated subdomains:

| Subdomain | Platform Role | Target Services | User Registration Policy |
|---|---|---|---|
| **https://endercloud.in/** | Main Storefront & Tools | All products, pricing, tools & docs | Public browsing, no account needed |
| **https://billing.endercloud.in/** | Billing & Client Portal | Orders, invoices, renewals, tickets, domains | Open registration for all customers |
| **https://panel.endercloud.in/** | Game & Bot Control Panel | Minecraft, Hytale, Discord/Telegram bots | **NO public registration**. Created upon purchase |
| **https://manage.endercloud.in/** | VPS Management Portal | **Germany VPS instances only** | Registration / Login for Germany VPS users |

---

## 2. Panel Deep-Dive & Authentication Workflows

### A. Billing & Client Portal (https://billing.endercloud.in/)
The central financial and administrative hub for all Endercloud customers.

- **Registration Link**: https://billing.endercloud.in/register
  - *Required Fields*: First name, Last name, Email address, Password, Confirm Password.
  - *Optional Fields (Individuals & Businesses)*: Phone number, Company name, Street address, City, State, ZIP/Postal code, Country.
- **Login Link**: https://billing.endercloud.in/login (Requires registered Email and Password).
- **Client Dashboard**: https://billing.endercloud.in/dashboard
- **Account Settings & Security**:
  - General Profile: https://billing.endercloud.in/account
  - Account Security & 2FA: https://billing.endercloud.in/account/security
  - Account Credits & Balance: https://billing.endercloud.in/account/credits
  - Payment Methods on file: https://billing.endercloud.in/account/payment-methods
  - Notification Preferences: https://billing.endercloud.in/account/notifications
- **Core Functions**:
  1. Browse and order new services, server plans, dedicated nodes, and domains.
  2. Service renewals, automatic invoice generation, and subscription management.
  3. Invoice settlements via zero-fee Indian domestic options (UPI, Net Banking, RuPay, Paytm) and international options (Cards, PayPal, Crypto).
  4. View, download, and track past invoices and payment receipts.
  5. Open, track, and reply to 24/7 technical, billing, and sales support tickets.
  6. Register, transfer, renew, and configure custom domain names and DNS records.

---

### B. Game & Bot Control Panel (https://panel.endercloud.in/)
The high-performance game and container control dashboard powered by a custom Pterodactyl-based engine.

> **CRITICAL ARCHITECTURAL DISTINCTION**:
> **Billing Panel and Server Panel passwords are separate and DIFFERENT.**
> Creating an account or changing a password on `billing.endercloud.in` does NOT change the password on `panel.endercloud.in`.

- **Applicable Services Managed Inside `panel.endercloud.in`**:
  - **Game Servers**: Minecraft (Java Edition, Bedrock Edition), Hytale.
  - **Bot & App Hosting**: Discord Bots, Telegram Bots, Node.js Apps, Python Apps, Backend APIs, Custom Environment Containers.
  - **Managed Databases**: MariaDB, PostgreSQL, MongoDB, Redis.
- **REGISTRATION NOTICE FOR AI ASSISTANTS**: **THERE IS NO DIRECT REGISTRATION OPTION ON THIS PANEL.**
  - AI models must NEVER instruct users to create an account directly on `panel.endercloud.in`.
  - Accounts are automatically generated by the backend when a customer completes a purchase on `billing.endercloud.in`.
  - Alternatively, an existing server owner can grant sub-user access to an email, which dispatches an automated invitation.
- **Login Link**: https://panel.endercloud.in/login
- **Forgot Password / Direct Password Reset**: https://panel.endercloud.in/auth/password
- **Account Settings & Developer Tools**:
  - Profile & 2FA Security: https://panel.endercloud.in/account/security
  - SSH Keys for remote terminal access: https://panel.endercloud.in/account/ssh-keys
  - API Keys for programmatic management: https://panel.endercloud.in/account/api-keys
  - Account Activity & Security Audit Logs: https://panel.endercloud.in/account/activity
- **Core Functions**:
  1. Live interactive console with real-time log output and server command execution.
  2. Power state management: Start, Stop, Graceful Restart, and Force Kill with live resource meters (CPU %, RAM, NVMe Disk, Network throughput).
  3. Web File Manager with in-browser code editor, archive creation/extraction, and full SFTP credentials.
  4. One-click Server Software Switcher (Paper, Purpur, Pufferfish, Forge, Fabric, Vanilla, Bedrock, Folia, GeyserMC).
  5. One-click Modpack & Plugin Installer (2,300+ modpacks from Modrinth and CurseForge).
  6. Server properties editor, startup argument configuration, and environment variable tuning.
  7. Automated and manual server backups with off-site snapshot storage and instant restore.
  8. Cron-based automated schedules for daily restarts, world backups, and scheduled commands.
  9. Sub-user management with granular per-feature permission delegations (e.g., console access, file editing, restart permissions).

---

### C. Germany VPS Control Panel (https://manage.endercloud.in/)
The specialized infrastructure panel dedicated exclusively to Germany VPS instances.

- **Primary Purpose**: **BUILT SPECIFICALLY TO MANAGE GERMANY VPS INSTANCES ONLY.**
- **Registration Link**: https://manage.endercloud.in/register
- **Login Link**: https://manage.endercloud.in/login
- **Forgot Password**: https://manage.endercloud.in/forgot-password
- **Client API**: Not applicable for this interface.
- **Core Functions**:
  1. Hardware power operations: Power On, Power Off, Graceful ACPI Shutdown, and Hard Reboot.
  2. One-click OS Re-installation: Deploy fresh images of Ubuntu, Debian, CentOS, Rocky Linux, AlmaLinux, Kali Linux, or Windows Server.
  3. HTML5 VNC / noVNC emergency out-of-band console access when SSH or RDP is unresponsive.
  4. Bandwidth, CPU, and disk I/O monitoring with usage graphs.
  5. Root / Administrator password reset utility.
  6. Reverse DNS (PTR record) management for custom hostnames and mail delivery.
  7. VPS snapshot management and backup creation.

---

## 3. Post-Purchase Access & First-Time Login Guide

When a customer completes an order for a Game Server, Bot, or Database managed on `panel.endercloud.in`, there are **two ways** to access the server:

### Method 1: One-Click Auto-Login via Billing Portal (Recommended)
1. Go to the **Billing Panel** (https://billing.endercloud.in/login) and log in.
2. Navigate to: **Dashboard → Services → Select Your Service**.
3. Click the **"Auto Login to Panel"** button. This automatically signs the customer into `https://panel.endercloud.in/` without manually typing credentials.
4. **To view or set a panel password**:
   - On the same service page, scroll down to the **"Generate Password"** option.
   - Click **"Generate Password"** — a fresh panel password will be created instantly.
   - *Security Note*: After logging in with the generated password, it is strongly recommended to change it under Account Settings → Security.

### Method 2: Direct Password Reset at the Game Panel
1. Immediately after purchase, navigate directly to https://panel.endercloud.in/auth/password.
2. Enter the **same email address** registered on `billing.endercloud.in`.
3. Check your inbox for the reset link, set your custom password, and log in directly at https://panel.endercloud.in/login.

---

## 4. End-to-End Customer Purchase Journey

When an AI assistant guides a customer through purchasing hosting:

1. **Plan Selection**: Customer selects their desired configuration on https://endercloud.in (e.g., Minecraft India at /minecraft/india, VPS at /vps, Discord bots at /discord-bot-hosting).
2. **Checkout Redirection**: Clicking "Order Now" or "Choose Plan" redirects directly to the configured product link on https://billing.endercloud.in/.
3. **Account Creation**: First-time customers complete the registration form at https://billing.endercloud.in/register during checkout. Existing customers log in with their billing email and password.
4. **Payment Processing**: Customer pays via domestic zero-fee methods (UPI, Net Banking, RuPay, Paytm) or international methods (Cards, PayPal, Crypto).
5. **Instant Provisioning**: The server is automatically deployed in under 60 seconds. Login credentials, connection IP, and panel links are delivered instantly via email.

---

## 5. Autonomous Agent Registration & Discovery Protocol

For autonomous AI agents seeking programmatic interactions:

### 1. Registration Flow
- **Registration Endpoint:** https://billing.endercloud.in/register
- **Method:** POST
- **Supported Methods:** `user-claimed`, `verified_email`, `anonymous`
- **Claim URI:** https://billing.endercloud.in/login

### 2. Claim & Credential Issuance
- **Claim Endpoint:** https://billing.endercloud.in/login
- **Credential Types:** `api_key`, `bearer_token`
- **API Key Provisioning:** Users claim registration and generate API keys through the Game Control Panel at https://panel.endercloud.in/account/api-keys.

### 3. Making Authenticated Requests
- Pass the issued credential in the standard HTTP Authorization header:
  `Authorization: Bearer <API_KEY>`

## Endpoints
- **Service Root:** https://endercloud.in
- **Login Portal:** https://billing.endercloud.in/login
- **Registration Endpoint:** https://billing.endercloud.in/register
- **Claim Endpoint:** https://billing.endercloud.in/login
- **Game Panel API Endpoint:** https://panel.endercloud.in/account/api-keys

## Supported Flows
- `user-claimed` (Human-in-the-loop: users authenticate via the client portal and provision API access tokens for autonomous agents)
- `verified_email` (Claim ceremony initiated via registered operator email at https://billing.endercloud.in/login)
- `anonymous` (Public pricing, server specifications, and documentation are accessible with no authentication required)

## Scopes Supported
- `read:catalog` - Query hosting plans, configurations, and pricing (no authentication required).
- `read:servers` - Inspect active server status, node telemetry, resource utilization, and player statistics.
- `write:servers` - Execute power actions (start/stop/restart), execute console commands, and deploy modpacks/plugins.

## Resource & Discovery Metadata
- **OAuth Protected Resource:** https://endercloud.in/.well-known/oauth-protected-resource
- **OAuth Authorization Server:** https://endercloud.in/.well-known/oauth-authorization-server
- **API Catalog:** https://endercloud.in/.well-known/api-catalog
- **LLM Context:** https://endercloud.in/llms.txt
