README

A Silverstripe CMS module that allows you to manage and log into multiple Silverstripe sites from a central location using secure JWT-based authentication.

Overview

Silverstripe Gate Manager provides a centralized dashboard for managing multiple Silverstripe installations. It generates RSA key pairs for each managed site and creates secure JWT tokens that enable seamless, passwordless login to any of your registered sites.

To log into another Silverstripe site, you should install and configure the Silverstripe Gate Client module on it.

Installation

Install via Composer:

composer require atwx/silverstripe-gate-manager

After installation, run:

vendor/bin/sake dev/build flush=all

Configuration

Manager Site (This Module)

No additional configuration required. The module automatically:

• Generates RSA key pairs for each managed site
• Creates JWT tokens with configurable expiration
• Provides secure login URLs

Optional Configuration

You can customize cryptography settings:

Atwx\SilverGateManager\Services\CryptographyService:
  # JWT configuration
  jwt_algorithm: 'RS256'      # Supported: RS256, RS384, RS512
  jwt_expiration_seconds: 60  # Token validity period

Client Sites

On each site you want to manage, install the SilverGate Client module:

composer require atwx/silverstripe-gate-client

Then configure it with the public key from the manager:

1. In the SilverGate Manager admin, navigate to "SilverGate Manager"
2. Create or edit a managed site
3. Go to the "Help" tab
4. Copy the provided YAML configuration
5. Add it to your client site's app/_config/config.yml

Example client configuration:

Atwx\SilverGateClient\Services\TokenService:
  public_key: |
    -----BEGIN PUBLIC KEY-----
    MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...
    -----END PUBLIC KEY-----

Usage

Adding a Managed Site

1. Log into your Silverstripe admin
2. Navigate to "SilverGate Manager" in the admin menu
3. Click "Add Managed Site"
4. Enter the domain name (e.g., example.com)
5. Save - a key pair is automatically generated
6. Copy the configuration from the "Help" tab to your client site

Logging Into a Managed Site

From the Admin Interface:

1. Navigate to "SilverGate Manager"
2. Find the site you want to access
3. Click the "Login" button next to the site

From the Edit Form:

1. Open the managed site record
2. Click the "Login" button in the actions area

The system will redirect you to the client site with a secure JWT token, automatically logging you in.

Regenerating Key Pairs

If a key pair is compromised or needs to be rotated:

1. Open the managed site record
2. Click "Regenerate Key Pair" in the actions area
3. Confirm the action
4. Update the public key configuration on the client site

⚠️ Warning: Regenerating a key pair will invalidate the previous keys. Update the client site configuration immediately.

Permissions

The module provides three permission levels:

Assign permissions in Security > Groups to control user access.