Authentication Manager
Der Authentication Manager (AM) von RaidProtect ist ein fortschrittliches Authentifizierungssystem, das den Zugang zu bestimmten Discord-Rollen durch eine Identitätsverifizierung schützt. Dank Passkeys (WebAuthn), PIN-Codes und OTP können nur authentifizierte Mitglieder sensible Rollen erhalten.
❓ Allgemeine Funktionsweise
Der Authentication Manager basiert auf einem System aus geschützten Rollen und temporären Sitzungen. Wenn ein Administrator eine Rolle mit dem AM konfiguriert:
- Die Discord-Rolle wird durch eine obligatorische Authentifizierung geschützt.
- Autorisierte Mitglieder müssen sich über den Befehl
/authauthentifizieren, um die Rolle zu erhalten. - Eine temporäre Sitzung wird mit einer festgelegten Dauer erstellt (konfigurierbar).
- Nach Ablauf der Sitzung wird die Rolle automatisch entzogen.
Der Authentication Manager erfordert, dass jedes Mitglied vor dem Authentifizieren ein Authentifizierungsprofil über /auth-profile erstellt.
🔐 Sicherheitsgrade
Jede Authentifizierungsmethode ist mit einem Sicherheitsgrad verknüpft. Geschützte Rollen erfordern einen Mindestgrad, den das Mitglied erreichen muss.
| Grad | Bedingung |
|---|---|
 | Mindestens ein registrierter Passkey |
 | OTP (2FA)-Code aktiviert |
 | Verstärkter PIN mit 8 Ziffern oder mehr |
 | Verstärkter PIN mit 6 Ziffern oder mehr |
 | Einfacher PIN mit 6 Ziffern oder mehr |
 | Einfacher PIN mit 4 Ziffern oder mehr |
