Dokumentation/Entwickler
Zurück
  • Erste Schritte
    • Frontends und App-Typen
    • Umgebungen und Endpunkte
  • OAuth-Clients
    • Client-ID und Client-Secret
    • Redirect-URIs und Start-URL
    • Secret erneuern
  • Login with appsolut
    • Authorization-Code-Flow
    • Tokens und Claims
    • Frontend-Rolle
    • Abmeldung
    • Widerruf und ausgestellte Tokens
    • Fehler des Token-Endpunkts
  • Frontend-Schlüssel
    • Einen Schlüssel ausstellen und aufbewahren
    • Einen Schlüssel senden
    • Wechseln und widerrufen
  • Mitglieder-API
    • Berechtigung aus einem Backend
    • Das angemeldete Mitglied
    • Ergebnisse, Ratenlimits und Fehler
    • Ist ein Antragsteller ein berechtigtes Mitglied?
    • Die Mitgliedschaft des angemeldeten Frontend-Benutzers
  • appsolut Register-API
    • Die API umsetzen
    • Anbinden und testen
    • Ein Mitglied mit seinem Prüfcode verifizieren
    • Alle Mitglieder auflisten
    • Der Status mehrerer Mitglieder
    • Der Status eines Mitglieds
    • Die Personendaten mehrerer Mitglieder
    • Die Personendaten eines Mitglieds
    • Die Claims mehrerer Mitglieder
    • Die Claims eines Mitglieds
    • Health-Check

Einen Schlüssel ausstellen und aufbewahren

Einen Frontend-Schlüssel im Studio ausstellen und auf Ihrem Server aufbewahren.

Studio-Rollen: „Eigentümer“, „Administrator“, „Frontend-Manager“.

Einen Schlüssel ausstellen

  1. Öffnen Sie im Studio „Frontends“ und das Frontend.
  2. Klicken Sie auf der Karte „Schlüssel“ auf „Schlüssel ausstellen“.
  3. Der Dialog „Ihr neuer Schlüssel“ zeigt den „Frontend-Schlüssel“. Kopieren Sie ihn mit „Kopieren“ und hinterlegen Sie ihn im Backend des Frontends.
  4. Schließen Sie den Dialog mit „Ich habe den Schlüssel gespeichert“.

Der Schlüssel wird nur einmal angezeigt. Sobald der Dialog geschlossen ist, kann er nicht mehr angezeigt werden: Das Studio speichert nur seine ersten Zeichen. Wenn Sie ihn verlieren, stellen Sie einen neuen Schlüssel aus und widerrufen Sie den verlorenen.

Ein Frontend hat höchstens zwei aktive Schlüssel. Bei zweien zeigt das Studio „Dieses Frontend hat zwei aktive Schlüssel“, und Sie widerrufen einen, bevor Sie einen weiteren ausstellen.

Meldet sich der Studio-Benutzer mit Multi-Faktor-Authentifizierung an, braucht das Ausstellen und Widerrufen von Schlüsseln eine Sitzung, die mit seinem zweiten Faktor bestätigt ist.

Was die Karte zeigt

Für jeden Schlüssel zeigt die Karte „Schlüssel“ sein Präfix („Schlüssel“), wer ihn erstellt hat („Erstellt von“), wann („Erstellt“), wann er „Zuletzt verwendet“ wurde (höchstens einmal pro Minute festgehalten; „Nie“ für einen noch nicht verwendeten Schlüssel) und seinen „Status“. Prüfen Sie an „Zuletzt verwendet“, ob ein alter Schlüssel noch in Gebrauch ist, bevor Sie ihn widerrufen.

Aufbewahren

  • Bewahren Sie den Schlüssel im Secret-Speicher oder in der Umgebung Ihres Backends auf, wie ein Datenbankpasswort. Er gehört zu einem Frontend und einer Umgebung: Das Frontend einer Testumgebung hat seinen eigenen Schlüssel.
  • Legen Sie ihn nie in einen Browser, eine Single-Page-App oder das Paket einer mobilen App. Wer ihn lesen kann, kann die Mitglieder-API als Ihr Frontend aufrufen. Die Mitglieder-API beantwortet kein CORS, ein Browser könnte ihn also ohnehin nicht verwenden.
  • Protokollieren Sie ihn nie. Protokollieren Sie das Präfix, wenn Sie Schlüssel unterscheiden müssen.