Aprenda a adicionar usuários à lista de exclusão do Logon único do TeamViewer Single Sign-On (SSO). Você pode excluir endereços de e-mail individuais ou grupos de usuários ou importar múltiplos usuários de um arquivo CSV.
Para importações de CSV, o script fornecido Add-SsoExclusionsFromCSV.ps1 simplifica as importações baseadas em CSV e ajuda a gerenciar as exclusões de SSO de forma eficiente.
Este artigo aplica-se a todos os clientes com licenças Tensor.
- Exclua via endereço de e-mail ou grupos de usuários
- Exclua via arquivo CSV
Como configurar a lista de exclusões para SSO
Para configurar a lista de exclusão do SSO, siga as instruções abaixo:
- Logue com a sua conta TeamViewer no TeamViewer full client ou no web app e vá até as Configurações de administração.
- Na seção Autenticação, clique em Logon único (SSO).
- Selecione seu domínio e clique em Editar.
- Clique no ícone do armário chamado Exclusões e inclusões, e clique na Lista de exclusões.
- Defina a lista de exclusão adicionando os endereços de e-mail ou grupos de usuários para os quais você deseja desativar o SSO.
- Clique em Salvar para aplicar a lista de exclusões.
Pré-requisitos
Antes de começar, certifique-se de ter instalado o módulo TeamViewerPS PowerShell.
Este script depende do módulo PowerShell TeamViewerPS. Se você ainda não instalou, pode fazer isso usando o seguinte comando:
Install-Module TeamViewerPS
Adicione usuários a partir de um arquivo CSV
Agora que você tem o módulo TeamViewerPS PowerShell instalado, pode seguir adicionando usuários de um arquivo CSV à lista de exclusão do SSO do TeamViewer:
1. Prepare seu arquivo CSV: Crie um arquivo CSV que contenha a lista de usuários que você deseja excluir. Certifique-se de que o arquivo CSV tenha uma coluna com o título de cabeçalho 'Email' (ou conforme sua necessidade) que contenha os endereços de e-mail dos usuários que você deseja excluir.
2. Execute o script: Abra seu console PowerShell e navegue até o diretório onde o Add-SsoExclusionsFromCSV.ps1 script está localizado. Use o seguinte comando para importar usuários do arquivo CSV:
.\Add-SsoExclusionsFromCSV -Path 'c:\Example.csv' -HeaderName 'Email'
Substitua 'c:\Example.csv' pelo caminho real para seu arquivo CSV se ele estiver localizado em um diretório diferente.
Esse comando lê o arquivo CSV e adiciona os usuários especificados à lista de exclusão do Logon único do TeamViewer.
Usando um Token API (Opcional)
Se você desejar usar um token API para autenticação, pode fornecê-lo da seguinte forma:
1. Gere um Token de API: Crie um token de API seguro e converta-o em uma string segura. Por exemplo:
$apiToken = 'SecretToken123' | ConvertTo-SecureString -AsPlainText -Force
2. Execute o script com o API Token: Execute o script com o -ApiToken parâmetro:
.\Add-SsoExclusionsFromCSV -Path 'c:\Example.csv' -HeaderName 'Email' -ApiToken $apiToken
Isso garantirá que o script use o token de API fornecido para autenticação.
Testes com o Modo Teste
Você pode rodar o script de importação no Modo Teste para pré-visualizar as mudanças que seriam feitas sem realmente aplicá-las. Isso é útil para garantir que os parâmetros do arquivo CSV e do script estejam definidos corretamente:
.\Add-SsoExclusionsFromCSV -Path 'c:\Example.csv' -HeaderName 'Email' -WhatIf
Esse comando exibe uma simulação das mudanças sem fazer nenhuma modificação real.
Mais ajuda
Se precisar de informações adicionais sobre o script e seus parâmetros, pode usar o Get-Help cmdlet do PowerShell:
Get-Help -Detailed .\Add-SsoExclusionsFromCSV.ps1
Esse comando fornecerá informações detalhadas sobre como usar o script e seus parâmetros disponíveis.
Seguindo essas instruções, você pode facilmente adicionar usuários à lista de exclusão do Logon único do TeamViewer via importação de CSV, ajudando a gerenciar o acesso dos usuários de forma mais eficiente.