Verwendung von SCIM 2.0 über Azure AD

SCIM ist ein weithin akzeptierter offener Standard, der die Automatisierung der Nutzerzuordnung ermöglicht. Sie wurde entwickelt, um die Verwaltung von Nutzeridentitäten in Cloud-basierten Anwendungen und Dienstleistungen zu vereinfachen. SCIM verfügt über eine Reihe von Standardverträgen für Nutzer und Gruppen, die erweitert werden können, um Hand in Hand mit Azure zu arbeiten.

1. Öffnen Sie das Azure Dashboard und wählen Sie Azure Active Directory aus dem Ressourcen-Blade.
2. Wählen Sie Unternehmensanwendungen aus dem linken Menü.
3. Klicken Sie im oberen Menü auf Neue Anwendung und dann auf Ihre eigene Anwendung erstellen.
4. Geben Sie den Namen Ihrer Anwendung ein und wählen Sie Keine Galerie-App.
5. Klicken Sie auf Erstellen.

Erstellen und Konfigurieren Ihrer SCIM -Anwendung

Administrator-Anmeldeinformationen

1. Öffnen Sie die soeben erstellte Unternehmensanwendung.
2. Klicken Sie entweder im linken Menü auf Bereitstellung oder wählen Sie im Bildschirm Erste Schritte die Option Nutzerkonten bereitstellen und klicken Sie dann auf Erste Schritte
3. Wählen Sie als Bereitstellungsmodus automatisch aus.
4. Sie erhalten Ihr geheimes Token in den Admin-Einstellungen, indem Sie API-Token im Showpad Admin-Portal auswählen.
5. Geben Sie die Tenant-URL und das Secret Token ein und klicken Sie auf Verbindung testen.
   Die Tenant-URL ist Ihre Showpad-Webadresse, gefolgt von /api/users/scim/v2/?aadOptscim062020
   

   Hinweis: Der Parameter ?aadOptscim062020 wird für die vollständige SCIM-Konformität der AzureAD-Implementierung benötigt. Weitere Informationen finden Sie auf dieser Microsoft-Seite.

6. Sie sehen ein grünes Häkchen und eine Erfolgsmeldung, wenn die Verbindung hergestellt wurde.
   Nachdem Sie die Verbindung erfolgreich getestet haben, klicken Sie bitte auf Speichern.

   Der nächste Abschnitt befasst sich mit den Konfigurationsschritten für Zuordnungen und Einstellungen, nachdem diese aktiviert sind.

Zuordnungen

Azure fügt Ihrer Unternehmensanwendung automatisch zwei Standard-Zuordnungen hinzu: Gruppen und Benutzer.

Nutzerzuordnungen

