Installation

Admin Panel Guide

The Admin Panel is your command center for managing the Cloudflare Auth Service. It provides a comprehensive interface for projects, users, security settings, and monitoring.

1. Dashboard & Projects

The main landing page after login is the Projects overview. Here you can see all your configured authentication projects at a glance.

Project Overview in Light Mode

Project Overview in Dark Mode

Creating a Project

Click the Create Project button to add a new application. You will need to provide:

• Name: A unique name for your project (e.g., "Mobile App").
• Environment: Choose between development, staging, or production.
• Description: Optional details about the project.

Once created, the system automatically generates:

• A unique Project ID (e.g., mobile_app).
• A dedicated User Table (users_mobile_app).
• Default Rate Limit Rules (to protect against abuse).
• A secure JWT Secret for token signing.

2. Project Management

Clicking on a project takes you to its detailed configuration page.

Detailed Project Configuration

Key Settings:

• General: Update project name, description, and status (Enabled/Disabled).
• Authentication:
  • JWT Secret: View or rotate the secret key used to sign user tokens.
  • Token Expiry: Configure access token (short-lived) and refresh token (long-lived) durations.
• OAuth Providers: Configure social login (Google, GitHub, etc.) with Client IDs and Secrets.
• Email Templates: Customize the emails sent to users (Welcome, Password Reset, etc.).
• User Table: View the database table name where user data is stored.

3. User Management

Each project has its own isolated user base. Navigate to the Users tab within a project or use the global Admin Users section to manage platform administrators.

Platform Administrator Management

Features:

• Search & Filter: Find users by email or name.
• Create/Edit: Add new users manually or update existing profiles.
• Password Reset: Trigger password reset emails or manually set a temporary password.
• Status Control: Suspend or delete users instantly.

4. Security & Audit Logs

The Audit Logs section provides a complete history of all actions taken within the system. This is crucial for security compliance and troubleshooting.

Comprehensive System Audit Trail

Logged Events Include:

• User Logins: Successful and failed attempts.
• Admin Actions: Project creation, updates, and deletions.
• Security Events: Rate limit triggers, password changes.
• System Errors: Configuration failures or API issues.

You can filter logs by Project, Event Type, Status, or User ID.

5. System Settings

The Settings page allows you to configure global parameters for the auth service.

Global System Configuration

Configurable Options:

• Email Provider: Set up your transactional email service (SendGrid, Mailgun, etc.).
• Rate Limiting Defaults: Define the default protection rules for new projects.
• Admin Session: Configure session timeouts and security policies.
• Theme: Toggle between System, Light, and Dark modes for the Admin UI.

6. API Documentation

The Admin Panel includes a built-in API Explorer (powered by Swagger UI) to help you integrate your applications.

Interactive API Explorer

Here you can:

• Test Endpoints: Try out authentication flows directly from the browser.
• View Schemas: See request/response models for all API routes.
• Get Examples: Copy code snippets for your frontend integration.