Knowledge Base

Okta-Integration – SCIM-Konfiguration

Zuletzt bearbeitet: 10.09.2025

Synchronisieren Sie Benutzer und Gruppen von Okta mit TeamViewer über SCIM (System for Cross-domain Identity Management). SCIM unterstützt Admins dabei, Benutzer direkt aus Okta automatisch in TeamViewer zu erstellen, zu aktualisieren, zu deaktivieren und zu verwalten. In diesem Artikel wird erläutert, wie Sie die SCIM-Bereitstellung entweder mit der TeamViewer Anwendung aus dem Okta Integration Network (OIN) oder mit einer benutzerdefinierten SCIM-Anwendung konfigurieren.

Dieser Artikel richtet sich an alle mit einer TeamViewer Tensor-Lizenz.

Voraussetzungen

Für die Nutzung der SCIM-Bereitstellung müssen die folgenden Voraussetzungen erfüllt sein:

Eine gültige TeamViewer Tensor-Lizenz.
TeamViewer Single Sign-On (SSO) wurde erfolgreich mit Okta konfiguriert.
Das Format für den Anwendungsbenutzernamen ist auf Email gesetzt, da TeamViewer die E-Mail-Adresse als SCIM-Attribut userName verwendet.
Admin-Zugriff auf TeamViewer und Okta.

Unterstützte Funktionen

TeamViewer unterstützt die folgenden SCIM 2.0-Bereitstellungsfunktionen:

Benutzer erstellen
Benutzerattribute aktualisieren
Benutzer deaktivieren
Passwörter synchronisieren
Benutzer importieren
Profilaktualisierungen importieren
Gruppen und Gruppenmitgliedschaften übertragen

Hinweis: Benutzer werden über SCIM niemals dauerhaft gelöscht. Wenn ein Benutzer entfernt oder die Zuweisung aufgehoben wird, deaktiviert TeamViewer das Konto, anstatt es zu löschen.

Die Okta Integration Network (OIN)-Anwendung enthält bereits einen vorkonfigurierten SCIM-Connector. Sie müssen lediglich ein API-Token bereitstellen und die Bereitstellungsfunktionen aktivieren.

Voraussetzungen

Stellen Sie Folgendes vor der Konfiguration der SCIM-Bereitstellung sicher:

Die TeamViewer Anwendung aus dem Okta Integration Network (OIN) wurde hinzugefügt.
Das SAML 2.0 SSO zwischen TeamViewer und Okta wurde konfiguriert.
Ein Skript-Token wurde in TeamViewer erstellt.

Konfiguration des SCIM-Endpoints

Die OIN-Anwendung enthält bereits die folgende Konfiguration:

Einstellung	Wert
SCIM-Konnektor-Basis-URL	https://webapi.teamviewer.com/scim/v2
Feld für eindeutige Kennung	Benutzername (E-Mail-Format)
Authentifizierung	HTTP-Header (Bearer-Token)

Schritt 1: Skript-Token erstellen

Melden Sie sich im TeamViewer Web Client oder Desktop Client in Ihrem TeamViewer Konto an.
Gehen Sie zu Einstellungen > Apps & Tokens.
Wählen Sie App oder Token erstellen aus.
Wählen Sie Skript-Token erstellen aus.

Geben Sie einen Namen und optional eine Beschreibung ein.
Wählen Sie die erforderlichen Token-Berechtigungen aus.

Token-Berechtigungen

Kategorie	Zu aktivierende Berechtigungen
Benutzerverwaltung	Benutzer erstellen, Benutzer bearbeiten, Benutzer anzeigen
Benutzerverwaltung (nur wenn auch Unternehmensadmins bereitgestellt werden)	Unternehmensadmins erstellen, Unternehmensadmins bearbeiten
Gruppenverwaltung (erforderlich für Gruppen-Push)	Gruppen erstellen, Gruppen bearbeiten, Gruppen löschen, Gruppen lesen

Klicken Sie auf Speichern.

Öffnen Sie das Token-Menü und wählen Sie Token kopieren aus. Dieser Wert wird in Schritt 2 in Okta eingefügt.

