Zum Inhalt springen

Zugangsdaten verwalten

Selu speichert Zugangsdaten — API-Schlüssel, Tokens und andere Geheimnisse, die deine Agenten benötigen — in einem verschlüsselten Speicher. Du verwaltest sie an zwei Stellen, je nachdem wofür sie gedacht sind.

Geheimnisse, die Agenten für externe Services benötigen (z. B. ein Wetter-API-Schlüssel oder ein Such-Service-Token), werden im Geheimnisse-Tab jedes Agenten verwaltet.

  1. Gehe zu Agenten in der Seitenleiste
  2. Klicke auf den Agentennamen, um die Detailseite zu öffnen
  3. Wähle den Geheimnisse-Tab
  4. Finde das gewünschte Credential — jedes zeigt eine Beschreibung, wofür es ist und wo man es bekommt
  5. Gib den Wert ein und klicke Speichern

Jedes Geheimnis zeigt, ob es aktuell gesetzt oder fehlend ist, und wann es zuletzt aktualisiert wurde.

  • Geteilt (System) — Ein Wert für alle Nutzer. Nur Admins können diese setzen. Gut für organisationsweite API-Schlüssel.
  • Persönlich (Nutzer) — Jede Person gibt ihren eigenen Wert an. Gut für persönliche Konten oder Services, bei denen jeder einen eigenen Zugang hat.

Auf der Einstellungsseite kannst du die Selu-App auf deinem Handy mit deinem Konto verknüpfen — mit einem kurzlebigen Einmalcode.

  1. Öffne Einstellungen in der Seitenleiste.
  2. Suche die Karte Mobile App und klicke auf Handy verbinden.
  3. Klicke auf Verbindungscode erstellen.
  4. Ein QR-Code erscheint — scanne ihn mit der Kamera deines Handys in der Selu-App. Ein einmaliger Code und deine Selu-Adresse werden auch als Text angezeigt, falls das Scannen nicht klappt.
  5. Der Code läuft nach fünf Minuten ab. Wenn er abläuft, klicke auf Neuen Code erstellen.

Ein neuer Code macht automatisch jeden vorherigen noch nicht genutzten Verbindungsversuch ungültig.

Jeder angemeldete Nutzer kann sein Passwort direkt in der App ändern:

  1. Öffne die Einstellungen-Seite (erreichbar über die Seitenleiste oder das Navigationsmenü)
  2. Suche den Abschnitt Sicherheit und klicke Passwort ändern
  3. Gib dein aktuelles Passwort ein
  4. Gib das neue Passwort ein und bestätige es
  5. Klicke Speichern

Nach einer erfolgreichen Passwortänderung meldet Selu deine anderen aktiven Sessions automatisch ab. Deine aktuelle Session bleibt aktiv.

Wenn ein Nutzer sein Passwort vergessen hat und sich nicht anmelden kann, kann ein Administrator es über das Kommandozeilen-Tool des Orchestrators zurücksetzen. Dafür ist Zugriff auf den Server erforderlich, auf dem Selu läuft.

Terminal-Fenster
echo 'neues-passwort-hier' | selu-orchestrator reset-password --username alice --password-stdin

Der Befehl:

  1. Liest das neue Passwort von der Standardeingabe
  2. Hasht es sicher mit Argon2id
  3. Aktualisiert das gespeicherte Passwort des Nutzers
  4. Widerruft alle aktiven Web-Sessions dieses Nutzers

Der Nutzer kann sich dann mit dem neuen Passwort anmelden.

Alle Geheimnisse — API-Schlüssel, Tokens, Passwörter — werden mit AES-256-GCM verschlüsselt, bevor sie in die Datenbank geschrieben werden. Der Verschlüsselungsschlüssel wird über die Umgebungsvariable SELU_SECRET_KEY beim Einrichten von Selu gesetzt.