Base de Conhecimento

Logon único (SSO) para Okta

Last Modified 16 de out. de 2026

O logon único/Single Sign-On (SSO) do TeamViewer conecta o TeamViewer ao Okta, permitindo que os usuários se autentiquem por meio do provedor de identidade da sua organização. Você pode configurar o SSO adicionando o aplicativo TeamViewer pré-criado da Okta Integration Network (OIN) ou criando um aplicativo personalizado de SAML 2.0 no Okta. Este artigo explica ambos os métodos de configuração e como verificar seu domínio.

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

Requisitos

Para configurar o SSO do TeamViewer com o Okta, você precisa de:

Uma licença TeamViewer Tensor
Um módulo do TeamViewer versão 13.2.1080 ou mais recente nos dispositivos que usam SSO
Uma conta TeamViewer com direitos de administrador da empresa
Acesso ao aplicativo web do TeamViewer ou ao cliente instalado
Acesso ao gerenciamento de DNS do domínio que você deseja habilitar para SSO
Um ambiente Okta

Versões anteriores do TeamViewer não podem redirecionar os usuários para o provedor de identidade durante o login

Como configurar o logon único com o Okta

Escolha o método de configuração que corresponde à sua configuração do Okta.

Use este método para adicionar o aplicativo TeamViewer pré-criado do catálogo da Okta Integration Network. O aplicativo já contém a configuração do provedor de serviços TeamViewer e as instruções de atributos SAML.

Recursos compatíveis

O aplicativo TeamViewer na Okta Integration Network (OIN) oferece suporte aos seguintes recursos do SAML 2.0:

SSO iniciado pelo provedor de serviços (SP): Os usuários iniciam o processo de login no cliente TeamViewer ou no aplicativo web do TeamViewer e são redirecionados para a Okta para autenticação.
SSO iniciado pelo provedor de identidade (IdP): Os usuários podem iniciar o processo de login diretamente no painel da Okta.
Assinatura SHA-256: As mensagens SAML são assinadas com SHA-256.

Para obter mais informações sobre os recursos listados, consulte o glossário da Okta na Central de Ajuda da Okta.

Observação: SAML SSO e provisionamento SCIM são recursos independentes. Você pode configurar e usar o SAML SSO sem o provisionamento SCIM. Se também quiser automatizar o gerenciamento do ciclo de vida de usuários e grupos, configure o provisionamento SCIM separadamente. Para obter mais informações, consulte o guia de configuração do SCIM.

Etapas de configuração

O SSO do TeamViewer é configurado em dois lados:

No Okta, você adiciona o aplicativo TeamViewer OIN e insere seu Identificador do Cliente do TeamViewer.
No web client ou no client instalado, você adiciona seu domínio, cola a URL de metadados da Okta e gera o Identificador do Cliente.

1º Passo: Adicione o aplicativo TeamViewer do catálogo OIN

No Console de Administração do Okta, abra Aplicações e Recursos e selecione Aplicações.
Selecione Navegue pelo catálogo de aplicações.

Pesquise por TeamViewer e selecione-o nos resultados.
Selecione Adicionar integração.

Na aba Configurações Gerais, edite o Aplicativo se necessário.
Selecione Avançar.

O aplicativo OIN do TeamViewer é pré-configurado com os valores corretos do Provedor de Serviços e instruções de atributos, portanto você não precisa inseri-los manualmente. Para referência, os valores são:

Configuração	Valor
URL de início de sessão único (URL ACS)	https://sso.teamviewer.com/saml/acs
Audiência URI (ID da Entidade SP)	https://sso.teamviewer.com/saml/metadata
Formato do ID do nome	Endereço de e-mail

Observação: Deve definir o formato do nome de utilizador da aplicação para E-mail mais tarde na configuração.

2º Passo: Copie a URL de metadados do Okta

Abra a guia Sign-On Options.
Role até Metadata details.
Copie a Metadata URL.

3º Passo: Adicione o seu domínio e gere o Identificador do Cliente

Siga estes passos.

Inicie sessão no web client ou no client instalado.
Abra as definições de administrador.
Selecione Logon único.
Selecione Adicionar domínio.

Digite o domínio que você deseja habilitar para SSO.
Deixe Configuration definido como Metadata URL (o padrão),
Cole a URL dos metadados que você copiou do Okta (2º Passo).
O TeamViewer baixa os metadados e preenche automaticamente a URL de login, o ID da entidade e a chave pública. Configure as Options disponíveis conforme necessário e selecione Continue.

Em Configure o acesso SSO, selecione uma lista de exclusão ou lista de inclusão.
Adicione os usuários ou grupos necessários e selecione Continuar.

Na tela Identificador Personalizado, selecione Generate ou insira sua própria sequência.
Copie o Identificador do Cliente e armazene-o com segurança para a configuração restante.
Selecione Continuar.

Importante: Não altere o Identificador do Cliente após a configuração. Alterá-lo interrompe o SSO. O TeamViewer não armazena esse valor.

4º Passo: Verifique a propriedade do domínio

O SSO permanece inativo até você verificar a propriedade do domínio.