Schritt 2: API-Integration (Bereitstellung) in Okta aktivieren

Öffnen Sie die TeamViewer Anwendung in der Okta Admin Console.
Öffnen Sie den Tab Provisioning.
Klicken Sie auf Configure API Integration.

Aktivieren Sie API Integration.
Fügen Sie das in Schritt 1 erstellte Skript-Token in das Feld API Token ein
Aktivieren Sie optional Import Groups.
Klicken Sie auf Test API Credentials.
Klicken Sie auf Save.

Schritt 3: Bereitstellungsaktionen aktivieren

Öffnen Sie im Tab Provisioning den Abschnitt To App.
Klicken Sie auf Edit.
Aktivieren Sie:
1. Create Users
2. Set password when creating new users
3. Update User Attributes
4. Deactivate Users
Klicken Sie auf Save.

Optional:

Öffnen Sie den Tab Import.
Führen Sie einen Benutzerimport aus, um bestehende TeamViewer Benutzer zu synchronisieren.

Schritt 4: Customer Identifier festlegen

Öffnen Sie den Tab Provisioning.
Wechseln Sie zu TeamViewer Attribute Mappings.
Bearbeiten Sie TeamViewer SSO Customer Identifier (ssoCustomerId).
Wählen Sie Same value for all users aus.
Geben Sie Ihren SSO Customer Identifier ein.
Setzen Sie Apply on auf Create and update.
Klicken Sie auf Save.

Schritt 1: Skript-Token erstellen

Melden Sie sich im TeamViewer Web Client oder im Desktop-Client in Ihrem TeamViewer Konto an.
Gehen Sie zu Einstellungen > Apps & Tokens.
Wählen Sie App oder Token erstellen aus.
Wählen Sie Skript-Token erstellen aus.

Geben Sie einen Namen und optional eine Beschreibung ein.
Wählen Sie die erforderlichen Token-Berechtigungen aus.

Token-Berechtigungen

Kategorie	Zu aktivierende Berechtigungen
Benutzerverwaltung	Benutzer erstellen, Benutzer bearbeiten, Benutzer anzeigen
Benutzerverwaltung (nur wenn auch Unternehmensadmins bereitgestellt werden)	Unternehmensadmins erstellen, Unternehmensadmins bearbeiten
Gruppenverwaltung (erforderlich für Gruppen-Push)	Gruppen erstellen, Gruppen bearbeiten, Gruppen löschen, Gruppen lesen

Klicken Sie auf Speichern.

Öffnen Sie das Token-Menü und wählen Sie Token kopieren aus. Dieser Wert wird in Schritt 2 verwendet.

Schritt 2: SCIM-Bereitstellung aktivieren

1. Öffnen Sie Ihre OKTA-App.

2. Gehen Sie zum Tab General.

3. Wählen Sie Edit in den App-Einstellungen aus.

4. Wählen Sie Enable SCIM im Bereich Provisioning und klicken Sie anschließend auf Save.

5. Öffnen Sie den Tab Provisioning, wählen Sie Edit aus und tragen Sie die folgenden Werte ein:

Felder	Einzugebende Informationen
SCIM connector base URL	https://webapi.teamviewer.com/scim/v2
Unique identifier field for users	userName

6. Wählen Sie Push New Users, Push Profile Updates und Push Groups aus.

7. Ändern Sie den Authentication Mode zu HTTP Header.

8. Geben Sie Ihr zuvor erstelltes Skript-Token neben Authorization ein

9. Klicken Sie auf Test Connector Configuration und anschließend auf Save.

Ihre abgeschlossene Konfiguration sollte wie folgt aussehen:

10. Bearbeiten Sie Ihre Bereitstellungseinstellungen erneut und aktivieren Sie Create Users, Update User Attributes, Deactivate Users und Sync Password. Klicken Sie anschließend auf Save.

Schritt 3: Bereitstellungsaktionen aktivieren

Öffnen Sie den Tab Provisioning.
Klicken Sie unter To App auf Edit.
Aktivieren Sie:
1. Create Users
2. Update User Attributes
3. Deactivate Users
4. Sync Password
Klicken Sie auf Save.

