Tutorial: Konfigurieren von Playvox für die automatische Benutzerbereitstellung

  • Artikel

In diesem Tutorial werden die Schritte beschrieben, die Sie sowohl in Playvox als auch in Microsoft Entra ID befolgen müssen, um die automatische Benutzerbereitstellung zu konfigurieren. Bei der Konfiguration stellt Microsoft Entra ID mithilfe des Microsoft Entra-Bereitstellungsdiensts automatisch Benutzer oder Gruppen in Playvox bereit und hebt die Bereitstellung auf. Wichtige Details zu diesem Dienst und seiner Funktionsweise sowie Antworten auf häufig gestellten Fragen finden Sie unter Automatisieren der Bereitstellung und Aufhebung der Bereitstellung von Benutzer*innen für SaaS-Anwendungen mit Microsoft Entra ID.

Unterstützte Funktionen

  • Erstellen von Benutzern in Playvox
  • Entfernen von Benutzern aus Playvox, wenn diese keinen Zugriff mehr benötigen
  • Synchronisieren von Benutzerattributen zwischen Microsoft Entra ID und Playvox.

Voraussetzungen

Das in diesem Tutorial vorgestellte Szenario setzt voraus, dass Sie bereits über die folgenden Voraussetzungen verfügen:

Schritt 1: Planen der Bereitstellung

  1. Erfahren Sie, wie der Bereitstellungsdienst funktioniert.

  2. Bestimmen Sie, wer in den Bereitstellungsbereich einbezogen werden soll.

  3. Legen Sie fest, welche Daten zwischen Microsoft Entra ID und Playvox zugeordnet werden sollen.

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

  1. Melden Sie sich bei der Playvox-Verwaltungskonsole an, und navigieren Sie zu Einstellungen > API-Schlüssel.

  2. Wählen Sie API-Schlüssel erstellen aus.

    Partieller Screenshot mit der Stelle, an der sich die Schaltfläche „API-Schlüssel erstellen“ auf der Playvox-Benutzeroberfläche befindet.

  3. Geben Sie einen aussagekräftigen Namen für den API-Schlüssel ein, und wählen Sie Speichern aus. Wählen Sie nach dem Generieren des API-Schlüssels Schließen aus.

  4. Wählen Sie für den erstellten API-Schlüssel das Symbol Details aus.

    Partieller Screenshot mit der Stelle, an der sich das Symbol zum Anzeigen von Details (ein Vergrößerungsglas) auf der Playvox-Benutzeroberfläche befindet.

  5. Kopieren und speichern Sie den Wert BASE64-Schlüssel. Dieser Wert wird später im Azure-Portal auf der Registerkarte Bereitstellung der Playvox-Anwendung im Textfeld Geheimes Token eingegeben.

    Screenshot des Meldungsfelds „Details zum API-Schlüssel

Um mit der Verwaltung der Bereitstellung für Playvox zu beginnen, fügen Sie Playvox aus dem Anwendungskatalog zu Ihrem Microsoft Entra-Mandanten hinzu. Mehr dazu erfahren Sie unter Schnellstart: Hinzufügen einer Anwendung zu Ihrem Microsoft Entra-Mandanten.

Wenn Sie Playvox zuvor für einmaliges Anmelden (SSO) eingerichtet haben, können Sie dieselbe Anwendung verwenden. Wir empfehlen jedoch, beim erstmaligen Testen der Integration eine separate App zu erstellen.

Schritt 4: Definieren der Benutzer für den Bereitstellungsbereich

Sie verwenden den Microsoft Entra-Bereitstellungsdienst dazu, entweder anhand der Zuweisung zur Anwendung oder von Attributen für Benutzer*innen bzw. die Gruppe festzulegen, wer in die Bereitstellung einbezogen werden soll. Um festzulegen, wer anhand der Zuweisung für Ihre App bereitgestellt werden soll, lesen Sie Verwalten von Benutzerzuweisungen für eine App in Microsoft Entra ID. Hier erfahren Sie, wie Sie der Anwendung Benutzer und Gruppen zuweisen. Wenn Sie allein anhand der Attribute des Benutzers oder der Gruppe festlegen möchten, wer bereitgestellt wird, können Sie einen der unter Attributbasierte Anwendungsbereitstellung mit Bereichsfiltern beschriebenen Bereichsfilter verwenden.

Beachten Sie die folgenden Punkte:

  • Beim Zuweisen von Benutzern zu Playvox müssen Sie eine andere Rolle als Standardzugriff auswählen. Benutzer mit der Rolle „Standardzugriff“ werden von der Bereitstellung ausgeschlossen und in den Bereitstellungsprotokollen als „nicht effektiv berechtigt“ gekennzeichnet. Wenn für die Anwendung nur die Rolle „Standardzugriff“ verfügbar ist, können Sie das Anwendungsmanifest aktualisieren und weitere Rollen hinzufügen.

  • Fangen Sie klein an. Testen Sie die Bereitstellung mit wenigen Benutzern oder Gruppen, bevor Sie sie für alle freigeben. Wenn der Bereitstellungsbereich auf zugewiesene Benutzer oder Gruppen festgelegt ist, können Sie der App nur ein oder zwei Benutzer oder Gruppen zuweisen und so die Größe des Bereichs steuern. Wenn der Bereitstellungsbereich alle Benutzer und Gruppen umfasst, können Sie einen attributbasierten Bereichsfilter angeben, um die Größe des Tests einzuschränken.

Schritt 5: Konfigurieren der automatischen Benutzerbereitstellung in Playvox