Na tela Verificação de domínio, crie um novo registro TXT para o seu domínio usando o Nome/Host e o Valor/Dados exibidos.

Inicie sessão no seu fornecedor de DNS (o seu registrador de domínio ou anfitrião de DNS; por exemplo, GoDaddy, Cloudflare, Namecheap ou AWS Route 53) num separador do navegador à parte.
Adicione um novo registo DNS com:

Tipo: TXT
Nome / Host: o valor apresentado no TeamViewer (introduza @ se o seu fornecedor o exigir para o domínio raiz)
Valor / Dados TXT: o valor apresentado no TeamViewer
TTL: deixe o valor predefinido (por exemplo, 1 hora)

Guarde o registo. As designações exatas dos campos variam consoante o fornecedor, mas todos os fornecedores têm uma página de gestão de DNS equivalente para adicionar um registo TXT.

Clique em Iniciar verificação. O estado muda para Verificação em curso; clique em Terminar.

Observação: A propagação do DNS pode demorar várias horas. O TeamViewer procura o registo TXT durante 24 horas após iniciar a verificação. Se o registo não for encontrado nesse período, a verificação falha e tem de a reiniciar no painel de edição do domínio.

5º Passo: Adicione o atributo Identificador do Cliente no Okta

Retorne ao seu aplicativo SAML personalizado no Okta.
Abra a guia General.
Edite as configurações de SAML.
Selecione Próximo para abrir Declarações de Atributos.

6º Passo: Atribua usuários e testar o início de sessão

Abra o aplicativo TeamViewer no Okta.
Abra Atribuições.
Atribua os usuários ou grupos que precisam de acesso.
Peça a um usuário atribuído para iniciar sessão e verificar a configuração.

Atributos da asserção SAML

O TeamViewer lê o NameID do SAML como o endereço de e-mail do utilizador e usa-o para procurar a conta. A aplicação OIN envia automaticamente as seguintes instruções de atributos (utilizando o Identificador do Cliente que introduziu no Passo 5):

Atributo	Valor	Usado para
NameID (formato EmailAddress)	user.email	Identifica o usuário por e-mail
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress	user.email	E-mail do usuário
http://sso.teamviewer.com/saml/claims/customeridentifier	Identificador do Cliente	Vincula a declaração à sua empresa TeamViewer

O NameID deve conter um endereço de e-mail válido que corresponda à conta TeamViewer do utilizador. Os utilizadores na lista de exclusão de SSO continuam a iniciar sessão com a respetiva palavra-passe do TeamViewer.

Use este método quando quiser criar e configurar um aplicativo SAML 2.0 personalizado no Okta, em vez de usar o aplicativo de catálogo pré-criado (OIN).

1º Passo: Criar o aplicativo SAML do Okta

No Console de Administração do Okta, abra Applications e selecione Applications.
Selecione Create App Integration.

Selecione SAML 2.0.
Selecione Seguinte.

Criar uma nova integração de aplicativo SAML

Introduza um nome para a aplicação.
Selecione Seguinte.
Na página Definições de SAML, introduza os valores da tabela seguinte.

Campos	Informações a inserir
URL de início de sessão único	https://sso.teamviewer.com/saml/acs (Observação: Deixe a caixa Use isto para a URL do destinatário e a URL de destino assinalada.)
URI de Audiência (ID da Entidade SP)	https://sso.teamviewer.com/saml/metadata
Formato do ID do nome:	Endereço de e-mail
Nome de usuário da aplicação	E-mail

Selecione Mostrar configurações avançadas.
Defina Criptografia de Asserção como Criptografada.

Carregue a chave pública do TeamViewer em Certificado de Criptografia no formato Base64.

Em Instruções de Atributo, adicione o seguinte atributo de e-mail.

Nome: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress

Formato do nome: Referência de URI

Valor: user.email

Selecione Avançar.
Selecione Sou um cliente da Okta adicionando um aplicativo interno.
Selecione Este é um aplicativo interno.
Selecione Concluir.

Como obter a chave pública do TeamViewer

Execute o seguinte comando do PowerShell para baixar os metadados SAML do TeamViewer, extrair a chave pública e salvá-la como um arquivo de certificado:

"-----BEGIN PUBLIC KEY-----`n"+ `
((Select-Xml `
-Content ((Invoke-WebRequest `
https://sso.teamviewer.com/saml/metadata.xml).Content) `
-xpath "//*[local-name()='X509Certificate']").Node[0].'#text') + `
"`n-----END PUBLIC KEY-----" `
| Out-File -FilePath "sso.teamviewer.com -saml.cer" -Encoding ascii

O arquivo resultante é chamado sso.teamviewer.com-saml.cer

Para exportar o certificado no formato X.509 codificado em Base64:

Abra sso.teamviewer.com-saml.cer.
Abra a guia Detalhes .
Selecione Copiar para Arquivo.
Selecione Avançar.
Selecione X.509 codificado em Base64.
Selecione Avançar.
Insira um nome de arquivo.
Selecione Avançar e, em seguida, selecione Concluir.

