Base de connaissance

Retour à la vue d’ensemble de l’assistance

Intégration Okta - Configuration SCIM

Date de dernière modification: 10 sept. 2025

Synchronisez les utilisateurs et les groupes d’Okta vers TeamViewer avec SCIM (System for Cross-domain Identity Management). SCIM aide les administrateurs à créer, mettre à jour, désactiver et gérer automatiquement les utilisateurs dans TeamViewer directement depuis Okta. Cet article explique comment configurer l’approvisionnement SCIM en utilisant soit l’application TeamViewer d'Okta Integration Network (OIN), soit une application SCIM personnalisée.

Cet article s’applique à tous les détenteurs d’une licence TeamViewer Tensor.

Exigences

Pour utiliser l’approvisionnement SCIM, vous devez remplir les conditions suivantes :

Une licence TeamViewer Tensor valide
L'authentification unique (Single Sign-On / SSO) TeamViewer configuré avec succès avec Okta
Le format du nom d’utilisateur de l’application configuré sur Email, car TeamViewer utilise l’adresse e-mail comme attribut SCIM userName
Accès administrateur à TeamViewer et à Okta

Fonctionnalités prises en charge

TeamViewer prend en charge les fonctionnalités d’approvisionnement SCIM 2.0 suivantes :

Créer des utilisateurs
Mettre à jour les attributs utilisateur
Désactiver des utilisateurs
Synchroniser les mots de passe
Importer des utilisateurs
Importer les mises à jour de profil
Transmettre les groupes et les appartenances aux groupes

Note : Les utilisateurs ne sont jamais supprimés définitivement via SCIM. Lorsqu’un utilisateur est supprimé ou désattribué, TeamViewer désactive le compte au lieu de le supprimer.

L’application Okta Integration Network (OIN) inclut un connecteur SCIM préconfiguré. Il vous suffit de fournir un jeton d’API et d’activer les fonctionnalités de provisionnement.

Prérequis

Avant de configurer le provisionnement SCIM, veillez à :

Ajouter l’application TeamViewer depuis l’Okta Integration Network (OIN)
Terminer la configuration de l’authentification unique SAML 2.0 entre TeamViewer et Okta
Générer un jeton de script dans TeamViewer

Configuration du point de terminaison SCIM

L’application OIN inclut déjà la configuration suivante :

Paramètre	Valeur
URL de base du connecteur SCIM	https://webapi.teamviewer.com/scim/v2
Champ d’identifiant unique	userName (format e-mail)
Authentification	HTTP Header (Bearer Token)

Étape 1 : Créer un jeton de script

Identifiez-vous au client web TeamViewer ou au full client.
Accédez à Settings (Paramètres) ➜ Apps & Tokens (Applications et jetons).
Sélectionnez Create app or token (Créer une application ou un jeton).
Sélectionnez Create script token (Créer un jeton de script).

Saisissez un nom et une description (facultative).
Sélectionnez les autorisations de jeton requises.

Autorisations de jeton

Catégorie	Autorisations à activer
Gestion des utilisateurs	créer des utilisateurs, modifier des utilisateurs, afficher des utilisateurs
Gestion des utilisateurs (uniquement si vous approvisionnez également des administrateurs d’entreprise)	créer des administrateurs d’entreprise, modifier des administrateurs d’entreprise
Gestion des groupes (requise pour Group Push)	créer des groupes, modifier des groupes, supprimer des groupes, lire des groupes

Cliquez sur Save (Enregistrer).

Ouvrez le menu du jeton puis sélectionnez Copy token (Copier le jeton). Nous collerons cette valeur dans Okta à l’étape 2.

Étape 2
: Activer l’intégration API (provisionnement) dans Okta

