Konfigurieren von Ardoq für die automatische Benutzerbereitstellung mit Microsoft Entra ID

2025-04-30

In diesem Artikel werden die Schritte beschrieben, die Sie sowohl in der Ardoq- als auch in der Microsoft Entra-ID ausführen müssen, um die automatische Benutzerbereitstellung zu konfigurieren. Bei richtiger Konfiguration stellt die Microsoft Entra-ID automatisch Benutzer mithilfe des Microsoft Entra-Bereitstellungsdienstes bereit und entfernt sie aus Ardoq. Wichtige Informationen dazu, was dieser Dienst tut, wie er funktioniert, und häufig gestellte Fragen finden Sie unter Automatisieren der Benutzerbereitstellung und -entzug für SaaS-Anwendungen mit Microsoft Entra ID.

Unterstützte Funktionen

Erstellen von Benutzern in Ardoq.
Entfernen Sie Benutzer in Ardoq, wenn sie keinen Zugriff mehr benötigen.
Synchronisieren von Benutzerattributen zwischen Microsoft Entra ID und Insight4GRC.
Single Sign-on bei Ardoq (empfohlen).

Voraussetzungen

In diesem Artikel wird davon ausgegangen, dass Sie bereits über die folgenden Voraussetzungen verfügen:

Ein Microsoft Entra-Mandant
Eine der folgenden Rollen: Anwendungsadministrator, Cloudanwendungsadministrator oder Anwendungsbesitzer.
Ein Administratorkonto bei Ardoq.

Schritt 1: Planen Sie Ihren Bereitstellungsprozess

Erfahren Sie , wie der Bereitstellungsdienst funktioniert.
Identifizieren Sie, wer im Umfang der Bereitstellung enthalten ist.
Bestimmen Sie, welche Daten zwischen Microsoft Entra ID und Ardoq zugeordnet werden sollen.

Schritt 2: Konfigurieren von Albert für die Unterstützung der Bereitstellung mit Microsoft Entra ID

Die Bereitstellung wird über einen Feature Toggle in Ardoq kontrolliert. Wenn Sie SSO konfigurieren oder dies bereits getan haben, erkennt Ardoq automatisch, dass Microsoft Entra ID verwendet wird, und das Bereitstellungsfeature wird automatisch aktiviert.
Wenn Sie nicht beabsichtigen, die Bereitstellungsfeatures von Azure AD zusammen mit SSO zu verwenden, wenden Sie sich bitte an den Ardoq-Kundensupport, der den Support für die Bereitstellung manuell aktivieren wird.

Bevor wir fortfahren, müssen wir eine Mandanten-URL und ein geheimes Token abrufen, um die sichere Kommunikation zwischen Microsoft Entra ID und Ardoq zu konfigurieren.

Melden Sie sich bei der Ardoq-Verwaltungskonsole an.
Wählen Sie im linken Menü das Profil-Logo aus und navigieren Sie zu Organisationseinstellungen->Organisation verwalten->SCIM-Token verwalten.
Wählen Sie "Neu generieren" aus.
Kopieren sie das Token, und speichern Sie es. Dieser Wert wird in das Feld "Geheimes Token " auf der Registerkarte "Bereitstellung" Ihrer Ardoq-Anwendung eingegeben.
Um Ihre Mandanten-URL zu erstellen, verwenden Sie diese Vorlage: https://<YOUR-SUBDOMAIN>.ardoq.com/api/scim/v2 indem Sie den Platzhaltertext <YOUR-SUBDOMAIN>ersetzen. Dieser Wert wird im Feld "Mandanten-URL " auf der Registerkarte "Bereitstellung" Ihrer Ardoq-Anwendung eingegeben.

Hinweis

<YOUR-SUBDOMAIN> ist die Unterdomäne, die Ihre Organisation für den Zugriff auf Ardoq ausgewählt hat. Dies ist das gleiche URL-Segment, das Sie beim Zugriff auf die Ardoq-App verwenden. Wenn Ihre Organisation beispielsweise unter https://acme.ardoq.com auf Ardoq zugreift, geben Sie acme ein. Wenn Sie sich in den USA befinden und unter https://piedpiper.us.ardoq.com auf Ardoq zugreifen, geben Sie piedpiper.us ein.

Schritt 3: Hinzufügen von Albert aus dem Microsoft Entra-Anwendungskatalog

Fügen Sie Ardoq aus dem Azure AD-Anwendungskatalog hinzu, um mit der Verwaltung der Bereitstellung in Ardoq zu beginnen. Wenn Sie Ardoq zuvor für das SSO eingerichtet haben, können Sie dieselbe Anwendung verwenden. Es wird jedoch empfohlen, beim anfänglichen Testen der Integration eine separate App zu erstellen. Weitere Informationen zum Hinzufügen einer Anwendung aus dem Katalog finden Sie hier.

Schritt 4: Definieren, wer in die Bereitstellung einbezogen werden soll

