Base de connaissance

Retour à l’aperçu du support

Apprenez comment ajouter des utilisateurs à la liste d’exclusion de l’authentification unique de TeamViewer (SSO). Vous pouvez exclure des adresses e-mail individuelles ou des groupes d’utilisateurs, ou importer plusieurs utilisateurs depuis un fichier CSV.

Pour les importations CSV, le script fourni, Add-SsoExclusionsFromCSV.ps1, simplifie les importations basées sur CSV et vous aide à gérer efficacement les exclusions SSO.

Cet article s’adresse aux détenteurs de licences TeamViewer Tensor.

Comment configurer la liste d’exclusion pour SSO

Pour créer la liste d’exclusion pour SSO, veuillez suivre les instructions ci-dessous :

  1. Identifiez-vous à votre compte TeamViewer dans le TeamViewer full client ou depuis l’application web puis accédez aux Paramètres d’administration.
  2. Dans la section Authentification, cliquez sur Authentification unique.
  3. Sélectionnez votre domaine, puis cliquez sur Éditer.
  4. Cliquez sur l’icône du cadenas appelée Exclusions et inclusions, puis cliquez sur la liste des exclusions.
  5. Définissez la liste d’exclusions en ajoutant les adresses e-mail ou groupes d’utilisateurs pour lesquels vous souhaitez désactiver le SSO.
  6. Cliquez sur Enregistrer pour appliquer la liste d’exclusions.

 

Prérequis

Avant de commencer, assurez-vous d’avoir installé le module TeamViewerPS  PowerShell.

Ce script repose sur le module TeamViewerPS PowerShell. Si vous ne l’avez pas encore installé, vous pouvez le faire en utilisant la commande suivante :

Install-Module TeamViewerPS

Ajouter des utilisateurs à partir d’un fichier CSV

Maintenant que vous avez installé le module TeamViewerPS PowerShell, vous pouvez procéder à l’ajout d’utilisateurs à partir d’un fichier CSV à la liste d’exclusions SSO de TeamViewer :

  1. Préparez votre fichier CSV : Créez un fichier CSV contenant la liste des utilisateurs que vous souhaitez exclure. Assurez-vous que le fichier CSV comporte une colonne avec l’en-tête « Email » (ou selon vos besoins), contenant les adresses e-mail des utilisateurs que vous souhaitez exclure.
  2. Exécutez le script : Ouvrez votre console PowerShell puis naviguez jusqu’au répertoire où se trouve le Add-SsoExclusionsFromCSV.ps1 script. Utilisez la commande suivante pour importer des utilisateurs depuis le fichier CSV :
.\Add-SsoExclusionsFromCSV -Path 'c:\Example.csv' -HeaderName 'Email'

Remplacez 'c:\Example.csv' par le chemin réel vers votre fichier CSV s’il se trouve dans un autre répertoire.

Cette commande lira le fichier CSV et ajoutera les utilisateurs spécifiés à la liste d’exclusions SSO de TeamViewer.

Utilisation d’un jeton API (facultatif)

Si vous souhaitez utiliser un jeton API pour l’authentification, vous pouvez le fournir comme suit :

Générer un jeton API : Créez un jeton API sécurisé, puis convertissez-le en chaîne sécurisée. Par exemple :

$apiToken = 'SecretToken123' | ConvertTo-SecureString -AsPlainText -Force

Exécuter le script avec l'API Token : Exécutez le script avec le -ApiToken paramètre :

.\Add-SsoExclusionsFromCSV -Path 'c:\Example.csv' -HeaderName 'Email' -ApiToken $apiToken

Cela garantira que le script utilisera le jeton API fourni pour l’authentification.

Tester en « mode test »

Vous pouvez lancer le script d’importation en « Mode Test » pour prévisualiser les modifications qui seraient effectuées sans les appliquer réellement. Cela est utile pour s’assurer que les paramètres du fichier CSV et du script sont correctement définis :

.\Add-SsoExclusionsFromCSV -Path 'c:\Example.csv' -HeaderName 'Email' -WhatIf

Cette commande affichera une simulation des changements sans effectuer de modifications réelles.

Aide complémentaire

Si vous avez besoin d’informations supplémentaires sur le script et ses paramètres, vous pouvez utiliser le Get-Help PowerShell cmdlet :

Get-Help -Detailed .\Add-SsoExclusionsFromCSV.ps1

Cette commande fournira des informations détaillées sur l’utilisation du script et ses paramètres disponibles.

En suivant ces instructions, vous pouvez facilement ajouter des utilisateurs à la liste d’exclusion SSO de TeamViewer via l’importation CSV, ce qui vous aide à gérer l’accès des utilisateurs plus efficacement.