Ouvrez l’application TeamViewer dans la console d’administration Okta.
Ouvrez l’onglet Provisioning (Provisionnement).
Cliquez sur Configure API Integration (Configurer l'intégration API).

Activez API Integration.
Collez le jeton de script (généré à l’étape 1) dans le champ API Token (Jeton API).
Activez éventuellement Import Groups (Importer les groupes).
Cliquez sur Test API Credentials (Tester les identifiants API).
Cliquez sur Save (Enregistrer).

Étape 3 : Activer les actions de provisionnement

Dans l’onglet Provisioning (Provisionnement), ouvrez To App (Aller à l'application).
Cliquez sur Edit (Éditer).
Activez :
1. Create Users (Créer des utilisateurs)
2. Set password when creating new users (Définir un mot de passe lors de la création de nouveaux utilisateurs)
3. Update User Attributes (Mettre à jour les attributs utilisateur)
4. Deactivate Users (Désactiver les utilisateurs)
Cliquez sur Save (Enregistrer).

Facultatif :

Ouvrez l’onglet Import (Importer).
Exécutez une importation d’utilisateurs pour synchroniser les utilisateurs TeamViewer existants.

Étape 4 : Définir l’Identifiant Client

Ouvrez l’onglet Provisioning (Provisionnement).
Accédez à TeamViewer Attribute Mappings (Mappages d'attributs TeamViewer).
Modifiez TeamViewer SSO Customer Identifier (ssoCustomerId) (Identifiant Client SSO TeamViewer).
Sélectionnez Same value for all users (Même valeur pour tous les utilisateurs).
Saisissez votre Identifiant Client SSO.
Définissez Apply on (Appliquer) sur Create and update (Créer et mettre à jour).
Cliquez sur Save (Enregistrer).

Étape 1 : Créer un jeton de script

Identifiez-vous au client web ou au full client TeamViewer.
Accédez à Settings (Paramètres) ➜ Apps & Tokens (Applications et jetons).
Sélectionnez Create app or token (Créer une application ou un jeton).
Sélectionnez Create script token (Créer un jeton de script).

Saisissez un nom et une description (facultative).
Sélectionnez les autorisations de jeton requises.

Autorisations du jeton

Catégorie	Autorisations à activer
Gestion des utilisateurs	créer des utilisateurs, modifier des utilisateurs, afficher des utilisateurs
Gestion des utilisateurs (uniquement si vous approvisionnez également des administrateurs d’entreprise)	créer des administrateurs d’entreprise, modifier des administrateurs d’entreprise
Gestion des groupes (requise pour Group Push)	créer des groupes, modifier des groupes, supprimer des groupes, lire des groupes

Cliquez sur Save (Enregistrer).

Ouvrez le menu du jeton et sélectionnez Copy token (Copier le jeton). Nous collerons cette valeur dans Okta à l’étape 2.

Étape 2 : Activer l’approvisionnement SCIM

1. Ouvrez votre application Okta.

2. Accédez à l’onglet General (Général).

3. Cliquez sur Edit (Éditer) pour les paramètres de l’application.

Modifier les paramètres de l’application

4. Activez SCIM à côté de la section Provisioning, puis cliquez sur Save (Enregistrer).

5. Dans l’onglet Provisioning (Provisionnement), sélectionnez Edit (Éditer), puis saisissez les informations suivantes dans les champs :

Champs	Informations à saisir
URL de base du connecteur SCIM	https://webapi.teamviewer.com/scim/v2
Champ d’identifiant unique pour les utilisateurs	userName

6. Sélectionnez Push New Users (Envoyer les nouveaux utilisateurs), Push Profile Updates (Envoyer les mises à jour de profile) et Push Groups (Envoyer les groupes).

7. Remplacez Authentication Mode par HTTP Header.

8. Saisissez votre jeton Script créé ci-dessus dans la console de gestion TeamViewer à côté de Authorization (Autorisation).

9. Une fois terminé, vous pouvez cliquer sur Test Connector Configuration (Configuration du connecteur de test), puis sur Save (Enregistrer).

Votre configuration finalisée devrait ressembler à ceci :

10. Éditez à nouveau votre provisionnement et cochez les cases Create Users (Créer des utilisateurs), Update User Attributes (Mettre à jour les attributs utilisateurs), Deactivate Users (Désactiver des utilisateurs) et Sync Password (Synchroniser le mot de passe), puis cliquez sur Save (Enregistrer).

Étape 3 : Activer les actions de provisionnement

Dans l’onglet Provisioning (Provisionnement), ouvrez To App (Aller à l'application).
Cliquez sur Edit (Éditer).
Activez :
1. Create Users (Créer des utilisateurs)
2. Update User Attributes (Mettre à jour les attributs utilisateur)
3. Deactivate Users (Désactiver les utilisateurs)
4. Sync Password (Synchroniser le mot de passe)
Cliquez sur Save (Enregistrer).

Facultatif :

Sous To Okta, activez :

Import New Users (Importer des nouveux utilisateurs)
Import Profile Updates (Importer les mises à jour de profil)

Étape 4
: Ajouter l’attribut SCIM d’identifiant client

Après avoir suivi les étapes ci-dessus, les paramètres SCIM doivent être adaptés pour inclure l’Identifiant Client.

1. Accédez à Applications.

2. Ouvrez l’application appropriée.

3. Passez à l’onglet Provisioning (Provisionnement), puis faites défiler jusqu’à Attribute Mapping (Mappage des attributs).

4. Cliquez sur Go to Profile Editor (Accéder à l'éditeur de profil).

5. Cliquez sur + Add Attribute (+ Ajouter un attribut).

6. Définissez les variables suivantes où le nom externe et l’espace de noms externe ne doivent pas être modifiés :

Champs	Informations à saisir
Nom d’affichage	ssoCustomerId
Nom de variable	ssoCustomerId
Nom externe	ssoCustomerId
Espace de noms externe	urn:ietf:params:scim:schemas:extension:teamviewer:1.0:SsoUser
Longueur de l’attribut	Greater than 0 (Supérieur à 0)
Attribut requis	Yes
Type d’attribut	Personal
Autorisation de l’utilisateur (Non obligatoire mais recommandé)	Hide (Masquer)

7. Ouvrez Mappings (Mappages) pour cette application.

8. Passez à Okta User to App.

9. Définissez l’Identifiant Client également utilisé pour le SSO comme une valeur statique.

10. Appliquez les mises à jour maintenant.

11. Sous l’application donnée, cliquez sur Provisioning (Provisionnement), et le nouvel attribut créé devrait être visible.

12. Éditez l’attribut puis sélectionnez Create (Créer) pour appliquer la valeur uniquement lors de la création.

Les utilisateurs nouvellement provisionnés devraient désormais pouvoir se connecter directement via leur compte Okta.

Synchronisation des groupes (Group push)

La synchronisation des groupes permet aux administrateurs de synchroniser les groupes Okta avec les groupes TeamViewer.

Fonctionnement

Ouvrez l’application TeamViewer dans Okta.
Accédez à Push Groups.
Cliquez sur Push Groups.
Sélectionnez les groupes que vous souhaitez synchroniser.
Terminez la configuration de la synchronisation.

Opérations prises en charge :

Créer des groupes
Renommer des groupes
Mettre à jour les appartenances
Supprimer des groupes

Résolution des problèmes de synchronisation des groupes

Les utilisateurs doivent être attribués à l’application TeamViewer avant que les appartenances aux groupes puissent être synchronisées.
Provisionnez les utilisateurs avant ou en même temps que la synchronisation des groupes.
La suppression d’un groupe synchronisé supprime uniquement le groupe et ne désactive pas les utilisateurs.

Limitations connues

Les adresses e-mail doivent être uniques dans tous les comptes TeamViewer.
Le provisionnement peut échouer si l’adresse e-mail existe déjà dans un autre compte TeamViewer.
Les utilisateurs sont désactivés, pas supprimés.
Le reprovisionnement d’un utilisateur précédemment désactivé peut échouer, car le compte sous-jacent existe toujours.

Assistance

Si vous rencontrez des problèmes avec le provisionnement SCIM, contactez l’assistance TeamViewer.

TeamViewer Remote

TeamViewer Tensor

TeamViewer DEX

TeamViewer Frontline

Plateforme TeamViewer ONE