Mit dem Microsoft Entra-Bereitstellungsdienst können Sie festlegen, wer basierend auf der Zuweisung zur Anwendung oder basierend auf Attributen des Benutzers oder der Gruppe bereitgestellt wird. Wenn Sie festlegen, welche Nutzer und Gruppen basierend auf der Zuweisung für Ihre App bereitgestellt werden, können Sie die Schritte zum Zuweisen von Benutzern und Gruppen zur Anwendung verwenden. Wenn Sie festlegen möchten, wer basierend ausschließlich auf den Attributen des Benutzers oder der Gruppe bereitgestellt wird, können Sie einen Bereichsfilter verwenden.

Beginnen Sie klein. Testen Sie mit einer kleinen Anzahl von Benutzern und Gruppen, bevor Sie es auf alle anwenden. 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 Bereichsdefinitionsfilter angeben.
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 Ardoq

Dieser Abschnitt führt Sie durch die Schritte zum Konfigurieren des Microsoft Entra-Bereitstellungsdiensts zum Erstellen, Aktualisieren und Deaktivieren von Benutzern in TestApp basierend auf Benutzer- und/oder Gruppenzuweisungen in Microsoft Entra ID.

So konfigurieren Sie die automatische Benutzerbereitstellung für SpaceIQ in Microsoft Entra ID:

Melden Sie sich mindestens als Cloudanwendungsadministrator beim Microsoft Entra Admin Center an.
Navigieren Sie zu Entra ID>Enterprise-Apps
Wählen Sie in der Anwendungsliste Ardoq aus.
Wählen Sie die Registerkarte "Bereitstellung" aus .
Legen Sie den Bereitstellungsmodus auf "Automatisch" fest.
Geben Sie im Abschnitt "Administratoranmeldeinformationen " Ihre Ardoq-Mandanten-URL und Ihr geheimes Token ein. Wählen Sie "Testverbindung" aus, um sicherzustellen, dass die Microsoft Entra-ID eine Verbindung mit Ardoq herstellen kann. Wenn die Verbindung nicht hergestellt werden kann, stellen Sie sicher, dass Ihr Ardoq-Konto über Administratorberechtigungen verfügt, und versuchen Sie es noch einmal.
Geben Sie im Feld " Benachrichtigungs-E-Mail " die E-Mail-Adresse einer Person oder Gruppe ein, die die Bereitstellungsfehlerbenachrichtigungen erhalten soll, und aktivieren Sie das Kontrollkästchen " E-Mail-Benachrichtigung senden", wenn ein Fehler auftritt .
Wählen Sie "Speichern" aus.
Wählen Sie im Abschnitt "Zuordnungen " die Option "Microsoft Entra-Benutzer mit Ardoq synchronisieren" aus.

Überprüfen Sie die Benutzerattribute, die von Microsoft Entra ID mit Ardoq synchronisiert werden, im Abschnitt "Attributzuordnung ". Die Attribute, die als Matching-Eigenschaften ausgewählt wurden, werden verwendet, um die Benutzerkonten in Ardoq für Aktualisierungsvorgänge abzugleichen. Wenn Sie das übereinstimmende Zielattribute ändern möchten, müssen Sie sicherstellen, dass die Ardoq-API das Filtern von Benutzern basierend auf diesem Attribut unterstützt. Wählen Sie die Schaltfläche " Speichern " aus, um änderungen zu übernehmen.

Merkmal	Typ	Unterstützung für das Filtern	Erforderlich für Ardoq
Nutzername	Schnur	✓	✓
aktiv	Boolescher Typ (Boolean)		✓
Anzeigename	Schnur		✓
roles[primary eq "Wahr"].value	Schnur		✓

Informationen zum Konfigurieren von Bereichsfiltern finden Sie in den folgenden Anweisungen im Bereichsfilterartikel.
Um den Microsoft Entra-Bereitstellungsdienst für Ardoq zu aktivieren, ändern Sie den Bereitstellungsstatus im Abschnitt "Einstellungen" in "Ein".
Definieren Sie die Benutzer, die Sie für Ardoq bereitstellen möchten, indem Sie die gewünschten Werte im Bereich im Abschnitt "Einstellungen" auswählen.
Wenn Sie bereit für die Bereitstellung sind, wählen Sie "Speichern" aus.

Dieser Vorgang startet den anfänglichen Synchronisierungszyklus aller Benutzer, die im Scope im Einstellungen-Abschnitt 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 werden.
Überprüfen Sie den Fortschrittsbalken, um den Status des Bereitstellungszyklus zu sehen und wie nah er an der Fertigstellung ist.
Wenn sich die Bereitstellungskonfiguration in einem fehlerhaften Zustand zu befinden scheint, wird die Anwendung unter Quarantäne gestellt. Weitere Informationen zu Quarantänezuständen finden Sie im Artikel zum Quarantänestatus der Anwendungsbereitstellung.

Weitere Ressourcen

Erfahren Sie, wie Sie Protokolle überprüfen und Berichte zu Bereitstellungsaktivitäten abrufen.