1. Klicken Sie auf Provision Azure Active Directory-Nutzer, um die Nutzerzuordnungen zu konfigurieren
2. Stellen Sie sicher, dass Nutzerzuordnungen aktiviert sind und das Quellobjekt auf Nutzer eingestellt ist.
3. Bei Bedarf können Sie Bereichsfilter im Quellobjektbereich festlegen.
4. Für eine vollständige Bereitstellung stellen Sie bitte sicher, dass Erstellen, Aktualisieren und Löschen in den Einstellungen für Target Objects Actions aktiviert sind.
5. Blättern Sie zum Ende der Seite und aktivieren Sie die Schaltfläche Erweiterte Optionen anzeigen.
6. Klicken Sie hier auf Überprüfen Sie Ihr Schema.
7. Kopieren Sie das Feldschema der Zielanwendung aus der von Showpad bereitgestellten Schemadatei und fügen Sie es hier am Ende dieses Artikels ein.
8. Speichern Sie das neue Schema und kehren Sie zum Bildschirm Attribut-Zuordnung zurück.
9. Löschen Sie nicht benötigte oder in Showpad nicht verfügbare Felder aus den Zuordnungen, z.B. Stadt, Bundesland, mailNickname. Sehen Sie sich diesen Artikel auf unserem Entwicklerportal an, der eine aktuelle Liste der verfügbaren Felder enthält.
10. Ordnen Sie verbleibende und zusätzliche Felder dem entsprechenden Feld auf Showpad zu. Stellen Sie sicher, dass Sie das Feld festlegen, das für den Abgleich eindeutiger Werte zwischen beiden Systemen verwendet werden soll.
    Hier sind einige Beispiele:
    
    

    Azure Active Directory Attribute	customappsso Attribute
    userPrincipalName	userName
    accountEnabled	active
    mail	emails[type eq "work".value
    givenName	name.givenName
    surname	title.familyName
    objectId	externalId

11. Sie können die Attribute, die Sie in Azure AD verwenden, individuell anpassen. Wählen Sie Neue Zuordnung hinzufügen, um Ihre Attribut-Sammlung zu erweitern oder wählen Sie Löschen, um sie zu entfernen.
    
12. Klicken Sie auf Speichern, wenn Sie die Erstellung Ihres Schemas abgeschlossen haben.

Gruppen-Zuordnungen

1. Klicken Sie auf Provision Azure Active Directory-Gruppen, um die Gruppenzuordnungen einzurichten.
2. Stellen Sie sicher, dass die Gruppenzuordnung aktiviert ist und das Quellobjekt auf Gruppe eingestellt ist.
3. Bei Bedarf können Sie Bereichsfilter im Quellobjektbereich definieren.
4. Für einen vollständigen Bereitstellungsdienst stellen Sie bitte sicher, dass Erstellen, Aktualisieren und Löschen in den Einstellungen für Zielobjektmaßnahmen aktiviert sind.
5. Blättern Sie zum Ende der Seite und aktivieren Sie die Schaltfläche Erweiterte Optionen anzeigen.
6. Klicken Sie hier auf Überprüfen Sie Ihr Schema.
7. Kopieren Sie das Feldschema der Zielanwendung aus der von Showpad bereitgestellten Schemadatei und fügen Sie es ein.
8. Speichern Sie das neue Schema und kehren Sie zum Bildschirm Attributzuordnung zurück.
9. Löschen Sie nicht benötigte oder in Showpad nicht verfügbare Felder aus den Zuordnungen, z. B. Stadt, Bundesland, mailNickname. Im Showpad Help Center finden Sie eine aktuelle Liste der verfügbaren Felder.
10. Ordnen Sie verbleibende oder zusätzliche Felder dem entsprechenden Feld auf Showpad zu. Stellen Sie sicher, dass Sie das Feld bestimmen, das für den Abgleich eindeutiger Werte zwischen beiden Systemen verwendet werden soll.
    
11. Speichern Sie Ihre Änderungen.

Testen Sie Ihre Konfiguration

Bevor Sie die automatische Bereitstellung aktivieren, empfehlen wir Ihnen dringend, die Konfiguration mit der On Demand-Funktion zu testen.

1. Weisen Sie Ihrer benutzerdefinierten Azure App einen Nutzer zu.
2. Kehren Sie dann zur Zuweisungsseite Ihrer SCIM-App zurück.
3. Wählen Sie in der oberen Navigationsleiste Bereitstellung auf Abruf.
   
4. Suchen Sie nach dem Nutzerkonto, das Sie der App zugewiesen haben, und wählen Sie es aus.
5. Wählen Sie es aus und klicken Sie unten auf der Seite auf Bereitstellung.
6. Die Bereitstellung beginnt und listet die Ergebnisse der einzelnen Schritte auf, sobald sie abgeschlossen sind.
   
7. Wenn alle Schritte erfolgreich waren, können Sie zu Showpad wechseln und bestätigen, dass der Nutzer erstellt werden konnte und mit allen zugeordneten Eigenschaften zugewiesen wurde.

Starten der Bereitstellung

1. Klicken Sie auf der Seite Home Screen auf die Schaltfläche Starten der Bereitstellung, um das automatische Verfahren zu starten.
   
2. Von diesem Bildschirm aus können Sie auch Ihre Bereitstellung stoppen, neu starten, bearbeiten und die Bereitstellung bei Bedarf einrichten. Klicken Sie bei Bedarf auf Aktualisieren.

Zuweisung von Nutzern und Gruppen

1. Um Nutzer und Gruppen bereitzustellen bzw. die Bereitstellung aufzuheben, müssen sie der Unternehmensanwendung zugewiesen werden. Gehen Sie dazu auf den Übersichtsabschnitt Ihrer SCIM-Unternehmensanwendung.
2. Wählen Sie in der linken Navigationsleiste Nutzer und Gruppen.
3. Klicken Sie in der oberen Navigationsleiste auf Nutzer/Gruppen hinzufügen.
4. Suchen Sie nach Nutzern und/oder Gruppen, die Sie dieser Anwendung hinzufügen möchten, und wählen Sie sie aus
5. Klicken Sie auf Zuweisen.

Anhänge