Konfigurieren von Peripass für die automatische Benutzerbereitstellung
In diesem Lernprogramm werden die Schritte beschrieben, die Sie in Peripass und Microsoft Entra ID ausführen müssen, um die automatische Benutzerbereitstellung zu konfigurieren. Wenn sie konfiguriert ist, stellt die Microsoft Entra ID mithilfe des Microsoft Entra-Bereitstellungsdienstes Benutzer und Gruppen für Peripass automatisch bereit und entfernt sie wieder. Wichtige Informationen dazu, was dieser Dienst tut, wie er funktioniert, und häufig gestellte Fragen finden Sie unter Automatisieren der Benutzerbereitstellung und -entfernung für SaaS-Anwendungen mit Microsoft Entra ID.
Unterstützte Funktionen
- Erstellen von Benutzern in Peripass
- Entfernen von Benutzern in Peripass, wenn sie keinen Zugriff mehr benötigen
- Synchronisieren von Benutzerattributen zwischen Microsoft Entra ID und Peripass
- Einmalanmeldung bei Peripass (empfohlen)
Voraussetzungen
In diesem Lernprogramm wird davon ausgegangen, dass Sie bereits über die folgenden Voraussetzungen verfügen:
- Ein Microsoft Entra-Mandant
- Eine der folgenden Rollen: Anwendungsadministrator, Cloudanwendungsadministratoroder Anwendungsbesitzer.
- Ein Peripass-Mandant – bitte kontaktieren Sie Peripass, um Ihren Mandanten einzurichten.
- Ein Peripass-Benutzer mit Berechtigungen für die Konfiguration des Mandanten.
Schritt 1: Planen der Bereitstellung
- Erfahren Sie mehr über , wie der Bereitstellungsdienstfunktioniert.
- Bestimmen Sie, wer sich im Bereich für die Bereitstellungbefindet.
- Ermitteln Sie, welche Daten zwischen Microsoft Entra ID und Peripasszugeordnet werden sollen.
Schritt 2: Konfigurieren von Peripass zur Unterstützung der Bereitstellung mit Microsoft Entra ID
Melden Sie sich mit der Anmelde-URL Ihres Mandanten bei Peripass an.
Wechseln Sie zur KonfigurationIhres Mandanten.
Öffnen Sie die Identitätsanbieter & Bereitstellungseinstellungen.
Weisen Sie dem Identitätsanbieter, den Sie konfigurieren, einen Anbieternamen zu.
Wählen Sie die Benutzerrolle aus, die den bereitgestellten Benutzern zugewiesen werden soll.
Notieren Sie sich den SCIM-Endpunkt und den SCIM-Token Ihres Mandanten. Sie werden diese später benötigen, wenn Sie die Benutzerbereitstellung in den Microsoft Entra Enterprise-Anwendungen konfigurieren und sie als Peripass-Mandanten-URL sowie den geheimen Tokenverwenden.
Speichern der Änderungen in der Konfiguration.
Schritt 3: Hinzufügen von Peripass aus dem Microsoft Entra-Anwendungskatalog
Fügen Sie Peripass aus dem Microsoft Entra-Anwendungskatalog hinzu, um mit der Verwaltung der Bereitstellung für Peripass zu beginnen. Wenn Sie Peripass zuvor für SSO eingerichtet haben, können Sie dieselbe Anwendung verwenden. Es wird jedoch empfohlen, beim anfänglichen Testen der Integration eine separate App zu erstellen. Erfahren Sie mehr über das Hinzufügen einer Anwendung aus dem Katalog hier.
Schritt 4: Definieren, wer für die Bereitstellung vorgesehen ist
Mit dem Microsoft Entra-Bereitstellungsdienst können Sie festlegen, wer basierend auf der Zuweisung zur Anwendung und oder basierend auf Attributen des Benutzers/der Gruppe bereitgestellt wird. Wenn Sie festlegen, wer basierend auf der Zuweisung für Ihre App bereitgestellt wird, können Sie die folgenden Schritte verwenden, um der Anwendung Benutzer und Gruppen zuzuweisen. Wenn Sie die Bereitstellung ausschließlich basierend auf den Attributen des Benutzers oder der Gruppe festlegen möchten, können Sie einen Segmentierungsfilter verwenden, wie hier beschrieben.
Beginnen Sie klein. Testen Sie mit einer kleinen Gruppe von Benutzern und Gruppen, bevor Sie es für alle einführen. Wenn der Bereich für die Bereitstellung auf zugewiesene Benutzer und Gruppen festgelegt ist, können Sie dies steuern, indem Sie der App einen oder zwei Benutzer oder Gruppen zuweisen. Wenn der Bereich auf alle Benutzer und Gruppen festgelegt ist, können Sie einen attributbasierten Bereichsdefinitionsfilterangeben.
Wenn Sie zusätzliche Rollen benötigen, können Sie das Anwendungsmanifest aktualisieren, um neue Rollen hinzuzufügen.
Schritt 5: Konfigurieren der automatischen Benutzerbereitstellung für Peripass
Dieser Abschnitt führt Sie durch die Schritte zum Konfigurieren des Microsoft Entra-Bereitstellungsdiensts zum Erstellen, Aktualisieren und Deaktivieren von Benutzern und/oder Gruppen in TestApp basierend auf Benutzer- und/oder Gruppenzuweisungen in Microsoft Entra ID.
So konfigurieren Sie die automatische Benutzerbereitstellung für Peripass in der Microsoft Entra-ID:
Melden Sie sich im Microsoft Entra Verwaltungszentrum als mindestens ein Cloud-Anwendungsadministratoran.
Navigieren Sie zu Identity>Applications>Enterprise-Anwendungen
Wählen Sie in der Anwendungsliste Peripassaus.
Wählen Sie die Registerkarte Bereitstellung aus.
Legen Sie den Bereitstellungsmodus auf Automatikfest.
Geben Sie im Abschnitt Admin-Anmeldeinformationen Ihre Peripass-Mandanten-URL und das geheime Token ein. Klicken Sie auf Verbindungstest, um sicherzustellen, dass die Microsoft Entra-ID eine Verbindung mit Peripass herstellen kann. Wenn die Verbindung fehlschlägt, stellen Sie sicher, dass Ihr Peripass-Konto über Administratorberechtigungen verfügt, und versuchen Sie es erneut.
Geben Sie im Feld Benachrichtigungs-E-Mail- die E-Mail-Adresse einer Person oder Gruppe ein, die die Bereitstellungsfehlerbenachrichtigungen erhalten soll, und aktivieren Sie die E-Mail-Benachrichtigung senden, wenn ein Fehler auftritt Kontrollkästchen.
Wählen Sie Speichernaus.
Unter dem Abschnitt Zuordnungen wählen Sie die Option Microsoft Entra-Benutzer mit Peripasssynchronisieren.
Überprüfen Sie die Benutzerattribute, die aus der Microsoft Entra-ID mit Peripass synchronisiert werden, im Abschnitt Attributzuordnung. Die als Übereinstimmende Eigenschaften ausgewählten Attribute werden verwendet, um die Benutzerkonten in Peripass für Aktualisierungsoperationen abzugleichen. Wenn Sie das übereinstimmende Zielattribut vonändern möchten, müssen Sie sicherstellen, dass die Peripass-API das Filtern von Benutzern basierend auf diesem Attribut unterstützt. Wählen Sie die Schaltfläche Speichern aus, um änderungen zu übernehmen.
Attribut Typ Unterstützt zum Filtern Nutzername Schnur ✓ aktiv Boolesch Anzeigename Schnur externalId Schnur bevorzugte Sprache Schnur name.vorname Schnur name.familyName Schnur name.formatiert Schnur phoneNumbers[type eq "mobil"].wert Schnur e-mails[typ gleich "arbeit"].wert Schnur Informationen zum Konfigurieren von Bereichsfiltern finden Sie in der folgenden Anleitung im Bereichsfilter-Tutorial.
Um den Microsoft Entra-Bereitstellungsdienst für Peripass zu aktivieren, ändern Sie den Bereitstellungsstatus in On im Abschnitt Einstellungen.
Definieren Sie die Benutzer und/oder Gruppen, die Sie für Peripass bereitstellen möchten, indem Sie die gewünschten Werte in Bereichs- im Abschnitt Einstellungen auswählen.
Wenn Sie bereit für die Bereitstellung sind, klicken Sie auf Speichern.
Dieser Vorgang startet den anfänglichen Synchronisierungszyklus aller Benutzer und Gruppen, die in Bereich im Abschnitt Einstellungen definiert sind. Der anfängliche Zyklus dauert länger als nachfolgende Zyklen, die ungefähr alle 40 Minuten auftreten, solange der Microsoft Entra-Bereitstellungsdienst ausgeführt wird.
Schritt 6: Überwachen der Bereitstellung
Nachdem Sie die Bereitstellung konfiguriert haben, verwenden Sie die folgenden Ressourcen, um Ihre Bereitstellung zu überwachen:
- Verwenden Sie die Bereitstellungsprotokolle, um zu ermitteln, welche Benutzer erfolgreich oder erfolglos bereitgestellt wurden.
- Überprüfen Sie den Fortschrittsbalken, um den Status des Bereitstellungszyklus anzuzeigen und wie nah er am Abschluss ist.
- Wenn sich die Bereitstellungskonfiguration in einem ungesunden Zustand befindet, geht die Anwendung in Quarantäne über. Erfahren Sie mehr über Quarantänezustände hier.
Weitere Ressourcen
- Verwalten der Bereitstellung von Benutzerkonten für Enterprise Apps
- Was ist Anwendungszugriff und einmaliges Anmelden mit Microsoft Entra ID?