Optional: Aktivieren Sie unter To Okta Folgendes:

Import New Users
Import Profile Updates

Schritt 4: SCIM-Attribut Customer Identifier hinzufügen

Nach Ausführung der oben genannten Schritte müssen die SCIM-Parameter angepasst werden, um den Customer Identifier einzubeziehen.

1. Gehen Sie zu Applications.

2. Öffnen Sie die entsprechende App.

3. Wechseln Sie zum Tab Provisioning und scrollen Sie zu Attribute Mapping.

4. Klicken Sie auf Go to Profile Editor.

5. Klicken Sie auf + Add Attribute.

6. Konfigurieren Sie die folgenden Werte. External name und External Namespace dürfen nicht geändert werden:

Felder	Einzugebende Informationen
Display name	ssoCustomerId
Variable name	ssoCustomerId
External name	ssoCustomerId
External Namespace	urn:ietf:params:scim:schemas:extension:teamviewer:1.0:SsoUser
Attribute length	Größer als 0
Attribute required	Ja
Attribute type	Persönlich
User permission (Nicht verpflichtend, aber empfohlen)	Ausblenden

7. Öffnen Sie Mappings für diese Anwendung.

8. Wechseln Sie zu Okta User to App.

9. Hinterlegen Sie den auch für SSO verwendeten Customer Identifier als statischen Wert.

10. Wenden Sie die Änderungen sofort an.

11. Öffnen Sie unter der betreffenden Anwendung Provisioning. Das neu erstellte Attribut sollte nun sichtbar sein

12. Bearbeiten Sie das Attribut so, dass der Wert nur bei Create angewendet wird.

Neu bereitgestellte Benutzer sollten sich anschließend direkt mit ihrem Okta-Konto anmelden können.

Gruppen-Push

Mit Gruppen-Push können Admins Okta-Gruppen mit TeamViewer Gruppen synchronisieren.

Funktionsweise

Öffnen Sie die TeamViewer Anwendung in Okta.
Gehen Sie zu Push Groups.
Klicken Sie auf Push Groups.
Wählen Sie die Gruppen aus, die Sie synchronisieren möchten.
Schließen Sie die Gruppen-Push-Konfiguration ab.

Unterstützte Aktionen:

Gruppen erstellen
Gruppen umbenennen
Mitgliedschaften aktualisieren
Gruppen löschen

Troubleshooting bei Gruppen-Push

Benutzer müssen der TeamViewer Anwendung zugewiesen sein, bevor Gruppenmitgliedschaften synchronisiert werden können.
Stellen Sie Benutzer vor oder gleichzeitig mit der Gruppensynchronisierung bereit.
Beim Löschen einer synchronisierten Gruppe wird nur die Gruppe entfernt, Benutzer werden dabei nicht deaktiviert.

Bekannte Einschränkungen

E-Mail-Adressen müssen über alle TeamViewer Konten hinweg eindeutig sein.
Die Bereitstellung kann fehlschlagen, wenn die E-Mail-Adresse bereits in einem anderen TeamViewer Konto verwendet wird.
Benutzer werden deaktiviert, nicht gelöscht.
Die erneute Bereitstellung eines zuvor deaktivierten Benutzers kann fehlschlagen, da das zugrunde liegende Konto weiterhin existiert.

Support kontaktieren

Wenn Probleme mit der SCIM-Bereitstellung auftreten, wenden Sie sich an den TeamViewer Kundensupport.

TeamViewer Remote

TeamViewer Tensor

TeamViewer DEX

TeamViewer Frontline

TeamViewer ONE Plattform

Knowledge Base

Okta-Integration – SCIM-Konfiguration

Voraussetzungen

Unterstützte Funktionen

Voraussetzungen

Konfiguration des SCIM-Endpoints

Token-Berechtigungen

Token-Berechtigungen

Gruppen-Push

Funktionsweise

Troubleshooting bei Gruppen-Push

Bekannte Einschränkungen

Support kontaktieren