Freigeben über


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

In diesem Artikel werden die Schritte beschrieben, die Sie sowohl in Asana als auch in der Microsoft Entra-ID ausführen müssen, um die automatische Benutzerbereitstellung zu konfigurieren. Wenn diese Funktion konfiguriert ist, stellt Microsoft Entra ID über den Microsoft Entra-Bereitstellungsdienst automatisch Benutzer und Gruppen für Asana bereit bzw. hebt die Bereitstellung auf. Weitere Informationen darüber, was dieser Dienst tut, wie er funktioniert und Antworten auf häufig gestellte Fragen finden Sie unter Automatisieren der Benutzerbereitstellung und -deaktivierung für SaaS-Anwendungen mit Microsoft Entra ID.

Unterstützte Funktionen

  • Erstellen von Benutzern in Asana
  • Entfernen Sie Benutzer in Asana, wenn sie keinen Zugriff mehr benötigen.
  • Synchronisieren von Benutzerattributen zwischen Microsoft Entra ID und Asana.
  • Bereitstellen von Gruppen und Gruppenmitgliedschaften in Asana.
  • Einmaliges Anmelden bei Asana (empfohlen).

Voraussetzungen

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

  • Einen Asana-Mandanten, für den mindestens der Enterprise-Tarif aktiviert ist
  • Ein Benutzerkonto in Asana mit Administratorrechten

Hinweis

Die Microsoft Entra-Bereitstellungsintegration basiert auf der Asana-API, die für Asana verfügbar ist.

Schritt 1: Planen Sie Ihren Bereitstellungsprozess

  1. Erfahren Sie , wie der Bereitstellungsdienst funktioniert.
  2. Definieren Sie den Geltungsbereich für die Bereitstellung.
  3. Bestimmen Sie, welche Daten zwischen Microsoft Entra ID und Asana zugeordnet werden sollen.

Schritt 2: Konfigurieren von Asana, damit es die Bereitstellung mit Microsoft Entra ID unterstützt

Tipp

Um das SAML-basierte einmalige Anmelden für Asana zu aktivieren, befolgen Sie hierzu die Anweisungen. Einmaliges Anmelden kann unabhängig von der automatischen Bereitstellung konfiguriert werden, obwohl diese beiden Features einander ergänzen.

Dienstkontotoken in Asana generieren

  1. Melden Sie sich mit Ihrem Administratorkonto bei Asana an.

  2. Wählen Sie das Profilfoto in der oberen Leiste aus, und wählen Sie "Verwaltungskonsole" aus.

  3. Wählen Sie mit Ihrer Administratorkonsole die Registerkarte "Apps" aus.

  4. Wählen Sie "Dienstkonten" aus.

  5. Wählen Sie "Dienstkonto hinzufügen" aus, und führen Sie die folgenden Schritte aus.

    Screenshot des Dienstkontotokens.

    1. Aktualisieren Sie den Namen und die Beschreibung nach Bedarf.
    2. Wählen Sie im Abschnitt Berechtigungsbereiche die Option Auf Bereich festgelegte Berechtigungen und Benutzerbereitstellung (SCIM) aus. Stellen Sie sicher, dass die folgenden Berechtigungsbereiche ausgewählt sind:
      • Benutzer: Lesen
      • Benutzer: Erstellen und Ändern
      • Teams: Lesen
      • Teams: Erstellen und Ändern
    3. Wählen Sie " Änderungen speichern" aus.
  6. Kopiere das Token.

