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

In diesem Artikel werden die Schritte beschrieben, die Sie sowohl in Twingate als auch in microsoft Entra ID ausführen müssen, um die automatische Benutzerbereitstellung zu konfigurieren. Nach der Konfiguration stellt Microsoft Entra-ID Benutzer und Gruppen automatisch mithilfe des Microsoft Entra-Bereitstellungsdiensts in Twingate bereit und entfernt sie. Wichtige Informationen darüber, welche Funktionen dieser Dienst bietet, wie er funktioniert und Antworten auf häufig gestellte Fragen finden Sie unter Automatisieren der Benutzerbereitstellung und -außerbetriebnahme für SaaS-Anwendungen mit Microsoft Entra ID.

Unterstützte Funktionen

• Erstellen von Benutzern in Twingate
• Entfernen von Benutzern in Twingate, wenn sie keinen Zugriff mehr benötigen
• Synchronisieren von Benutzerattributen zwischen Microsoft Entra ID und Twingate
• Bereitstellen von Gruppen und Gruppenmitgliedschaften in Twingate
• Einmaliges Anmelden bei Twingate (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 Twingate-Mandant in einer Produktebene, die die Integration von Identitätsanbietern unterstützt. Details zu verschiedenen Produktstufen finden Sie unter Twingate-Preise .
• Ein Benutzerkonto in Twingate mit Administratorberechtigungen

Schritt 1: Planen der Bereitstellung

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

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

1. Melden Sie sich bei Ihrer Twingate Admin Console an.

2. Navigieren zu Einstellungen für Identitätsanbieter>

3. Wählen Sie die ... Schaltfläche aus, um das Aktionsmenü zu öffnen. Wählen Sie SCIM-Token neu generieren. Beachten Sie, dass dadurch das bestehende Token (sofern vorhanden) ungültig wird.

   

4. Kopieren Sie den SCIM-Endpunkt und das SCIM-Token aus dem modalen Fenster. Diese Werte werden in die Felder "Mandanten-URL " bzw. "Geheimes Token " auf der Registerkarte "Bereitstellung" Ihrer Twingate-Anwendung eingegeben.

   

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

Fügen Sie Twingate aus dem Microsoft Entra-Anwendungskatalog hinzu, um mit dem Verwalten der Bereitstellung in Twingate zu beginnen. Wenn Sie Twingate zuvor für einmaliges Anmelden (Single Sign-On, 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, wer für Ihre App basierend auf der Zuweisung zugewiesen wird, können Sie die Schritte zum Zuweisen von Benutzern und Gruppen zur App verwenden. Wenn Sie die Bereitstellung auf Grundlage von Attributen des Benutzers oder der Gruppe festlegen möchten, können Sie einen Bereichsfilter verwenden.

• Fangen Sie klein an. Testen Sie die Bereitstellung mit einer kleinen Gruppe von Benutzern und Gruppen, bevor Sie sie für alle freigeben. Wenn der Bereitstellungsbereich auf zugewiesene Benutzer und Gruppen festgelegt ist, können Sie dies durch Zuweisen von einem oder zwei Benutzern oder Gruppen zur App kontrollieren. 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 Twingate

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

So konfigurieren Sie die automatische Benutzerbereitstellung für Twingate 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

   

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

   

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

   

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

   

6. Geben Sie im Abschnitt " Administratoranmeldeinformationen " Ihre Twingate-Mandanten-URL und Ihr geheimes Token ein. Wählen Sie "Verbindung testen" aus, um sicherzustellen, dass Microsoft Entra ID eine Verbindung mit Twingate herstellen kann. Vergewissern Sie sich im Falle eines Verbindungsfehlers, dass Ihr Twingate-Konto über Administratorberechtigungen verfügt, und wiederholen Sie den Vorgang.

   

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 .

   

8. Wählen Sie "Speichern" aus.

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

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

    Attribut	type	Unterstützung für das Filtern
    externalId	Schnur	✓
    Nutzername	Schnur
    aktiv	Boolescher Typ (Boolean)
    E-Mails[Typ eq "Arbeit"].Wert	Schnur
    Name.Vorname	Schnur
    Name.Familienname	Schnur

11. Wählen Sie im Abschnitt "Zuordnungen " die Option "Microsoft Entra-Gruppen mit Twingate synchronisieren" aus.

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

    Attribut	type	Unterstützung für das Filtern
    externalId	Schnur	✓
    Anzeigename	Schnur
    Mitglieder	Verweis

13. Informationen zum Konfigurieren von Bereichsfiltern finden Sie in den folgenden Anweisungen im Bereichsfilterartikel.

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

    

15. Definieren Sie die Benutzer und/oder Gruppen, die Sie für Twingate bereitstellen möchten, indem Sie die gewünschten Werte im Bereich im Abschnitt "Einstellungen" auswählen.

    

16. Wenn Sie bereit für die Bereitstellung sind, wählen Sie "Speichern" aus.

    

Dieser Vorgang startet den anfänglichen Synchronisierungszyklus aller Benutzer und Gruppen, die im Scope im Abschnitt Einstellungen definiert sind. 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: Ändern der erforderlichen Einstellung für die Zuordnung

Die Standardeinstellung ist Nein , mit der Benutzer sich bei Twingate anmelden können, ohne in der Unternehmensanwendung zugewiesen zu werden.

1. Wählen Sie "Eigenschaften" aus.

   

2. Zuweisung erforderlich auf Ja setzen

   

3. Wählen Sie "Speichern" aus.

   

Schritt 7: Überwachen der Bereitstellung

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

1. Verwenden Sie die Bereitstellungsprotokolle , um zu ermitteln, welche Benutzer erfolgreich oder erfolglos bereitgestellt wurden.
2. Überprüfen Sie den Fortschrittsbalken, um den Status des Bereitstellungszyklus zu sehen und wie nahe er an der Fertigstellung ist.
3. 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 hier.

Zusätzliche Ressourcen

• Verwalten der Bereitstellung von Benutzerkonten für Enterprise-Apps
• Was ist Anwendungszugriff und Einmaliges Anmelden mit Microsoft Entra ID?

Verwandte Inhalte

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