Automatische Nutzerverwaltung mit benutzerdefinierten SCIM-Profilen einrichten (Beta)

Die automatisierte Nutzerbereitstellung mit benutzerdefinierten SCIM-Profilen ist eine Betafunktion, die nur einer begrenzten Anzahl von Teilnehmern zur Verfügung steht. Wenn Sie die automatische Nutzerverwaltung auf der Detailseite Ihrer App nicht sehen, ist sie für Ihre Organisation noch nicht verfügbar.

Sie können Nutzerkonten in benutzerdefinierten oder vorintegrierten SAML-Apps, die SCIM 2.0 unterstützen, automatisch einrichten und verwalten. Dazu verwenden Sie die automatische Nutzerverwaltung mit benutzerdefinierten SCIM-Profilen.

Hinweis

Für die Einrichtung eines benutzerdefinierten SCIM-Profils benötigen Sie Folgendes:

• Ein Cloud Identity-Konto mit einer Super Admin-Rolle. Ausführliche Informationen finden Sie unter Vordefinierte Administratorrollen.
• Eine benutzerdefinierte oder vorintegrierte SAML-App, die in der Admin-Konsole für Nutzer eingerichtet und aktiviert ist

Ihre App muss einen SCIM-Server haben, der:

• Unterstützt SCIM Version 2.0
• Verwendet standardmäßige HTTP-Methoden, einschließlich POST, GET, PATCH mit Fallback auf PUT und DELETE
• Unterstützt die Inhabertoken-Authentifizierung. Die OAuth-Token-Authentifizierung wird nicht unterstützt.

Automatische Nutzerverwaltung mit einem benutzerdefinierten SCIM-Profil einrichten

1. Öffnen Sie in der Admin-Konsole das Dreistrich-Menü  Apps Web- und mobile Apps.

   Web- und mobile Apps aufrufen

   Für diese Aufgabe müssen Sie als Super Admin angemeldet sein.

2. Klicken Sie auf den Namen Ihrer SAML-App.
3. Klicken Sie unter Auto-Provisioning auf Auto-Provisioning konfigurieren.
4. Geben Sie unter Zugriffstoken das Inhabertoken aus Ihrer App ein und klicken Sie auf Weiter.
5. Geben Sie die SCIM-Endpunkt-URL Ihrer App in das Feld Endpunkt-URL ein und klicken Sie dann auf Weiter. Google stellt eine Verbindung zu Ihrem SCIM-Endpunkt her, um unterstützte Attribute automatisch zu erkennen.
6. Ordnen Sie die Google-Verzeichnisattribute den entsprechenden App-Attributen zu. Wenn Ihre App die Schemaerkennung unterstützt, wird die Tabelle vorab mit erkannten Attributen ausgefüllt. Wenn Sie benutzerdefinierte Attribute manuell zuordnen möchten, klicken Sie auf Zuordnung hinzufügen Weiter, wenn Sie fertig sind.
7. Optional: Wenn Sie keine Gruppen hinzufügen, werden alle Nutzer mit Zugriff auf die SAML-App bereitgestellt. So beschränken Sie die automatische Nutzerverwaltung auf bestimmte Nutzergruppen:
   • Geben Sie unter Nach Gruppen suchen einen oder mehrere Buchstaben des Gruppennamens ein. Wählen Sie dann den Gruppennamen und einen Bereich.
   • Fügen Sie gegebenenfalls weitere Gruppen hinzu.
   • Optional: Klicken Sie zum Entfernen der Gruppe auf Entfernen.
     Wenn eine Gruppe Nutzer aus einer sekundären Domain oder von außerhalb Ihrer Organisation hat, werden diese Nutzer nicht verwaltet.
8. Sie können festlegen, wie lange Nutzer auf die App zugreifen können, nachdem sie für sie deaktiviert oder ihr Google Workspace-Konto gesperrt oder gelöscht wurde. Sie können das Konto sperren, endgültig löschen oder sperren und dann endgültig löschen. Sie können den Verzögerungszeitraum für jede Aktion einzeln festlegen.
   1. Wählen Sie nach Bedarf Optionen für die einzelnen Ereignisse aus:
      • Wenn eine App für einen Nutzer deaktiviert ist
      • Wenn ein Nutzer bei Google gesperrt ist
      • Wenn ein Nutzer aus Google gelöscht wird
        Wenn Sie ein Nutzerkonto sperren, wird es als deaktiviert markiert. Wenn Sie ein Nutzerkonto endgültig löschen, wird es dauerhaft aus der App entfernt. Der Zeitraum bis zum endgültigen Löschen eines Nutzerkontos muss länger sein. Weitere Informationen zur Sperrung und Löschung finden Sie unter Zeitrahmen für die Aufhebung der Bereitstellung bearbeiten.
   2. Klicken Sie auf Weiter.

