Mit der GUI

Sie können SSO über die GUI konfigurieren.

1. Navigieren Sie zur Registerkarte Cloud Directory > Single Sign-on des App ID-Dashboards.

2. Legen Sie für Single Sign-on aktivieren die Einstellung Aktiviert fest.

3. Legen Sie die Zeitdauer fest, für die ein Benutzer inaktiv sein kann, bevor die SSO-Sitzung abläuft. Läuft die Sitzung ab, dann muss sich der Benutzer erneut anmelden. Die Zeitdauer wird in Minuten angegeben und das zulässige Maximum für Inaktivität beträgt 10.080 Minuten (7 Tage). Die Standarddauer beträgt 1440 Minuten (1 Tag).

4. Fügen Sie die Weiterleitungs-URIs im Feld Weiterleitungs-URI für Abmeldung hinzu und klicken Sie dann auf das Pluszeichen (+). Beachten Sie hierbei unbedingt, dass nur Anwendungen registriert werden sollten, die Sie als vertrauenswürdig einstufen. Wenn Sie den URI registrieren, autorisieren Sie App ID, ihn in den Autorisierungsworkflow einzubinden.

5. Klicken Sie auf Speichern.

Mit der API

Sie können über die Administrator-API für die SSO-Konfiguration drei Einstellungen definieren, um das Feature zu aktivieren.

Beispielaufruf:

{
  "isActive": true,
  "inactivityTimeoutSeconds": 86400,
  "logoutRedirectUris": [
    "http://my-first-app.com/after_logout",
    "http://my-second-app.com/after_logout"
  ]
}

Mit der API

Um einen Benutzer abzumelden, muss der Browser mithilfe der verfügbaren Informationen weitergeleitet werden, um den folgenden API-Aufruf auszuführen.

https://<region>.appid.cloud.ibm.com/oauth/v4/<tenantID>/cloud_directory/sso/logout?redirect_uri=<redirectURI>&client_id=<clientID>

Auch wenn die SSO-Sitzung beendet wird, muss ein Benutzer mit einem gültigen Zugriffstoken, das in der Sitzung des Benutzers gespeichert ist, seine Berechtigungsnachweise möglicherweise erst dann erneut eingeben, wenn die Gültigkeit des Tokens abläuft. Standardmäßig läuft die Gültigkeit des Tokens nach einer Stunde ab.

Mit dem SDK des Node.JS-Servers

Sie können auch das SDK des App ID-Node.js-Servers verwenden, um die Weiterleitung automatisch durchzuführen.

1. Legen Sie logoutSSO als Methode fest. Zum Beispiel:

   let webAppStrategy = new WebAppStrategy(.....);
   ....
   webAppStrategy.logoutSSO();
   

2. Konfigurieren Sie die Abmeldung.

   app.get('/logoutSSO', (req, res) => {
      res.clearCookie("refreshToken");
      webAppStrategy.logoutSSO(req,res, { "redirect_uri": "https://my-app.com/after_logout" });
      });