Authentifizierungssystem

Allgemein

Für einen schnellen Überblick, siehe das hier bereitgestellte Benutzerhandbuch: Authentication

Hier ist ein Überblick über die allgemeine Konfiguration.

Hinweis: OpenID und SAML unterstützen nicht die Möglichkeit, nur die Registrierung zu deaktivieren.

Kurztipps:

• Selbst wenn die Registrierung deaktiviert ist, können Sie Benutzer direkt zur Datenbank hinzufügen, indem Sie das unten beschriebene create-user script verwenden.
• Um einen Benutzer zu löschen, können Sie das delete-user Skript verwenden, das ebenfalls unten aufgeführt ist.

Sitzungsablauf und Refresh Token

• Standardwerte: Sitzungsablauf: 15 Minuten, Ablauf des Refresh-Tokens: 7 Tage
  • Für weitere Informationen: GitHub PR #927 - Refresh Token

sequenceDiagram
    Client->>Server: Login request with credentials
    Server->>Passport: Use authentication strategy (e.g., 'local', 'google', etc.)
    Passport-->>Server: User object or false/error
    Note over Server: If valid user...
    Server->>Server: Generate access and refresh tokens
    Server->>Database: Store hashed refresh token
    Server-->>Client: Access token and refresh token
    Client->>Client: Store access token in HTTP Header and refresh token in HttpOnly cookie
    Client->>Server: Request with access token from HTTP Header
    Server-->>Client: Requested data
    Note over Client,Server: Access token expires
    Client->>Server: Request with expired access token
    Server-->>Client: Unauthorized
    Client->>Server: Request with refresh token from HttpOnly cookie
    Server->>Database: Retrieve hashed refresh token
    Server->>Server: Compare hash of provided refresh token with stored hash
    Note over Server: If hashes match...
    Server-->>Client: New access token and refresh token
    Client->>Server: Retry request with new access token
    Server-->>Client: Requested data

JWT Secret und Refresh Secret

• Sie sollten neue sichere Werte verwenden. Die angegebenen Beispiele sind 32-Byte-Schlüssel (64 Zeichen in Hexadezimal).
  • Verwenden Sie dieses Tool, um schnell welche zu generieren: JWT Keys

Automatisiertes Moderationssystem (optional)

Das Automated Moderation System ist standardmäßig aktiviert. Es verwendet einen Bewertungsmechanismus, um Benutzerverstöße zu verfolgen. Wenn Benutzer Aktionen wie übermäßige Anmeldungen, Registrierungen oder Nachrichtenversand durchführen, sammeln sie Verstößepunkte an. Beim Erreichen eines festgelegten Schwellenwerts werden der Benutzer und seine IP-Adresse vorübergehend gesperrt. Dieses System gewährleistet die Plattformsicherheit, indem es schnelle oder verdächtige Aktivitäten überwacht und sanktioniert.

Um das Mod-System einzurichten, lesen Sie die Einrichtungsanleitung.

Bitte beachten: Wenn Sie möchten, dass dies im Entwicklungsmodus funktioniert, müssen Sie eine Datei namens .env.development im Stammverzeichnis erstellen und DOMAIN_CLIENT auf http://localhost:3090 oder den Port setzen, der von vite beim Ausführen von npm run frontend-dev bereitgestellt wird.

Benutzerverwaltungsskripte

Benutzerskript erstellen

Das create-user Skript ermöglicht es Ihnen, Benutzer direkt zur Datenbank hinzuzufügen, selbst wenn die Registrierung deaktiviert ist. So verwenden Sie es:

1. Für die standardmäßige docker-compose.yml (falls Sie docker compose up verwenden, um die App zu starten):

   docker compose exec api npm run create-user

2. Für die deploy-compose.yml (falls Sie dem Ubuntu Docker Guide gefolgt sind):

   docker exec -it LibreChat-API /bin/sh -c "cd .. && npm run create-user"

3. Für die lokale Entwicklung (vom Projektstammverzeichnis aus):

   npm run create-user

Befolgen Sie die Anweisungen, um die E-Mail-Adresse und das Passwort des neuen Benutzers einzugeben.

Benutzer-Skript löschen

Um einen Benutzer zu löschen, können Sie das delete-user Skript verwenden:

1. Für die standardmäßige docker-compose.yml (falls Sie docker compose up verwenden, um die App zu starten):

   docker compose exec api npm run delete-user [email protected]

2. Für die deploy-compose.yml (falls Sie dem Ubuntu Docker Guide gefolgt sind):

   docker exec -it LibreChat-API /bin/sh -c "cd .. && npm run delete-user [email protected]"

3. Für die lokale Entwicklung (vom Projektstammverzeichnis aus):

   npm run delete-user [email protected]

Ersetzen Sie [email protected] durch die E-Mail-Adresse des Benutzers, den Sie löschen möchten.