Fügen Sie Asana aus dem Microsoft Entra-Anwendungskatalog hinzu, um mit dem Verwalten der Bereitstellung in Asana zu beginnen. Wenn Sie Asana bereits für einmaliges Anmelden (Single Sign-On, SSO) eingerichtet haben, können Sie die gleiche 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 basierend auf der Zuweisung festlegen, wer für Ihre Anwendung bereitgestellt wird, können Sie die Schritte zum Zuweisen von Benutzern und Gruppen zur Anwendung verwenden. Wenn Sie allein anhand der Attribute von Benutzenden oder der Gruppe auswählen möchten, wer 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 in Asana

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

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

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

  2. Navigieren Sie zu Entra ID>Enterprise-Apps

    Screenshot: Bereich „Unternehmensanwendungen“

  3. Wählen Sie in der Anwendungsliste "Asana" aus.

    Screenshot des Asana-Links in der Liste

  4. Wählen Sie die Registerkarte "Bereitstellung" aus .

    Screenshot der Registerkarte Bereitstellung.

  5. Legen Sie den Bereitstellungsmodus auf "Automatisch" fest.

    Screenshot: Registerkarte „Bereitstellung“, Bereitstellungsmodus „Automatisch“

  6. Geben Sie im Abschnitt "Administratoranmeldeinformationen " Ihre Asana-Mandanten-URL und Ihr geheimes Token ein, das von Asana bereitgestellt wird. Wählen Sie "Verbindung testen" aus, um sicherzustellen, dass die Microsoft Entra-ID eine Verbindung mit Asana herstellen kann. Wenn die Verbindung nicht hergestellt werden kann, wenden Sie sich an Asana, um die Einrichtung Ihres Kontos zu überprüfen.

    Screenshot des Tokens.

  7. 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 .

    Screenshot der Benachrichtigungs-E-Mail.

  8. Wählen Sie "Speichern" aus.

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

  10. Überprüfen Sie die Benutzerattribute, die aus der Microsoft Entra-ID mit Asana synchronisiert werden, im Abschnitt "Attributzuordnung" . Beachten Sie, dass die als übereinstimmende Eigenschaften ausgewählten Attribute für den Abgleich der Benutzerkonten in Asana für Updatevorgänge verwendet werden. Wenn Sie das übereinstimmende Zielattribute ändern möchten, müssen Sie sicherstellen, dass die Asana-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 Asana
    Nutzername Schnur
    active Boolescher Wert
    name.formatted Schnur
    title Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager Referenz
    addresses[type eq "work"].country Schnur
    addresses[type eq "work"].region Schnur
    addresses[type eq "work"].locality Schnur
    phoneNumbers[type eq "work"].value Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division Schnur
  11. Wählen Sie im Abschnitt "Zuordnungen " die Option "Microsoft Entra-Gruppen mit Asana synchronisieren" aus.

  12. Überprüfen Sie die Gruppenattribute, die von Microsoft Entra ID nach Asana synchronisiert werden, im Abschnitt "Attributzuordnung". Die attribute, die als Übereinstimmende Eigenschaften ausgewählt wurden, werden verwendet, um die Gruppen in Asana für Aktualisierungsvorgänge abzugleichen. Wählen Sie die Schaltfläche " Speichern " aus, um änderungen zu übernehmen.

    Merkmal Typ Unterstützung für das Filtern Erforderlich für Asana
    Anzeigename Schnur
    members Referenz
  13. Informationen zum Konfigurieren von Bereichsfiltern finden Sie in den folgenden Anweisungen im Bereichsfilterartikel.

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

    Screenshot: Bereitstellungsstatus aktiviert.

  15. Definieren Sie die Benutzer und Gruppen, die Sie für Asana bereitstellen möchten, indem Sie die entsprechenden Werte im Bereich im Abschnitt "Einstellungen" auswählen.

    Screenshot des Bereitstellungsbereichs.

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

    Screenshot: Speichern der Bereitstellungskonfiguration.

Dieser Vorgang startet den anfänglichen Synchronisierungszyklus aller in Scope im Abschnitt Einstellungen definierten Benutzer und Gruppen. Der erste Zyklus dauert länger als nachfolgende Zyklen, die ungefähr alle 40 Minuten erfolgen, 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:

  1. Verwenden Sie die Bereitstellungsprotokolle , um zu ermitteln, welche Benutzer erfolgreich oder erfolglos bereitgestellt werden.
  2. Überprüfen Sie den Fortschrittsbalken, um den Status des Bereitstellungszyklus anzuzeigen und zu erfahren, wie nah er am Abschluss ist.
  3. 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 im Artikel Anwendungsbereitstellung im Quarantänestatus.

Änderungsprotokoll

  • 11/06/2021 – Unterstützung für externalId, name.givenName und name.familyName eingestellt. Unterstützung für preferredLanguage, title und urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division hinzugefügt. Gruppenbereitstellung aktiviert.
  • 23.05.2023: Unterstützung für preferredLanguage eingestellt, Unterstützung für urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager hinzugefügt.
  • 07.09.2023 - Unterstützung hinzugefügt für Adressen [type eq "work"].locality, addresses[type eq "work"].region, addresses[type eq "work"].country, phoneNumbers[type eq "work"].value, urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber, urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter, urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization und urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division.

Weitere Ressourcen