9. Verbindung testen:

   1. Suchen Sie unter Google Directory-Nutzer nach einem Nutzer, der kein Konto in Ihrer App hat, und wählen Sie ihn aus.

   2. Klicken Sie auf Testen.
      

      Google erstellt ein Konto für den Nutzer in Ihrer App, aktualisiert es und löscht es dann. Für jeden Vorgang wird Erfolgreich, Fehlgeschlagen oder Nicht ausgeführt angezeigt. Prüfen Sie bei einem fehlgeschlagenen Vorgang den HTTP-Code, den SCIM-Fehlertyp und die Details unter Unformatierte Antwort ansehen in Ihrer App.
      

      Hinweis: Wenn Ihre App für den neuen Nutzer nicht 201 Created zurückgibt, z. B. weil der Nutzer bereits vorhanden ist, schlägt Nutzer erstellen fehl und Google überspringt die Aktualisierungs- und Löschvorgänge. Wenn Nutzer löschen fehlschlägt, löschen Sie das Testkonto in Ihrer App manuell.

10. Klicken Sie auf Beenden.
    Sie können auf Fertigstellen klicken, auch wenn der Test fehlgeschlagen ist, und ihn später noch einmal ausführen. In diesem Schritt wird die Konfiguration gespeichert, die automatische Nutzerverwaltung wird jedoch nicht aktiviert. Wenn Sie die Funktion aktivieren möchten, rufen Sie die Detailseite der App auf  Automatische Nutzerverwaltung und stellen Sie den Schalter auf Aktiv.
    Hinweis: Die Einstellung ist deaktiviert, wenn Ihre App für keine Nutzer aktiviert ist. Klicken Sie auf Nutzerzugriff und aktivieren Sie die App, um die automatische Nutzerverwaltung zu aktivieren.

Informationen zur Nutzerverwaltung bearbeiten

Automatische Nutzerverwaltung deaktivieren und Konfigurationsinformationen löschen

Sie können die automatische Nutzerverwaltung für die App deaktivieren, ohne die Konfigurationsinformationen zu verlieren. Sie können die automatische Nutzerverwaltung auch deaktivieren und alle Konfigurationsinformationen entfernen.

Nutzungsdaten prüfen

• Nachdem Sie die automatische Nutzerverwaltung aktiviert haben, können Sie Nutzungsinformationen überprüfen. Weitere Informationen finden Sie im Hilfeartikel Automatische Nutzerverwaltung überprüfen.
• Sie können die folgenden Nutzungsinformationen für die letzten 30 Tage einsehen:

Administratorprotokollereignis	Beschreibung
Nutzer mit automatischer Nutzerverwaltung erstellen	Durch die automatische Nutzerverwaltung erstellte Nutzer
Durch automatische Nutzerverwaltung erstellten Nutzer aktualisieren	Durch die automatische Nutzerverwaltung aktualisierte Nutzer
Durch automatische Nutzerverwaltung erstellten Nutzer sperren	Durch die automatische Nutzerverwaltung gesperrte Nutzer
Sperrung für durch automatische Nutzerverwaltung erstellten Nutzer aufheben	Durch automatische Nutzerverwaltung reaktivierte Nutzer
Automatisch bereitgestellten Nutzer endgültig löschen	Durch die automatische Nutzerverwaltung gelöschte Nutzer
Fehler	Fehlerhafte Anfragen

Wenn die automatische Nutzerverwaltung nicht mehr funktioniert

Die automatische Nutzerverwaltung funktioniert nicht mehr, wenn Google keine Verbindung mehr zu Ihrer App herstellen kann. Das kann beispielsweise passieren, wenn das Inhabertoken abgelaufen ist oder widerrufen wurde oder wenn sich die SCIM-URL der App geändert hat. Aktualisieren Sie das Token oder die URL, um das Problem zu beheben:

1. Öffnen Sie in der Admin-Konsole das Dreistrich-Menü  Apps Web- und mobile Apps.

   Web- und mobile Apps aufrufen

   Für diese Aufgabe müssen Sie als Super Admin angemeldet sein.

2. Klicken Sie auf den Namen Ihrer SAML-App.
3. Klicken Sie auf Automatische Nutzerverwaltung.
4. So aktualisieren Sie das Inhabertoken:
   1. Klicken Sie unter App-Autorisierung auf Noch einmal autorisieren.
   2. Fügen Sie unter Zugriffstoken ein neues Inhabertoken aus Ihrer App ein.
   3. Klicken Sie auf Noch einmal autorisieren.
5. Wenn Sie die SCIM-Basis-URL aktualisieren möchten, klicken Sie unter Endpunkt-URL auf Bearbeiten, geben Sie die neue URL ein und klicken Sie dann auf Aktualisieren.
6. Optional: Klicken Sie unter Verbindung testen auf Testen, um die Verbindung zu prüfen.

Weitere Gründe, warum die automatische Nutzerverwaltung möglicherweise nicht funktioniert, finden Sie in der Dokumentation der App.