Der höchste Grad unter Ihren konfigurierten Methoden wird automatisch übernommen. Wenn Sie beispielsweise einen einfachen PIN (Grad D) und einen Passkey (Grad S) haben, ist Ihr Grad S.
🛡️ Authentifizierungsmethoden
- PIN
- OTP (2FA-Code)
- Passkey (WebAuthn)
Der PIN-Code ist die einfachste Methode. Zwei Modi sind verfügbar:
- Einfacher PIN: Klassische Eingabe über ein Formular (4 bis 12 Ziffern).
- Verstärkter PIN: Numerische Tastatur mit zufälliger Tastenanordnung (6 bis 12 Ziffern), die das Ausspähen durch Dritte verhindert.
Schwache PINs werden automatisch abgelehnt: wiederholte identische Ziffern, auf- oder absteigende Sequenzen sowie gängige Muster.
Das OTP verwendet den TOTP-Standard (Time-based One-Time Password), der mit Authentifizierungs-Apps wie Google Authenticator, Authy, 1Password, Dashlane oder Bitwarden kompatibel ist.
- 6-stelliger Code, der alle 30 Sekunden erneuert wird.
- Toleranz eines Fensters von ±1, um Zeitabweichungen auszugleichen.
Passkeys bieten das höchste Sicherheitsniveau (Grad S). Die Authentifizierung erfolgt über den Browser mithilfe von:
- Fingerabdruck oder Gesichtserkennung (Touch ID, Face ID, Windows Hello).
- Physischem Sicherheitsschlüssel (YubiKey usw.).
Wenn Sie einen Passkey verwenden, öffnet sich ein externer Link in Ihrem Browser, um die Verifizierung durchzuführen. Nach der Bestätigung wird der Bot in Echtzeit benachrichtigt und weist Ihnen die Rolle zu.
👤 Authentifizierungsprofil (/auth-profile)
Der Befehl /auth-profile ermöglicht es Ihnen, Ihr persönliches Authentifizierungsprofil zu verwalten. Er ist auf jedem Server oder per Direktnachricht zugänglich.
Erste Nutzung
Bei der ersten Nutzung erklärt Ihnen ein Willkommensbildschirm die Funktionsweise des Systems. Klicken Sie auf Weiter, um Ihre erste Authentifizierungsmethode zu konfigurieren.
Authentifizierungen verwalten
Über Ihr Profil können Sie Ihre Authentifizierungsmethoden verwalten.
- Einen PIN (einfach oder verstärkt) hinzufügen, ändern oder löschen.
- Das OTP (2FA) per QR-Code aktivieren, das Secret neu generieren oder die Methode deaktivieren.
- Einen Passkey über die Registrierungsseite hinzufügen oder löschen.
Jeder Passkey zeigt seinen Gerätenamen und das Datum der letzten Nutzung an.
Aktive Sitzungen
Sehen Sie sich Ihre aktiven Sitzungen über Ihr Profil an. Im Kontext einer Direktnachricht sind die Sitzungen aller Ihrer Server sichtbar.
Prüfprotokoll
Sehen Sie sich die letzten 3 auf Ihrem Konto durchgeführten Aktionen an, mit Zugang zum vollständigen paginierten Protokoll.
Konto zurücksetzen
Die Schaltfläche Ich habe meine Anmeldedaten vergessen ermöglicht es, Ihr Konto vollständig zurückzusetzen. Diese Aktion:
- Löscht alle Ihre Authentifizierungsmethoden.
- Deaktiviert alle Ihre Zugänge zu geschützten Rollen.
- Erfordert eine vollständige Neukonfiguration.
Diese Aktion ist unwiderruflich. Alle Ihre Zugänge werden sofort widerrufen.
🔑 Sich authentifizieren (/auth)
Der Befehl /auth ermöglicht es Ihnen, sich zu authentifizieren, um eine geschützte Rolle zu erhalten.
Authentifizierungsablauf
- Führen Sie
/authauf dem Server aus. - Ein Dropdown-Menü zeigt die verfügbaren Rollen mit ihrem erforderlichen Grad und der Sitzungsdauer an.
- Wählen Sie eine Rolle aus.
- Wählen Sie Ihre Authentifizierungsmethode aus denjenigen, die den Mindestgrad der Rolle erfüllen.
- Führen Sie die Verifizierung durch (PIN, OTP oder Passkey).
- Bei Erfolg wird Ihnen die Discord-Rolle zugewiesen und eine Sitzung erstellt.
Nur die Rollen, denen Sie zugewiesen wurden (Status Aktiv), erscheinen im Menü.
Sitzungsverwaltung
Über das /auth-Panel können Sie:
- Eine Sitzung verlängern: Authentifizieren Sie sich erneut, um die Dauer der aktiven Sitzung zu verlängern.
- Sich abmelden: Widerruft die Sitzung sofort und entzieht die Discord-Rolle.
Sicherheit
- Begrenzte Versuche: Nach 5 Fehlversuchen wird Ihr Konto für 1 Stunde gesperrt. Nach 10 Fehlversuchen wird das Konto zurückgesetzt.
- Warnung: Ab 3 fehlgeschlagenen Versuchen erscheint eine Warnmeldung.
⚙️ Serverkonfiguration (/auth-settings)
Der Befehl /auth-settings ist Administratoren und autorisierten Managern vorbehalten. Er ermöglicht die Konfiguration des gesamten Authentifizierungssystems auf dem Server.
Berechtigungen
| Rolle | Zugang |
|---|---|
| Eigentümer | Vollständiger Zugang |
| Administrator | Vollständiger Zugang (außer wenn die Berechtigung ADMINISTRATOR von einer AM-Rolle stammt) |
| Manager | Eingeschränkter Zugang, muss sich authentifizieren, kann nur untergeordnete Rollen verwalten |
Manager müssen einen (konfigurierbaren) Mindestsicherheitsgrad erreichen, um auf die Einstellungen zuzugreifen.
Servereinstellungen
- Standard-Sitzungsdauer: Dauer der Sitzungen für neue Rollen (bis zu 8 Stunden in der kostenlosen Version, 24 Stunden in der Premium-Version).
- Standard-Mindestgrad: Auf neue Rollen angewendeter Mindestsicherheitsgrad.
- Mindestgrad der Manager: Erforderlicher Grad, damit ein Mitglied Manager werden kann.
- Webhook-URL: Discord-Webhook zum Empfangen der Prüfprotokolle (optional).
Rollen-Tab
Eine Rolle hinzufügen
- Öffnen Sie
/auth-settingsund gehen Sie zum Tab Rollen. - Klicken Sie auf Rolle hinzufügen.
- Wählen Sie die zu schützende Discord-Rolle aus.
- Legen Sie den erforderlichen Mindestgrad fest.
- Legen Sie die Sitzungsdauer fest.
Limits: 3 Rollen in der kostenlosen Version, 10 Rollen in der Premium-Version.
Wenn Ihre Rolle so konfiguriert ist, dass sie separat in der Mitgliederliste angezeigt wird, sollten Sie daran denken, die ursprüngliche Rolle (indem Sie ihr die sensiblen Berechtigungen entziehen) für die Anzeige zu behalten und eine neue Rolle mit den tatsächlichen Berechtigungen zu erstellen, die Sie über den AM schützen. So behalten Ihre Mitglieder ihre Rolle dauerhaft sichtbar, während die sensiblen Berechtigungen nur während authentifizierter Sitzungen zugewiesen werden.
Eine Rolle bearbeiten
Sie können den Mindestgrad und die Sitzungsdauer einer bestehenden Rolle ändern.
Eine Rolle aktivieren / deaktivieren
Eine Rolle kann pausiert werden, ohne sie zu löschen. Inaktive Rollen belegen weiterhin einen Platz.
Eine Rolle löschen
Entfernt die Rolle dauerhaft aus dem Authentifizierungssystem.
Benutzer-Tab
Einen Benutzer hinzufügen
- Gehen Sie zum Tab Benutzer.
- Klicken Sie auf Benutzer hinzufügen.
- Wählen Sie das Mitglied und die ihm zuzuweisenden Rollen aus.
- Das Mitglied erhält eine Direktnachricht, die es über die Einladung informiert.
Limits: 20 Benutzer in der kostenlosen Version, 50 in der Premium-Version.
Mitglieder-Status
| Status | Beschreibung |
|---|---|
| Eingeladen | Das Mitglied wurde hinzugefügt, hat sein Profil aber noch nicht konfiguriert |
| Ausstehend | Das Profil ist konfiguriert und wartet auf Genehmigung |
| Aktiv | Das Mitglied kann sich authentifizieren, um die Rolle zu erhalten |
| Deaktiviert | Der Zugang zur Rolle ist vorübergehend ausgesetzt |
Zum Manager befördern
Ein Manager kann Benutzer und Rollen verwalten, die sich unterhalb seiner Berechtigungsgrenze befinden. Die Grenze entspricht der höchsten Position zwischen der Discord-Rolle und der aktiven AM-Rolle des Managers.
Einen Benutzer löschen
Entfernt das Mitglied von allen geschützten Rollen auf dem Server.
Protokoll-Tab
Sehen Sie sich das Prüfprotokoll des Servers mit Paginierung an. Jeder Eintrag enthält: den Benutzer, die Aktion, den Typ (AM oder Discord) und das Datum.
Sitzungs-Tab
Sehen Sie sich alle Sitzungen des Servers mit ihrem Status (Aktiv, Abgelaufen, Widerrufen), dem Benutzer, der Rolle sowie den Erstellungs- und Ablaufdaten an.