Base de Conhecimento

Integração com Okta - Configuração do SCIM

Last Modified 10 de set. de 2025

Sincronize usuários e grupos do Okta com o TeamViewer usando SCIM (System for Cross-domain Identity Management). O SCIM ajuda os administradores a criar, atualizar, desativar e gerenciar usuários automaticamente no TeamViewer diretamente pelo Okta. Este artigo explica como configurar o provisionamento SCIM usando o aplicativo TeamViewer da Okta Integration Network (OIN) ou um aplicativo SCIM personalizado.

Este artigo se aplica a todos os titulares de licença TeamViewer Tensor.

Requisitos

Para usar o provisionamento SCIM, você deve atender aos seguintes requisitos:
Uma licença TeamViewer Tensor válida
Single Sign-On (SSO) do TeamViewer configurado com sucesso com o Okta
O formato de nome de usuário do aplicativo está configurado como Email, pois o TeamViewer usa o endereço de e-mail como o atributo SCIM userName
Acesso de administrador ao TeamViewer e ao Okta

Recursos compatíveis

O TeamViewer oferece suporte aos seguintes recursos de provisionamento SCIM 2.0:

Criar usuários
Atualizar atributos do usuário
Desativar usuários
Sincronizar senhas
Importar usuários
Importar atualizações de perfil
Enviar grupos e associações de grupo

Observação: Os usuários nunca são excluídos permanentemente por meio do SCIM. Quando um usuário é removido ou tem sua atribuição cancelada, o TeamViewer desativa a conta em vez de excluí-la.

Etapa 2 – Habilitando o provisionamento SCIM

1. Abra o seu aplicativo OKTA.

2. Vá para a aba Geral.

3. Clique em Editar as configurações do aplicativo.

4. Ative o SCIM junto à secção Provisioning e, em seguida, clique em Save.

5. No separador Provisioning, selecione Edit e introduza as seguintes informações nos campos:

Campos	Informações a serem inseridas
URL base do conector SCIM	https://webapi.teamviewer.com/scim/v2
Campo de identificador exclusivo para usuários	nome do usuário

6. Selecione Push New Users, Push Profile Updates e Push Groups.

7. Altere Authentication Mode para HTTP Header.

8. Insira o seu token SCRIPT que criou acima na consola de gestão do TeamViewer junto de Authorization.

9. Quando terminar, pode clicar em Test Connector Configuration e, em seguida, clicar em Save.

A sua configuração concluída deverá ser semelhante a esta:

10. Edite seu Provisioning novamente e marque as caixas de seleção Create Users, Update User Attributes, Deactivate Users e Sync Password; em seguida, clique em Save.

Passo 4: Adicione o atributo SCIM do identificador do cliente

Após seguir as etapas acima, os parâmetros SCIM devem ser adaptados para incluir o identificador do cliente.

1. Vá para Applications.

2. Abra o aplicativo apropriado.

3. Mude para a guia Provisioning e role para baixo até Attribute Mapping.

4. Pressione Go to Profile Editor.

5. Clique em + Adicionar Atributo.

6. Defina as seguintes variáveis em que o nome externo e o namespace externo não devem ser alterados:

Campos	Informações a serem inseridas
Nome de exibição	ssoCustomerId
Nome da variável	ssoCustomerId
Nome externo	ssoCustomerId
Namespace externo	urn:ietf:params:scim:schemas:extension:teamviewer:1.0:SsoUser
Comprimento do atributo	Maior que 0
Atributo obrigatório	Sim
Tipo de atributo	Pessoal
Permissão do usuário (Não obrigatório, mas recomendado)	Esconder

7. Abra Mappings para essa aplicação.

8. Mude para Okta User to App.

9. Defina o identificador do cliente, também usado para SSO, como um valor estático.

10. Aplique as atualizações agora.

11. Na Aplicação indicada, clique em Provisioning, e o atributo recém-criado deverá estar visível.

12. Edite o atributo para aplicar o valor apenas em Create.

Os usuários recém-provisionados agora devem poder fazer login diretamente por meio de sua conta Okta.

TeamViewer Remote

TeamViewer Tensor

TeamViewer DEX

TeamViewer Frontline