O certificado Base64 resultante deve ter esta aparência:

Certificado de Criptografia Visual Final

2º Passo: Copie o URL dos metadados do Okta

Abra a sua aplicação SAML personalizada no Okta.
Abra o separador Sign On.
Copie o URL dos metadados do fornecedor de identidade.

3º Passo: Adicione o seu domínio e gere o Identificador do Cliente

Siga estes passos:

Inicie sessão no web client ou no client instalado.
Abra as definições de administrador.
Selecione Início de sessão único.
Selecione Adicionar domínio.

Introduza o domínio que pretende ativar para SSO.
Deixe Configuration definido como Metadata URL (a predefinição),
Cole o URL de metadados que copiou do Okta (Passo 2).
O TeamViewer transfere os metadados e preenche automaticamente o URL de início de sessão, o ID da entidade e a chave pública. Configure as Options disponíveis conforme necessário e selecione Continue.

Em Configurar acesso SSO, selecione uma Lista de exclusão ou Lista de inclusão.
Adicione os utilizadores ou grupos necessários e selecione Continuar.

Na tela Identificador personalizado, selecione Gerar ou insira sua própria sequência.
Copie o Identificador do Cliente e armazene-o com segurança para a configuração restante.
Selecione Continuar.

Importante: Não altere o Identificador do Cliente após a configuração. Alterá-lo interrompe o SSO. O TeamViewer não armazena esse valor.

4º Passo: Verificar a propriedade do domínio

O SSO permanece inativo até verificar a propriedade do domínio.

No ecrã Verificação de domínio, crie um novo registo TXT para o seu domínio utilizando o Nome/Host e o Valor/Dados apresentados.

Inicie sessão no seu fornecedor de DNS (o registrador do seu domínio ou anfitrião de DNS; por exemplo, GoDaddy, Cloudflare, Namecheap ou AWS Route 53) num separador do navegador separado.
Adicione um novo registo DNS com:

Tipo: TXT
Nome / Host: o valor mostrado no TeamViewer (introduza @ se o seu fornecedor o exigir para o domínio raiz)
Valor / Dados TXT: o valor mostrado no TeamViewer
TTL: deixe o valor predefinido (por exemplo, 1 hora)

Guarde o registo. Os rótulos exatos dos campos variam consoante o fornecedor, mas todos os fornecedores têm uma página de gestão de DNS equivalente para adicionar um registo TXT.

Clique em Iniciar verificação. O estado muda para Verificação em curso; clique em Concluir.

Observação: a propagação de DNS pode levar várias horas. O TeamViewer procura o registro TXT por 24 horas após você iniciar a verificação. Se o registro não for encontrado nesse período, a verificação falhará e você deverá reiniciá-la no painel de edição do domínio.

5º Passo: Adicione o atributo de Identificador do Cliente no Okta

Retorne ao seu aplicativo SAML personalizado no Okta.
Abra a guia General.
Edite as configurações de SAML.
Selecione Próximo para abrir Declarações de Atributos.

Adicione o atributo de identificador do cliente:

Nome: http://sso.teamviewer.com/saml/claims/customeridentifier

Formato do nome: Não especificado

Valor: O identificador do cliente que você gerou no TeamViewer

Selecione Avançar.
Selecione Concluir.

8. Copie este Token e volte para seu aplicativo Okta.

Configuração do client TeamViewer

O TeamViewer usa um navegador incorporado para autenticação do provedor de identidade por padrão. Em vez disso, você pode configurar o TeamViewer para usar o navegador padrão do sistema operacional.

Windows

Defina o seguinte valor do registro:

HKEY_CURRENT_USER\Software\TeamViewer\SsoUseEmbeddedBrowser = 0

macOS

Execute o seguinte comando:

defaults write com.teamviewer.teamviewer.preferences SsoUseEmbeddedBrowser -int 0

Solução de problemas

As informações de solução de problemas a seguir vêm da página de origem do OIN. A página de origem SAML personalizada não contém uma seção equivalente de solução de problemas. Este conteúdo precisa de revisão técnica antes de se tornar uma seção comum para ambos os métodos.

Problema	Verificação sugerida
O SSO não está ativado	Confirme que a verificação do domínio do registro TXT foi concluída com sucesso
Resposta SAML inválida é exibida	Confirme que o TeamViewer conseguiu recuperar e importar o URL de metadados do Okta
Um usuário não é reconhecido após a autenticação do Okta	Confirme que o NameID do SAML contém o endereço de e-mail associado à conta TeamViewer do usuário
O SSO parou de funcionar	Confirme que o Identificador do Cliente não foi alterado
Uma asserção expirou	Confirme que os relógios do sistema relevantes estão sincronizados

A fonte OIN também sugere adicionar novamente o domínio para atualizar os metadados após uma rotação do certificado de assinatura do Okta.

Contactar o suporte

Se precisar de ajuda com a configuração, contacte o Suporte ao Cliente da TeamViewer Customer Support.

TeamViewer Remote

TeamViewer Tensor

TeamViewer DEX

TeamViewer Frontline

Plataforma TeamViewer ONE