Tutorial: Konfigurieren von TheOrgWiki für die automatische Benutzerbereitstellung
In diesem Tutorial werden die Schritte erläutert, die in TheOrgWiki und Microsoft Entra ID ausgeführt werden müssen, um Microsoft Entra ID für die automatische Bereitstellung und die Aufhebung der Bereitstellung von Benutzer*innen und/oder Gruppen in TheOrgWiki zu konfigurieren.
Hinweis
In diesem Tutorial wird ein Connector beschrieben, der auf dem Bereitstellungsdienst für Benutzer*innen für Microsoft Entra-Benutzer*innen basiert. Wichtige Details zum Zweck und zur Funktionsweise dieses Diensts sowie häufig gestellte Fragen finden Sie unter Automatisieren der Bereitstellung und Bereitstellungsaufhebung von Benutzer*innen für SaaS-Anwendungen mit Microsoft Entra ID.
Voraussetzungen
Das diesem Tutorial zu Grunde liegende Szenario setzt voraus, dass Sie bereits über die folgenden Voraussetzungen verfügen:
- Ein Microsoft Entra-Mandant.
- Einen TheOrgWiki-Mandanten
- Ein Benutzerkonto in TheOrgWiki mit Teamadministratorberechtigungen
Zuweisen von Benutzern zu TheOrgWiki
Microsoft Entra ID ermittelt anhand von Zuweisungen, welche Benutzer*innen Zugriff auf ausgewählte Apps erhalten sollen. Im Kontext der automatischen Bereitstellung von Benutzer*innen werden nur die Benutzer*innen und/oder Gruppen synchronisiert, die einer Anwendung in Microsoft Entra ID zugewiesen wurden.
Vor dem Konfigurieren und Aktivieren der automatischen Bereitstellung von Benutzer*innen müssen Sie entscheiden, welche Benutzer*innen und/oder Gruppen in Microsoft Entra ID Zugriff auf TheOrgWiki benötigen. Anschließend können Sie diese Benutzer bzw. Gruppen TheOrgWiki wie folgt zuweisen:
Wichtige Tipps zum Zuweisen von Benutzern zu TheOrgWiki
Es wird empfohlen, TheOrgWiki einzelne Microsoft Entra-Benutzer*innen zuzuweisen, um die Konfiguration der automatischen Bereitstellung von Benutzer*innen zu testen. Später können weitere Benutzer und/oder Gruppen zugewiesen werden.
Beim Zuweisen eines Benutzers an TheOrgWiki müssen Sie im Dialogfeld für die Zuweisung eine gültige anwendungsspezifische Rolle auswählen (sofern verfügbar). Benutzer mit der Rolle Standardzugriff werden von der Bereitstellung ausgeschlossen.
Einrichten von TheOrgWiki für die Bereitstellung
Bevor Sie TheOrgWiki für die automatische Benutzerbereitstellung mit Microsoft Entra ID konfigurieren, müssen Sie in TheOrgWiki die SCIM-Bereitstellung aktivieren.
Melden Sie sich bei der TheOrgWiki-Verwaltungskonsole an. Klicken Sie auf Verwaltungskonsole.
Klicken Sie in der Verwaltungskonsole auf die Registerkarte Einstellungen.
Navigieren Sie zu Dienstkonten.
Klicken Sie auf +Dienstkonto. Wählen unter Dienstkontotyp die Option Tokenbasiert aus. Klicken Sie auf Speichern.
Kopieren Sie die aktiven Token. Dieser Wert wird auf der Registerkarte „Provisioning“ Ihrer TheOrgWiki-Anwendung in das Feld „Secret Token“ eingegeben.
Hinzufügen von TheOrgWiki über den Katalog
Um TheOrgWiki für die automatische Benutzerbereitstellung mit Microsoft Entra ID zu konfigurieren, müssen Sie TheOrgWiki aus dem Microsoft Entra-Anwendungskatalog Ihrer Liste mit verwalteten SaaS-Anwendungen hinzufügen.
Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Neue Anwendung.
Geben Sie im Abschnitt Aus Katalog hinzufügen den Wert TheOrgWiki ein, und wählen Sie im Ergebnisbereich TheOrgWiki aus.
Wählen Sie die Schaltfläche Anmeldung bei TheOrgWiki aus, über die Sie an die Anmeldeseite von TheOrgWiki umgeleitet werden.
Wählen Sie in der oberen rechten Ecke Anmelden aus.
Da TheOrgWiki eine OpenIDConnect-App ist, können Sie sich mit Ihrem Microsoft-Geschäftskonto bei TheOrgWiki anmelden.
Nach einer erfolgreichen Authentifizierung wird die Anwendung automatisch Ihrem Mandanten hinzugefügt, und Sie werden zu Ihrem TheOrgWiki-Konto umgeleitet.
Konfigurieren der automatischen Benutzerbereitstellung in TheOrgWiki
In diesem Abschnitt werden die Schritte zum Konfigurieren des Microsoft Entra-Bereitstellungsdiensts zum Erstellen, Aktualisieren und Deaktivieren von Benutzer bzw. Gruppen in TheOrgWiki auf der Grundlage von Benutzer- oder Gruppenzuweisungen in Microsoft Entra ID erläutert.
So konfigurieren Sie die automatische Benutzerbereitstellung für TheOrgWiki in Microsoft Entra ID:
Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen.
Wählen Sie in der Anwendungsliste den Eintrag TheOrgWiki aus.
Wählen Sie die Registerkarte Bereitstellung.
Legen Sie den Bereitstellungsmodus auf Automatisch fest.
Geben Sie im Abschnitt Administratoranmeldeinformationen im Feld Mandanten-URL die Zeichenfolge
https://<TheOrgWiki Subdomain value>.theorgwiki.com/api/v2/scim/v2/ein.Beispiel:
https://test1.theorgwiki.com/api/v2/scim/v2/
Hinweis
Der Wert der Unterdomäne kann nur während des ersten Anmeldevorgangs für TheOrgWiki festgelegt werden.
Geben Sie den Tokenwert in das Feld Geheimes Token ein, den Sie zuvor aus TheOrgWiki abgerufen haben. Klicken Sie auf Verbindung testen, um sicherzustellen, dass Microsoft Entra ID eine Verbindung mit TheOrgWiki herstellen kann. Vergewissern Sie sich im Falle eines Verbindungsfehlers, dass Ihr TheOrgWiki-Konto über Administratorberechtigungen verfügt, und wiederholen Sie den Vorgang.
Geben Sie im Feld Benachrichtigungs-E-Mail die E-Mail-Adresse einer Person oder einer Gruppe ein, die Benachrichtigungen zu Bereitstellungsfehlern erhalten soll, und aktivieren Sie das Kontrollkästchen Bei Fehler E-Mail-Benachrichtigung senden.
Klicken Sie auf Speichern.
Wählen Sie im Abschnitt Zuordnungen die Option Synchronize Microsoft Entra-Benutzer mit TheOrgWiki synchronisieren aus.
Überprüfen Sie im Abschnitt Attributzuordnungen die Benutzerattribute, die von Microsoft Entra ID mit TheOrgWiki synchronisiert werden. Beachten Sie, dass die als übereinstimmende Eigenschaften ausgewählten Attribute für den Abgleich der Benutzerkonten in TheOrgWiki für Updatevorgänge verwendet werden. Wählen Sie die Schaltfläche Speichern, um alle Änderungen zu übernehmen.
.Wenn Sie Bereichsfilter konfigurieren möchten, lesen Sie die Anweisungen unter Attributbasierte Anwendungsbereitstellung mit Bereichsfiltern.
Um den Microsoft Entra-Bereitstellungsdienst für TheOrgWiki zu aktivieren, ändern Sie den Bereitstellungsstatus im Abschnitt Einstellungen zu Ein.
Legen Sie die Benutzer bzw. Gruppen fest, die in TheOrgWiki bereitgestellt werden sollen. Wählen Sie dazu im Abschnitt Einstellungen unter Bereich die gewünschten Werte aus.
Wenn Sie fertig sind, klicken Sie auf Speichern.
Dadurch wird die Erstsynchronisierung aller Benutzer und/oder Gruppen gestartet, die im Abschnitt Einstellungen unter Bereich definiert sind. Die Erstsynchronisierung nimmt mehr Zeit in Anspruch als die nachfolgenden Synchronisierungen. Unter Überprüfen des Status der Benutzerbereitstellung finden Sie weitere Informationen dazu, wie lange das Bereitstellen von Benutzern und/oder Gruppen dauert.
Im Abschnitt Aktueller Status können Sie den Fortschritt überwachen und Links zu Ihrem Bericht zur Bereitstellungsaktivität aufrufen. Darin sind alle Aktionen aufgeführt, die vom Microsoft Entra-Bereitstellungsdienst in TheOrgWiki ausgeführt werden. Weitere Informationen finden Sie unter Ermitteln, wann ein bestimmter Benutzer auf eine Anwendung zugreifen kann. Informationen zum Lesen der Microsoft Entra-Bereitstellungsprotokolle finden Sie unter Berichterstellung zur automatischen Benutzerkontobereitstellung.
Weitere Ressourcen
- Verwalten der Benutzerkontobereitstellung für Unternehmens-Apps.
- Was ist Anwendungszugriff und einmaliges Anmelden mit Microsoft Entra ID?