In diesem Abschnitt werden die Schritte zum Konfigurieren des Microsoft Entra-Bereitstellungsdiensts zum Erstellen, Aktualisieren und Deaktivieren von Benutzer*innen und/oder Gruppen auf der Grundlage von Benutzer- bzw. Gruppenzuweisungen in Microsoft Entra ID erläutert.

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

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.

  2. Browsen Sie zu Identität>Anwendungen>Unternehmensanwendungen.

    Partieller Screenshot des Azure-Portals mit den hervorgehobenen Elementen „Unternehmensanwendungen“ und „Alle Anwendungen“

  3. Suchen Sie in der Anwendungsliste nach Playvox, und wählen Sie diese Anwendung aus.

    Partieller Screenshot der Anwendungsliste, in der das Feld für die Suche nach Anwendungen hervorgehoben ist.

  4. Wählen Sie die Registerkarte Bereitstellung.

    Partieller Screenshot mit dem Menüelement „Bereitstellung“.

  5. Legen Sie den Bereitstellungsmodus auf Automatisch fest.

    Partieller Screenshot der Registerkarte „Bereitstellung“, auf der im Dropdown-Listenfeld „Bereitstellungsmodus“ die Option „Automatisch“ ausgewählt ist.

  6. Geben Sie im Abschnitt Administratoranmeldeinformationen Ihre Playvox-Mandanten-URL wie folgt ein:

    https://{tenant}.playvox.com/scim/v1

    Geben Sie das geheime Token ein, das Sie zuvor in Schritt 2 kopiert haben. Wählen Sie dann Verbindung testen aus, um sicherzustellen, dass Microsoft Entra ID eine Verbindung mit Playvox herstellen kann. Vergewissern Sie sich im Fall eines Verbindungsfehlers, dass Ihr Playvox-Konto über Administratorberechtigungen verfügt, und wiederholen Sie den Vorgang.

    Partieller Screenshot des Abschnitts „Administratoranmeldeinformationen“ mit den Textfeldern „Mandanten-URL“ und „Geheimnis Token“ und dem hervorgehobenen Link „Verbindung testen“.

  7. Geben Sie im Textfeld Benachrichtigungs-E-Mail die E-Mail-Adresse einer Person oder Gruppe ein, die Benachrichtigungen bei Bereitstellungsfehlern erhalten soll. Aktivieren Sie dann das Kontrollkästchen Bei Fehler E-Mail-Benachrichtigung senden.

    Partieller Screenshot mit dem Textfeld „Benachrichtigungs-E-Mail“ und dem Kontrollkästchen zum Aktivieren der E-Mail-Benachrichtigung.

  8. Wählen Sie Speichern.

  9. Wählen Sie im Abschnitt Zuordnungen die Option Microsoft Entra-Benutzer mit Playvox synchronisieren aus.

  10. Überprüfen Sie im Abschnitt Attributzuordnungen die Benutzerattribute, die von Microsoft Entra ID mit Playvox synchronisiert werden. Die als übereinstimmende Eigenschaften ausgewählten Attribute werden verwendet, um die Benutzerkonten in Playvox für Updatevorgänge abzugleichen. Wenn Sie das übereinstimmende Zielattribut ändern möchten, müssen Sie sicherstellen, dass die Playvox-API das Filtern von Benutzern nach diesem Attribut unterstützt. Wählen Sie Speichern aus, um Ihre Änderungen zu committen.

    Attribut type Unterstützung für das Filtern
    userName String ✓
    aktiv Boolean
    displayName String
    emails[type eq "work"].value String
    name.givenName String
    name.familyName String
    name.formatted String
    externalId String

  11. Wenn Sie Bereichsfilter konfigurieren möchten, folgen Sie den Anleitungen im Tutorial Bereichsfilter.

  12. Um den Microsoft Entra-Bereitstellungsdienst für Playvox zu aktivieren, ändern Sie im Abschnitt Einstellungen den Bereitstellungsstatus in Ein.

    Partieller Screenshot des Abschnitts „Einstellungen“, in dem die Option „Bereitstellungsstatus“ auf „Ein“ eingestellt ist.

  13. Definieren Sie unter Einstellungen auch noch die Benutzer oder Gruppen, die für Playvox bereitgestellt werden sollen, indem Sie unter Bereich die gewünschten Werte auswählen.

    Partieller Screenshot des Abschnitts „Einstellungen“ mit dem Dropdown-Listenfeld „Bereich“.

  14. Wählen Sie Speichern aus, wenn die Bereitstellung erfolgen kann.

    Partieller Screenshot mit den Optionen „Speichern“ und „Verwerfen“.

Durch diesen Vorgang wird der erstmalige Synchronisierungszyklus für alle Benutzer und Gruppen gestartet, die im Abschnitt Einstellungen unter Bereich definiert wurden. Der erste Zyklus dauert länger als spätere Zyklen. Später erfolgen die Zyklen etwa alle 40 Minuten, sofern der Microsoft Entra-Bereitstellungsdienst ausgeführt wird.

Schritt 6: Überwachen der Bereitstellung

Nachdem Sie die Bereitstellung konfiguriert haben, können Sie mit den folgenden Ressourcen die Bereitstellung überwachen:

  • Mithilfe der Bereitstellungsprotokolle können Sie ermitteln, welche Benutzer erfolgreich bzw. nicht erfolgreich bereitgestellt wurden.
  • Anhand der Fortschrittsleiste können Sie den Status des Bereitstellungszyklus überprüfen und den Fortschritt der Bereitstellung verfolgen.
  • Wenn sich die Bereitstellungskonfiguration in einem fehlerhaften Zustand zu befinden scheint, wird die Anwendung unter Quarantäne gestellt. Weitere Informationen zum Quarantänestatus finden Sie unter Anwendungsbereitstellung im Quarantänestatus.

Zusätzliche Ressourcen

Nächste Schritte