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.

O aplicativo da Okta Integration Network (OIN) inclui um conector SCIM pré-configurado. Você só precisa fornecer um token de API e ativar os recursos de provisionamento.

Pré-requisitos

Antes de configurar o provisionamento SCIM:

Adicione o aplicativo TeamViewer da Okta Integration Network (OIN)
Conclua a configuração de SSO SAML 2.0 entre o TeamViewer e o Okta
Gere um token de script no TeamViewer

Configuração do endpoint SCIM

O aplicativo OIN já inclui a seguinte configuração:

Configuração	Valor
URL base do conector SCIM	https://webapi.teamviewer.com/scim/v2
Campo de identificador único	nomeDoUtilizador (formato de e-mail)
Autenticação	Cabeçalho HTTP (Bearer Token)

Passo 1: Criar um token de script

Inicie sessão na aplicação web ou no cliente de desktop do TeamViewer.
Aceda a Definições > Aplicações e tokens.
Selecione Criar aplicação ou token.
Selecione Criar token de script.

Introduza um nome e uma descrição opcional.
Selecione as permissões de token necessárias.

Permissões de token

Categoria	Permissões para ativar
Gerenciamento de usuários	criar usuários, editar usuários, visualizar usuários
Gestão de utilizadores (apenas se também aprovisionar administradores da empresa)	criar administradores da empresa, editar administradores da empresa
Gerenciamento de grupos (obrigatório para Group Push)	criar grupos, editar grupos, excluir grupos, ler grupos

Clique em Guardar.

Abra o menu do token e selecione Copiar token. Vamos colar esse valor no Okta na Etapa 2

Passo 2: Ativar a integração da API (provisionamento) no Okta

Abra a aplicação TeamViewer na Consola de Administração do Okta.
Abra o separador Provisioning .
Clique em Configure API Integration.

Ative a Integração de API.
Cole o token do script (gerado na etapa 1) no campo Token de API.
Opcionalmente, ative Importar Grupos.
Clique em Testar Credenciais da API.
Clique em Salvar.

Etapa 3: Ative as ações de provisionamento

Na guia Provisioning , abra To App.
Clique em Edit.
Ative:
1. Create Users
2. Set password when creating new users
3. Update User Attributes
4. Deactivate Users
Clique em Save.

Opcional:

Abra a guia Importar .
Execute uma importação de utilizadores para sincronizar os utilizadores existentes do TeamViewer.

Passo 4: Definir o Customer Identifier

Abra o separador Provisioning .
Vá para TeamViewer Attribute Mappings.
Edite TeamViewer SSO Customer Identifier (ssoCustomerId).
Selecione Same value for all users.
Introduza o seu SSO Customer Identifier.
Defina Apply on como Create and update.
Clique em Save.

Passo 1: Criar um token de script

Inicie sessão na aplicação web ou no cliente de desktop do TeamViewer.
Vá a Definições > Aplicações e Tokens.
Selecione Criar aplicação ou token.
Selecione Criar token de script.

Introduza um nome e uma descrição opcional.
Selecione as permissões de token necessárias.

Permissões de token

Categoria	Permissões a ativar
Gerenciamento de usuários	criar usuários, editar usuários, visualizar usuários
Gestão de utilizadores (apenas se também aprovisionar administradores da empresa)	criar administradores da empresa, editar administradores da empresa
Gerenciamento de grupos (obrigatório para Group Push)	criar grupos, editar grupos, excluir grupos, ler grupos

Clique em Salvar.

Abra o menu de token e selecione Copiar token. Vamos colar esse valor no Okta na Etapa 2

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 único para usuários	nomeDeUsuario

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.

Etapa 3: Ative as ações de provisionamento

Abra a guia Provisioning .
Em To App, clique em Edit.
Ative:
1. Create Users
2. Update User Attributes
3. Deactivate Users
4. Sync Password
Clique em Save.

Opcional:

Em To Okta, ative:

Import New Users
Import Profile Updates

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 utilizador (Não obrigatório, mas recomendado)	Ocultar

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.

Sincronização de grupos

A sincronização de grupos permite que os administradores sincronizem grupos do Okta com grupos do TeamViewer.

Como funciona

Abra o aplicativo TeamViewer no Okta.
Vá para Push Groups.
Clique em Push Groups.
Selecione os grupos que você deseja sincronizar.
Conclua a configuração da sincronização.

Operações compatíveis:

Criar grupos
Renomear grupos
Atualizar associações
Excluir grupos

Solução de problemas da sincronização de grupos

Os usuários devem ser atribuídos ao aplicativo TeamViewer antes que as associações aos grupos possam ser sincronizadas
Provisione os usuários antes ou ao mesmo tempo que a sincronização de grupos
A exclusão de um grupo sincronizado remove apenas o grupo e não desativa os usuários

Limitações conhecidas

Os endereços de e-mail devem ser únicos em todas as contas do TeamViewer
O provisionamento pode falhar se o endereço de e-mail já existir em outra conta do TeamViewer
Os usuários são desativados, não excluídos
O reprovisionamento de um usuário anteriormente desativado pode falhar porque a conta subjacente ainda existe

Suporte

Se você tiver problemas com o provisionamento SCIM, entre em contato com o Suporte do TeamViewer.

TeamViewer Remote

TeamViewer Tensor

TeamViewer DEX

TeamViewer Frontline

Plataforma TeamViewer ONE

Base de Conhecimento

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

Requisitos

Recursos compatíveis

Pré-requisitos

Configuração do endpoint SCIM

Permissões de token

Permissões de token

Sincronização de grupos

Como funciona

Solução de problemas da sincronização de grupos

Limitações conhecidas

Suporte