> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/pt/area-do-administrador/account-and-endpoint-management/sso-field-guide.md).

# Guia de Campo SSO

## Introdução

Integrar o logon único (SSO) com o Zoom oferece aos administradores opções de Gerenciamento de usuário e segurança que podem simplificar o gerenciamento de conta. Uma vez configurado, os usuários autenticar usando as credenciais da sua empresa em seu provedor de identidade da empresa, em vez de usar métodos de autenticação alternativos como OAuth por meio de um aplicativo de terceiros ou um Nome de usuário e senha direto com o Zoom.

Este documento fornece uma visão geral abrangente das configurações de SSO e Configurações no Zoom, além de informações sobre solução de problemas e segurança.

## A configurar o SSO

#### <mark style="color:azul;">SSO requer uma URL intuitivo para começar</mark>

Uma conta deve ter uma URL intuitivo aprovada antes de configurar o SSO. Assim que a URL intuitivo for aprovada, os administradores do Zoom podem acessar a [Configuração de SSO](https://zoom.us/account/sso) navegue pelo submenu de opções avançadas no portal da web. Consulte nosso artigo de Suporte sobre [URLs personalizadas](https://support.zoom.us/hc/en-us/articles/215062646-Guidelines-for-Vanity-URL-requests) para mais informações.

#### <mark style="color:azul;">O SSO do Zoom funciona com qualquer provedor de identidade SAML 2.0 ou OIDC</mark>

O Zoom pode integrar-se a qualquer provedor de identidade compatível com Security Assertion Markup Language (SAML) 2.0 ou com autenticação OpenID Connect (OIDC).

#### <mark style="color:azul;">Os administradores do Zoom podem gerenciar informações de perfil de usuário e licenciamento por meio do mapeamento de resposta ou de integrações SCIM</mark>

Os administradores podem gerenciar informações de perfil de usuário e licenciamento por meio do mapeamento de resposta ou de solicitações da Interface de Programação de aplicativo (API) do Sistema de Gerenciamento de Identidade Entre Domínios (SCIM), dependendo dos recursos disponíveis do provedor de identidade. Ambos os métodos de gerenciamento de usuário oferecem funcionalidades quase equivalentes para o mapeamento de informações de perfil e o gerenciamento de licenciamento, mas alguns mapeamentos SCIM exigem configuração manual.

Para uma lista abrangente dos recursos do SCIM, consulte nossa [documentação da API do SCIM](https://developers.zoom.us/docs/api/?ampDeviceId=157cfe5d-7f7a-45eb-afb0-efde5a7d3feb\&ampSessionId=1778697171616).

#### <mark style="color:azul;">Os administradores do Zoom podem gerenciar o status da conta de usuário por meio do SCIM, mas não do SAML ou OIDC</mark>

Como o SCIM permite que provedores de identidade se comuniquem diretamente com o Zoom a qualquer momento, as contas de usuário podem ser *ativadas*, *desativadas*, *criadas*, ou *excluídas* automaticamente por meio de integrações SCIM. Por exemplo, se a conta de um usuário no Active Directory for desativada ou se ele perder a atribuição do aplicativo, o SCIM poderá enviar uma solicitação automática de desativação da conta do usuário no Zoom. Esse Recursos depende dos recursos do aplicativo SCIM do provedor de identidade, e a funcionalidade pode variar de acordo com o provedor.

#### <mark style="color:azul;">Poucos provedores de identidade oferecem SCIM para Zoom</mark>

Muitos provedores de identidade não têm Integrações SCIM criadas para o Zoom como parte de seus serviços. Contas que usam um provedor de identidade que não tem Suporte para SCIM com Zoom devem usar mapeamento de resposta para gerenciamento automatizado de usuário.

#### <mark style="color:azul;">O SCIM requer um domínio associado para aprovisionar utilizadores automaticamente</mark>

Contas que usam SCIM para gerir e provisionar utilizadores para SSO **deve** associe o domínio de e-mail ao Zoom. A falha em associar o domínio resultará em falhas no provisionamento de usuários. Consulte nosso artigo de suporte sobre [Domínios associados](https://support.zoom.us/hc/en-us/articles/203395207) para mais informações sobre o processo.

### Guia de Configuração SAML

Os links a seguir incluem guias para configurar o SSO com SAML.

{% hint style="success" %}
**Dica do Zoom**

Clique em ✔ na coluna Provedor ou Documentação do Zoom para abrir uma nova janela com as instruções.
{% endhint %}

<table><thead><tr><th width="211.5616455078125"></th><th align="center">Documentação do provedor</th><th align="center">Documentação do Zoom</th><th align="center">Suporta SCIM</th></tr></thead><tbody><tr><td>auth0</td><td align="center"><a href="https://marketplace.auth0.com/integrations/zoom-sso">✔</a></td><td align="center"><br></td><td align="center"><br></td></tr><tr><td>ADFS</td><td align="center"><br></td><td align="center"><a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0062700">✔</a></td><td align="center">ferramenta AD Sync</td></tr><tr><td>Esperto</td><td align="center"><a href="https://support.clever.com/hc/s/articles/360040481852">✔</a></td><td align="center"><br></td><td align="center"><br></td></tr><tr><td>CyberArk</td><td align="center"><a href="https://docs.cyberark.com/Product-Doc/OnlineHelp/Idaptive/Latest/en/Content/Applications/AppsWeb/Zoom.htm">✔</a></td><td align="center"><br></td><td align="center"><br></td></tr><tr><td>Duo</td><td align="center"><a href="https://duo.com/docs/sso-zoom">✔</a></td><td align="center"><br></td><td align="center"><br></td></tr><tr><td>Entra ID (anteriormente Azure)</td><td align="center"><a href="https://docs.microsoft.com/en-us/azure/active-directory/saas-apps/zoom-tutorial">✔</a></td><td align="center"><a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0064121">✔</a></td><td align="center">✔</td></tr><tr><td>Google</td><td align="center"><a href="https://support.google.com/a/answer/7577316?hl=en">✔</a></td><td align="center"><a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0066144">✔</a></td><td align="center"><br></td></tr><tr><td>JumpCloud</td><td align="center"><a href="https://support.jumpcloud.com/support/s/article/single-sign-on-sso-with-zoom1-2019-08-21-10-36-47">✔</a></td><td align="center"><br></td><td align="center">✔</td></tr><tr><td>miniOrange</td><td align="center"><a href="https://www.miniorange.com/iam/integrations/zoom-single-sign-on-sso">✔</a></td><td align="center"><br></td><td align="center"><br></td></tr><tr><td>Okta</td><td align="center"><a href="https://saml-doc.okta.com/SAML_Docs/How-to-Configure-SAML-2.0-for-Zoom.us.html">✔</a></td><td align="center"><a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0063256">✔</a></td><td align="center">✔</td></tr><tr><td>OneLogin</td><td align="center"><a href="https://onelogin.service-now.com/support?id=kb_article&#x26;sys_id=a10d1e2f87bf6850247f4156cebb35d5">✔</a></td><td align="center"></td><td align="center">✔</td></tr><tr><td>Ping Identity</td><td align="center"><a href="https://docs.pingidentity.com/integrations/zoom/setup/pf_zoom_connector_configuring_single_sign_on_in_zoom.html">✔</a></td><td align="center"><br></td><td align="center">✔</td></tr></tbody></table>

Se o provedor de identidade que a sua Corporativa utiliza não estiver listado acima, recomendamos pesquisar na base de conhecimento do provedor um guia de Integrações específico do Zoom. Se um não estiver Disponível, o SSO ainda pode ser configurado fazendo a correspondência de identificadores-chave do seu IdP na tela de configuração de SSO do Zoom. Consulte a Central de suporte do Zoom para obter mais informações sobre um [guia de início rápido do SSO](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060673) e quais informações são necessárias para concluir este processo.

### Guia de configuração de OIDC

Zoom oferece Suporte à descoberta OIDC, que pode preencher automaticamente detalhes comuns do provedor de identidade, como o emissor, os pontos de extremidade de autorização, os pontos de extremidade de token e as chaves de assinatura. Como o OIDC depende de valores de configuração padronizados, a documentação específica do Zoom do provedor geralmente não é necessária; quando a descoberta não estiver disponível, os valores necessários podem ser inseridos manualmente.

Como resultado, provedores de identidade OIDC compatíveis com os padrões geralmente podem ser configurados com o Zoom, mesmo quando um guia de Integrações específico do provedor não estiver disponível. Consulte a Central de suporte do Zoom para obter mais informações sobre [configurando o SSO OIDC](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0083701).

### Opções de configuração adicionais

#### <mark style="color:azul;">Zoom pode Suporte a vários Vanity URLs e/ou a vários aplicativos de provedor de identidade</mark>

Contas do Zoom podem oferecer Suporte a vários Vanity URLs, várias configurações de provedor de identidade (IdP) ou uma combinação de ambos. As configurações suportadas incluem:

* Vários Vanity URLs que compartilham uma configuração IdP comum.
* Vários URLs personalizados, cada um com uma configuração de IdP independente.
* Um único URL intuitivo associado a várias configurações de IdP.

Estas configurações são ativadas por meio do Suporte do Zoom e não são configuradas pela interface padrão de administração de SSO. Envie um [pedido de Suporte](https://support.zoom.com/hc/en/contact?id=contact_us) para Habilitar este Recursos, juntamente com a URL intuitivo desejada e a configuração do IdP e o resultado de autenticação pretendido.

{% hint style="info" %}
**Nota**

A autenticação OIDC não oferece suporte no momento a vários Vanity URLs ou IdPs. Se não tiver certeza de que essa situação se aplica a você, fale com sua equipe da conta Zoom para obter mais informações.
{% endhint %}

#### <mark style="color:azul;">O Active Directory local pode usar a ferramenta AD Sync em vez de SCIM</mark>

As contas que desejam automatizar o provisionamento de usuários por meio do SCIM, mas não têm um provedor de identidade baseado na nuvem, podem usar o aplicativo Ferramenta de Sincronizar do Active Directory (AD), desenvolvido pela Zoom para gerenciar seus usuários. Esse aplicativo é executado no Oracle JDK 8 e simula o provisionamento SCIM gerenciando usuários por meio de comandos da API. Consulte nosso artigo de Suporte sobre o [Ferramenta AD Sync](https://support.zoom.us/hc/en-us/articles/115005865543-Managing-the-AD-Sync-Tool) para mais informações.

{% hint style="success" %}
**Recomendação do Zoom**

A ferramenta AD Sync requer uma configuração precisa para o Gerenciamento de usuário. São necessários testes minuciosos e uma revisão da configuração da ferramenta antes da implementação completa para evitar interrupções no serviço.
{% endhint %}

#### <mark style="color:azul;">Provedores de identidade podem até autenticar participantes da reunião que não têm uma conta Zoom</mark>

Contas que desejam exigir que os usuários autentiquem sua identidade, mas não querem fornecer contas Zoom, podem Configurar um perfil de autenticação externa com seu provedor de identidade. Quando ativado para uma reunião, os usuários que tentarem entrar devem autenticar suas credenciais de login junto ao seu provedor de identidade para obter acesso. Essa é uma Configuração comum para escolas que não fornecem contas a todos os alunos, mas exigem autenticação para entrar nas aulas. Consulte nosso artigo de suporte sobre [configurando autenticação externa](https://support.zoom.us/hc/en-us/articles/360053351051-Configuring-external-authentication-for-K-12-schools) para mais informações.

#### <mark style="color:azul;">Alterar o provedor de identidade requer reconfigurar o SSO no Zoom</mark>

Contas que estão a Alterar de provedor de identidade devem refazer a sua configuração de SSO dentro do Zoom. Isso inclui atualizar todos os campos na página de configuração para corresponder ao seu novo provedor de identidade. As contas são encorajadas a confirmar que os mapeamentos de resposta não irão Alterar com o novo provedor de identidade.

Não devem ser necessárias configurações ou alterações adicionais, assumindo que não haja mais alterações.

#### <mark style="color:azul;">Clientes/clientes com subcontas podem Configurar SSO a partir da conta principal ou da subconta</mark>

Clientes/clientes com subcontas têm duas opções para configurar o SSO:

1. Todos os usuários usam a URL intuitivo da conta principal para autenticar-se e são automaticamente conectados à subconta por meio de mapeamento avançado de resposta ([algumas limitações de mapeamento aplicam-se](#mapping-users-to-a-sub-account-will-only-apply-a-meeting-license-and-add-ons))
2. Cada subconta tem um URL intuitivo único e uma configuração SSO independente, usada exclusivamente pelos membros dessa subconta

Cada configuração oferece benefícios únicos, sendo que a segunda opção oferece a maior flexibilidade. Clientes/clientes que considerem a implementação de qualquer uma das configurações devem discutir com a equipa da sua conta qual configuração é mais adequada às suas necessidades.

## Métodos de provisionamento

#### <mark style="color:azul;">Os modos de provisionamento e o SCIM são dois mecanismos diferentes, e podem ser usados em conjunto</mark>

Provisionamento *No momento do início de sessão* e *Antes do início de sessão* são os dois valores disponíveis de uma única definição de SSO. Eles determinam se o Zoom criará uma conta para um usuário no momento em que ele se autenticar, ou se exigirá que a conta já exista. O SCIM não é um terceiro valor dessa definição — é um mecanismo separado, baseado em API, que provisiona usuários independentemente da autenticação, e funciona em conjunto com o modo de provisionamento selecionado.

| Método de provisionamento                                                  | Como Funciona                                                                             | Pré-requisitos                                                                    | Cria contas                              | Desativa contas                          |
| -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ---------------------------------------- | ---------------------------------------- |
| <p><strong>No momento do início de sessão</strong><br>(Just-in-time)</p>   | Cria a conta quando o usuário se autentica pela primeira vez                              | Nenhum                                                                            | Sim                                      | Não                                      |
| <p><strong>Antes do início de sessão</strong><br>(Pré-provisionamento)</p> | Verifica se um usuário está autorizado a iniciar sessão via SSO                           | Uma conta com o tipo de login SSO. Frequentemente usada com provisionamento SCIM. | Não, mas é frequentemente usado com SCIM | Não, mas é frequentemente usado com SCIM |
| **SCIM**                                                                   | Sincroniza os dados do usuário do provedor de identidade em seu próprio Agendar, via APIs | Suporte SCIM do IdP e um domínio associado                                        | Sim                                      | Sim, se suportado pelo IdP               |

### No momento do início de sessão

#### <mark style="color:azul;">O provisionamento no login cria a conta e o tipo de login SSO em uma única etapa</mark>

Com a *No momento do início de sessão* configuração (também conhecida como provisionamento just-in-time), um usuário atribuído ao aplicativo Zoom dentro do provedor de identidade e que receba qualquer licença Zoom compatível terá uma conta criada para ele na primeira vez em que autenticar. Nada precisa existir no Zoom antes. Isso a torna a opção mais simples de implementar e o motivo pelo qual é recomendada ao configurar o SSO pela primeira vez em uma conta.

O provisionamento no login também é compatível com SCIM — os dois podem funcionar ao mesmo tempo. Na prática, porém, o SCIM geralmente elimina a necessidade dele, porque as contas já existem quando o usuário vai autenticar pela primeira vez.

### Antes do início de sessão

#### <mark style="color:azul;">O provisionamento antes do início de sessão depende de outra coisa ter criado primeiro a conta ou o tipo de login</mark>

O *Antes do início de sessão* a configuração (também conhecida como pré-provisionamento) não provisiona nada automaticamente. Em vez disso, ela impõe uma condição: um usuário pode autenticar apenas se sua conta Zoom já existir e tiver o tipo de login SSO. Portanto, outra coisa deve ser responsável por criar essas contas, e há duas opções práticas.

* **Provisionamento SCIM**, que cria contas automaticamente a partir do provedor de identidade à medida que os usuários são atribuídos ao aplicativo.
* **Upload em massa de CSV** com a *Usuário SSO* opção selecionada, que cria contas e aplica o tipo de login SSO em uma única importação.

É por isso que o pré-provisionamento e o SCIM são tão frequentemente usados em conjunto. O pré-provisionamento estabelece um requisito; o SCIM é o mecanismo que o satisfaz em escala.

Os administradores do Zoom podem confirmar se uma conta tem um tipo de login SSO ao visualizar a conta do usuário no [Gerenciamento de usuário](https://zoom.us/account/user#/) página no portal da web e procurando o ícone “SSO” abaixo do e-mail do usuário.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcreMLZApFm8ejVa0ka9Z8eqYuNxu79PNBLNRQMSXiYuhd7i_yVll8yuREcJto4NqP1PWcodZJcONRGl97_uQx7fIg7XIaESAtwqFmtg94DGrwzWgJJSPITSivg8XydSZEJPGMY7Q?key=ug1dFE_WGWGnyMfD5tJnNw" alt="A user profile showing an SSO login type" width="375"><figcaption><p>Localização do ícone SSO abaixo do e-mail de um usuário.</p></figcaption></figure></div>

Se o ícone estiver a apresentar, o usuário estará provisionado para SSO; se o ícone estiver ausente, o usuário não poderá iniciar sessão via SSO enquanto o pré-provisionamento estiver ativado, até que seja Adicionar. Um administrador do Zoom pode Adicionar este tipo de login Adicionar usuários em massa por meio de um arquivo CSV e selecionando a opção “Usuário SSO”, ou fazer com que o usuário se autenticar enquanto o Provisionamento no Iniciar sessão estiver ativado.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcoPrIr5MH76SjZUpz7giqvgeI20rLRN6ZRT__7ltUhhuaWNyH4nM0EePcE7V3aFx1tbMqPICLZ_9dHs7Gc3_tXWOGZ4KOKQzPCdb4meMTpRxcBvNOJ2QwQmAisWT-KtWUzl_B1gQ?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="375"><figcaption><p>Exemplo mostrando a opção Usuário SSO para carregamento em massa.</p></figcaption></figure></div>

### SCIM

#### <mark style="color:azul;">O SCIM provisiona usuários por meio de APIs e nunca declara valores de identidade como SAML ou OIDC</mark>

O SCIM difere do mapeamento de resposta de uma forma que vale a pena declarar claramente. O mapeamento de resposta — seja por meio de declarações SAML ou reivindicações OIDC — transporta informações do usuário *como parte de um Evento de autenticação*. Nada é aplicado até que o usuário inicie sessão, e as informações trafegam dentro da declaração.

O SCIM não transporta declarações nem reivindicações. O provedor de identidade chama a API do Zoom diretamente, de acordo com seu próprio Agendar, enviando informações do usuário independentemente de o usuário já ter iniciado sessão. É isso que permite ao SCIM criar, atualizar, desativar e excluir contas sem o envolvimento do usuário, e é por isso que o SCIM pode gerenciar o status da conta, enquanto o mapeamento de resposta não pode.

O SCIM é compatível com qualquer modo de provisionamento e é mais frequentemente implementado juntamente com o pré-provisionamento.

Consulte o [Guia de Campo SCIM para Entra ID e Okta](/technical-library/pt/area-do-administrador/account-and-endpoint-management/scim-guide.md) para mais informações sobre como Configurar o SCIM para a sua conta com o Entra ID ou o Okta.

{% hint style="success" %}
**Recomendação do Zoom**

Ao configurar o SSO e o SCIM em conjunto numa nova conta, Habilitar *Provisionamento no Início de Sessão* primeiro. Isso ajuda a garantir que os utilizadores possam autenticar enquanto a Integrações SCIM ainda está a ser validada. Assim que tiver confirmado que o SCIM está a criar contas com o tipo de início de sessão SSO aplicado, mude para *Antes do início de sessão* se se pretender um controlo mais rigoroso.
{% endhint %}

## Configurações de Segurança

#### <mark style="color:azul;">Os administradores do Zoom podem impor a saída automática após um período de tempo definido</mark>

Os administradores do Zoom podem Configurar o Zoom para encerrar automaticamente as sessões ativas dos utilizadores após períodos de tempo definidos, personalizáveis de 15 minutos a 180 dias. Este processo definirá o token de acesso do Zoom para expirar após o período predefinido assim que o token for gerado. Este token não tem qualquer relação com um fornecedor de identidade e é exclusivo do Zoom.

#### <mark style="color:azul;">Um domínio deve estar associado e gerenciado para impor autenticação SSO</mark>

Os administradores do Zoom podem impor autenticação SSO *somente* se o domínio de e-mail estiver associado e gerenciado no Zoom. Quando isso estiver ativado, todos os usuários que se autenticarem usando o(s) domínio(s) da sua empresa serão redirecionados automaticamente para a página de autenticação do seu provedor de identidade, independentemente da plataforma.

Depois que o domínio for aprovado e gerenciado, um administrador do Zoom pode impor autenticação SSO por meio da página de segurança da sua conta, [página de segurança](https://zoom.us/account/setting/security) em **Métodos de início de sessão**. Consulte nosso artigo de Suporte sobre [Domínios associados](https://support.zoom.us/hc/en-us/articles/203395207) para mais informações sobre como associar e gerenciar um domínio.

#### <mark style="color:azul;">Usuários especificados podem ser isentos da autenticação SSO imposta</mark>

Os administradores do Zoom podem excluir usuários específicos da autenticação SSO obrigatória. Excluir usuários específicos (como uma conta de administrador) pode ser útil se uma configuração de SSO falhar e um administrador da conta precisar de acesso sem SSO à conta Zoom. Os administradores isentos podem iniciar sessão em admin.zoom.us a qualquer momento no Evento de bloqueio da conta ou de falha na configuração de SSO (o usuário deve ter o padrão **administrador** Função). Se um administrador do Zoom não conseguir acessar a conta, ele deve entrar em contato com o Suporte do Zoom para obter assistência.

Para Habilitar uma exceção de usuário, abra [Centro de administração](https://zoom.com/account) → [Segurança e confiança](https://zoom.com/account/setting/security) → [Geral](https://zoom.com/account/setting/security), localize a lista de domínios aplicados e Adicionar uma exceção por meio da lista de edição.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe23kx3YxMdjE3_CZSecp2CF3HA42tOP80rwvDJo5JApEYW3sPKjo4p2qyJFQ912BHysKjQ51M5p04hb_ODjApxTyL3bh9-PooZZ1lrf1odC8z1n8xtOcDjROAjCO-45Idn5nVglw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="375"><figcaption><p>Exemplo de lista de domínios para SSO.</p></figcaption></figure></div>

#### <mark style="color:azul;">Os clientes móveis e de desktop podem ser configurados para exigir que os usuários usem autenticação SSO</mark>

Os clientes Zoom podem ser pré-configurados para automatizar a funcionalidade de SSO, incluindo início de sessão automático, término de sessão automático, autenticação apenas por SSO no Dispositivo e muito mais através da Política de grupo, serviços de gestão de Dispositivo móvel (MDM) e clientes de implementação em massa.

Para uma lista completa de possibilidades de configuração, consulte nossas opções de configuração para [Política de Grupo](https://support.zoom.us/hc/en-us/articles/360039100051), [iOS](https://support.zoom.us/hc/en-us/articles/360022302612-Using-MDM-to-configure-Zoom-on-iOS), [Android](https://support.zoom.us/hc/en-us/articles/360031913292-Using-MDM-to-configure-Zoom-on-Android), [Mac](https://support.zoom.us/hc/en-us/articles/115001799006-Mass-deploying-preconfigured-settings-for-Mac) e [Windows](https://support.zoom.us/hc/en-us/articles/201362163-Mass-deployment-with-preconfigured-settings-for-Windows).

#### <mark style="color:azul;">Usuários do Office 365 podem iniciar sessão automaticamente no Plugin Zoom para Outlook usando credenciais SSO</mark>

Clientes que usam Office 365 podem fazer com que seus usuários iniciem sessão automaticamente no Plugin Zoom para Outlook usando credenciais SSO. Isso pode ser combinado com um [manifesto personalizado do complemento](https://support.zoom.us/hc/en-us/articles/360041403311) que pré-preenche a URL intuitivo da conta, criando uma experiência de autenticação contínua para os usuários. Este recurso usa o token de sessão SSO do usuário se estiver ativo, ou solicitará uma nova autenticação com seu provedor de identidade se nenhuma sessão ativa for encontrada.

Um administrador do Zoom pode habilitar essa configuração na conta [página de segurança](https://zoom.us/account/setting/security) sob o **avançado** menu.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfEdymeE4sK16jjdIFscCwWJFRXrCOOa_JUC8l0P7qxR3mXD4HFeDP9V3SUEsJCFMFqn41oKdwmS2Rk7Ilu-NgPfaPj0IpVnYxYUCPYdtcVCU63p7GfceHm5GrhvgdFEPC67hpP?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="375"><figcaption><p>Exemplo de configuração de administrador para SSO com suplemento do Outlook.</p></figcaption></figure></div>

## Mapeamento de resposta

No mapeamento de resposta, **atributos** são categorias de dados definidas por **valores**, e são usados para transmitir informações do provedor de identidade para um provedor de serviço como o Zoom. Mapear atributos e valores é essencial para automatizar informações de perfil do usuário e gerenciar licenças de usuário.

O mapeamento de resposta do Zoom é dividido em duas partes: *básico* e *avançado*. O mapeamento básico é usado para mapear informações básicas de perfil, incluindo nome, número de telefone, departamento etc., enquanto o mapeamento avançado é usado para gerenciar atribuições dinâmicas de licença, Atribuir grupos de usuários, funções de usuário e muito mais.

Esta seção aborda os fundamentos do mapeamento de resposta básico e avançado e destaca condições exclusivas exigidas por alguns recursos.

#### <mark style="color:azul;">O Zoom oferece suporte ao mapeamento de resposta por meio de SAML e OIDC</mark>

O Zoom pode Configurar o mapeamento de resposta por meio de SAML ou OIDC. As informações de identidade SAML são trocadas em declarações formatadas em XML, enquanto as informações de identidade OIDC são fornecidas por meio de conjuntos de chaves Web JSON (JWKs). Em qualquer dos casos, o Zoom pode usar os atributos ou declarações recebidos do provedor de identidade para mapear informações de perfil do usuário, licenciamento, grupos e outras Configurações de conta compatíveis.

#### <mark style="color:azul;">Fundamentos: Atributos e Valores</mark>

A maioria dos provedores de identidade transmite informações básicas de perfil usando nomes e valores de atributos simples. Por exemplo, o departamento de um Funcionário pode chegar com um atributo de departamento e um valor de Recursos Humanos. A tabela a seguir demonstra a relação entre atributos e valores ao transmitir informações sobre um usuário.

| Atributo   | Valor                          |
| ---------- | ------------------------------ |
| firstName  | John                           |
| lastName   | Smith                          |
| e-mail     | <john.smith@companydomain.com> |
| department | Recursos Humanos               |

Ao Atribuir corretamente um atributo a um mapeamento de resposta, as informações do usuário podem ser aplicadas automaticamente a um perfil de usuário para simplificar o processo de criação e gerenciamento da conta.

### Mapeamento básico: Informações do perfil

O Mapeamento Básico é usado para aplicar informações de perfil como nome, sobrenome, departamento, número de telefone, centro de custos e Localização de um diretório ao perfil de um usuário. Muitas dessas categorias são autoexplicativas e podem ser facilmente configuradas; no entanto, algumas categorias exigem explicação para a configuração adequada para impedir consequências imprevistas ou erros do aplicativo. A seção a seguir destaca opções exclusivas de mapeamento e Configurações para o mapeamento básico. Consulte nosso [artigo sobre Mapeamento Básico](https://support.zoom.us/hc/en-us/articles/115005888686-Setting-up-basic-SAML-mapping) para uma lista completa dos atributos compatíveis.

#### <mark style="color:azul;">O tipo de licença padrão se aplica apenas a</mark> *<mark style="color:azul;">novos usuários</mark>*

A opção de tipo de licença padrão aplicará a licença designada a todos os *novos* usuários que são provisionados na conta por meio da autenticação na primeira vez. Isso não se aplica a usuários que estão se autenticando pela segunda vez, usuários que foram consolidados na conta a partir de uma conta anterior, usuários que são provisionados por meio de SCIM ou usuários que foram convidados manualmente.

Para obter informações sobre *atualizando* licenças de usuário com autenticação, consulte a configuração da licença em [Mapeamento avançado](#advanced-mapping-licenses-add-ons-and-access).

#### <mark style="color:azul;">Um tipo de licença padrão de</mark> *<mark style="color:azul;">Nenhum</mark>* <mark style="color:azul;">não irá Permitir que novos usuários possam autenticar-se, a menos que o mapeamento avançado esteja configurado para Atribuir uma licença</mark>

Os usuários do Zoom devem ter um tipo de licença atribuído (Não atribuído sem Zoom Meetings básico, Zoom Workplace etc.) para iniciar sessão no serviço Zoom. Se um tipo de licença padrão de Nenhum for selecionado, os novos usuários não podem iniciar sessão nem criar uma nova conta, a menos que recebam uma licença por meio de [Mapeamento avançado](#advanced-mapping-licenses-add-ons-and-access).

#### <mark style="color:azul;">A maioria dos mapeamentos básicos será reaplicada no login, salvo especificação em contrário</mark>

A maioria dos mapeamentos básicos será atualizada sempre que um usuário iniciar sessão por padrão, *exceto* *para* nome, sobrenome, nome de Exibir e número de telefone. Por padrão, esses quatro mapeamentos só serão aplicados na primeira vez que um usuário autenticar-se e não serão reaplicados novamente, mesmo que sejam atualizados por um usuário ou administrador do Zoom. Os administradores do Zoom podem Alterar esse comportamento ao habilitar a opção para **Atualizar em cada login de SSO** na página de mapeamento de resposta.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdgxB7nSeT9EXKL47NDJoqfiLnUAkydR2-yPdvgvQW178LJscVd-Jo8TfyuPBb2sez6c5cRwwK0FwoEhCwG8TlOfZV1MzpWoZxXOYHu1WCcPZYBryituG7Fyq-T88isb7-ofUn_MQ?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="375"><figcaption><p>Exemplo da opção de Atualizar em cada login SSO.</p></figcaption></figure></div>

#### <mark style="color:azul;">Os mapeamentos de Números de telefone devem incluir um código de país e código de área se estiverem fora dos Estados Unidos</mark>

Os Números de telefone mapeados por meio de asserções devem incluir o código de país e o código de área do usuário quando possível. O Zoom presumirá um código de país de +1 se não for definido por padrão.

Contas que não retêm códigos de país em seu diretório podem editar suas asserções em seu provedor de identidade para incluir isso automaticamente, se necessário.

#### <mark style="color:azul;">Cada usuário pode ter até três Números de telefone e um número de fax mapeados para seu perfil</mark>

Os administradores do Zoom podem Configurar até três mapeamentos separados de Números de telefone e um número de fax para cada usuário. Cada número de telefone deve ser único e não pode duplicar o valor de outro campo.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdYCqP1aO_ELJdgruJRApKiNSEQ96i1dThBbMwG0rH-XT4P64DcgadLpi_4dFm4tybOmAkUaH22Jg0Qs6WMhyanQ7FrFSHu7DFMJv6FzABVhdz6NvN_E0pX26mymjGHe5UjUcxRNg?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="375"><figcaption><p>Exemplo das opções de Números de telefone para cada usuário.</p></figcaption></figure></div>

#### <mark style="color:azul;">As fotos de perfil devem ser mapeadas a partir de uma URL acessível publicamente ou codificadas em Base64</mark>

Contas que desejam mapear fotos de perfil a partir de seu diretório devem mapear as imagens usando uma URL acessível publicamente ou codificar a imagem em Base64 ao fazer a asserção.

### ID Único do Funcionário

<mark style="color:azul;">**O ID único do Funcionário serve para Alterar o identificador primário que o Zoom usa para identificar o usuário e ajuda a impedir contas de usuário duplicadas após uma alteração de e-mail**</mark>

O *ID Único do Funcionário* é um Recursos que o Zoom oferece para ajudar no gerenciamento de identidade. Por padrão, a identificação principal de um usuário Zoom é seu **e-mail** **endereço**. Isto significa que, se o tipo de login do e-mail comercial for **<john.smith@company.com>**, então o Zoom sempre identificará esse usuário por esse endereço de e-mail. Esse identificador é o que permite que integrações como SSO ou contas OAuth do Facebook e do Google associem o usuário à mesma conta Zoom.

No entanto, este processo de identificação pode ser problemático se o nome ou o e-mail de um usuário mudar. Por exemplo, se **<john.smith@company.com>** tem uma Alterar de e-mail para **<jonathan.smith@company.com>**, o Zoom não pode determinar com segurança que são a mesma pessoa (porque o identificador fundamental é diferente), então o Zoom criará uma nova conta na primeira vez **<jonathan.smith@company.com>** faz login.

Para simplificar esse problema, o Zoom oferece os Recursos de ID Único de Funcionário, que permitem Alterar o identificador principal de um usuário do seu endereço de e-mail para um ID único estabelecido. *Isso não vai Alterar o Nome de usuário do usuário no Zoom*, mas em vez disso oferece um atributo de identificação alternativo. Esta Alterar permite que o Zoom atualize dinamicamente o endereço de e-mail de um usuário dentro do Zoom se:

* a *novo* o endereço de e-mail é acompanhado por um ID Único de Funcionário conhecido; e
* o domínio de e-mail do usuário afetado está associado no Zoom

Por exemplo, se **<john.smith@company.com>** autentica e passa um valor de 12345 (seu número de Funcionário) para o atributo ID Único do Funcionário, o Zoom agora identificará o usuário na conta pelo valor informado. Se John autenticar novamente usando o e-mail **<jonathan.smith@company.com>** enquanto ainda passa o ID Único do Funcionário de 12345, o Zoom identificará que <john.smith@company.com> agora é **<jonathan.smith@company.com>** e atualizará dinamicamente o e-mail do usuário na conta se o domínio estiver associado.

Os administradores de identidade devem estar *certos* de que não haverá sobreposição de dois usuários com o mesmo valor de ID Único do Funcionário antes de estabelecer um mapeamento para esta categoria. Se outro usuário autenticar e passar o mesmo valor, o e-mail será atualizado novamente para o novo usuário e pode causar interrupções significativas nos serviços e na experiência do usuário.

<mark style="color:azul;">**Os Recursos do ID Único do Funcionário exigem Domínios associados para Alterar o e-mail de um usuário**</mark>

Os Recursos do ID Único do Funcionário não podem atualizar o endereço de e-mail de um usuário, a menos que o domínio do e-mail esteja oficialmente associado ao perfil da conta. Consulte nosso artigo de Suporte sobre [Domínios associados](https://support.zoom.us/hc/en-us/articles/203395207) para mais informações.

<mark style="color:azul;">**Os e-mails de administrador e Proprietário não podem ser atualizados por meio do ID Único do Funcionário**</mark>

E-mails de administrador e Proprietário no Zoom não podem ser atualizados por meio dos Recursos do ID Único do Funcionário. Isto foi planejado como uma medida de segurança para impedir acesso não autorizado. Administradores e Proprietários devem Alterar seu e-mail por meio da página do perfil.

<mark style="color:azul;">**Os e-mails do usuário só podem ser atualizados uma vez por dia por meio do ID exclusivo do Funcionário**</mark>

Os e-mails do usuário só podem ser atualizados uma vez a cada 24 horas por meio dos Recursos de ID exclusivo do Funcionário. Um usuário deve aguardar um dia inteiro de calendário desde a atualização anterior antes de atualizar seu e-mail via SSO novamente.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXct3ljK0YW8k8R82DXpS2__Hf8KB0qkleCQ_il6l4GcgeuhekPfPn55csfETIAauFfPQkmW7VBQOTDd2C9o39lzcTWDnMXZMW9FixnWOhCxraDttTdnKbXXF4aU1TrSOrh-9U388A?key=ug1dFE_WGWGnyMfD5tJnNw" alt=""><figcaption><p>Diagrama de um fluxo de exemplo para atualização de e-mails do usuário.</p></figcaption></figure></div>

<mark style="color:azul;">**Definir o atributo como \<NameID> usará o NameID declarado do usuário**</mark>

Mapeando o atributo ID exclusivo do Funcionário para **\<NameID>** usará automaticamente o valor NameID declarado do usuário como seu identificador exclusivo. Isso pode ser uma ferramenta útil se o seu provedor de identidade declarar um NameID diferente do e-mail de um usuário, como um Nome Principal do Usuário (UPN) ou valor semelhante que não muda. Não use esse valor se os NameIDs dos usuários corresponderem ao seu e-mail.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfc-LwwficUxnJVa6raeHY3XwO_bRUnOo3Px-FpVWxCXKTEVRI2zoCRbp9Mjzsj1gyiTVmPy-gHryvIjpBuxrM8Me38KvWu0gf-mrPrnwxnaK9tk_hsywxF25Slq3Yh99iKINVPmw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="375"><figcaption><p>Exemplo da configuração de administrador para &#x3C;NameID>.</p></figcaption></figure></div>

### Mapeamento avançado: Licenças e Adicionar-ons

A seção de Mapeamento de Informações Avançado pode aplicar dinamicamente licenças (incluindo Zoom Phone), Adicionar-ons e grupos de Acessar de usuários aos usuários à medida que autenticar. Ao contrário do mapeamento básico, o mapeamento avançado contém muitas nuances que podem exigir atenção diligente ao configurar, dependendo da complexidade do seu ambiente. Esta seção destaca as nuances para configurar o mapeamento avançado de resposta. Consulte o nosso [Artigo de Mapeamento Avançado](https://support.zoom.us/hc/en-us/articles/115005081403-Setting-up-advanced-SAML-mapping) para uma lista completa dos atributos compatíveis.

#### <mark style="color:azul;">O mapeamento avançado se aplica sempre que um usuário se autentica</mark>

Ao contrário do mapeamento básico, que tem atualizações Opcional para algumas categorias, as configurações de mapeamento avançado se aplicarão sempre que um usuário se autenticar, de acordo com a ordem top-down de aplicativo.

Por exemplo, se um usuário tem uma licença básica e depois se autentica por SSO passando um atributo e um valor mapeados para conceder uma licença completa, o usuário receberá instantaneamente a licença completa. Se o perfil do usuário for então alterado dentro do provedor de identidade para movê-lo de volta para uma licença básica, ele será reatribuído à licença básica assim que se autenticar novamente no Zoom.

#### <mark style="color:azul;">O mapeamento avançado permite vários atributos e valores por categoria</mark>

Ao contrário do mapeamento básico, que permite apenas um atributo por categoria, o mapeamento avançado pode suportar vários atributos e valores para cada categoria. Isso permite flexibilidade significativa ao gerenciar o licenciamento e o acesso do usuário por meio de grupos de segurança dentro do seu provedor de identidade, como visto na configuração a seguir.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcw0QbtEMEhc4KtDF3LZsfAIgir_-AB2XGFaJ6qWplazLgxbyRSunevolbVjRFe196QBnWeqwA8dPSnvGbyhg-TSH1yJ2iZvElnIDPU6j1wRuka_5MndC3rAjXADRJIqPmoeESo?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Exemplo de mapeamento avançado de atributos.</p></figcaption></figure></div>

{% hint style="success" %}
**Dica do Zoom**

Os atributos podem variar conforme o provedor de identidade, especialmente para grupos de segurança. Confirme com seu provedor de identidade ou por meio de [registros de resposta](#response-logs-tell-you-which-saml-values-and-attributes-are-being-asserted) como os atributos são declarados.
{% endhint %}

#### <mark style="color:azul;">A atribuição avançada aplica licenças de cima para baixo quando múltiplos atributos são afirmados</mark>

Se um usuário passar múltiplos atributos ou valores que estejam configurados para a atribuição avançada, o Zoom fará o mapeamento das licenças de cima para baixo. Veja o exemplo a seguir:

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd6ejdpzRIK8EUzyzdyomoHNChq-XkoS85btacDjLOAKyBQVwIQ15dzUKqsE_l8iFDOJiYGUjh4W7XaTRapGaZp5tx7R2J06yvpbwSna1YVjR9_ms8nn1haaJiNxaaL6wQ7XdC1QA?key=ug1dFE_WGWGnyMfD5tJnNw" alt=""><figcaption><p>Exemplo de seleção do tipo de licença nas Configurações do administrador.</p></figcaption></figure></div>

De acordo com a configuração acima, se um usuário passasse um atributo para ambos **global\_users** e **marketing**, porque **marketing** é o mais alto na configuração, este atributo será aplicado ao usuário, e os atributos aplicáveis restantes serão ignorados.

Alternativamente, se a configuração fosse definida com **global\_users** como o mais alto, como visto na captura de tela a seguir, se a afirmação de um usuário contivesse **global\_users**, **marketing**, **humano** **recursos**, e **TI**, porque **global\_users** é a maior prioridade, apenas uma licença básico será atribuída.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfdQrc0QA5GFNzFVBIa9y1HH0GdkDMzeSomo4GdhE8xHCQzwozv2CXWRkdedXemhuAoZ81rfa21kPlO_0DalY2oasz6XDJkLD88NaNQiH686EX9Rfuxb-mje5go5uep9Fp3RBQuKw?key=ug1dFE_WGWGnyMfD5tJnNw" alt=""><figcaption><p>Exemplo de ajuste da ordem de prioridade</p></figcaption></figure></div>

Os administradores do Zoom podem ajustar a ordem do aplicativo ao editar os valores de mapeamento usando as setas ↑↓ no editor.

{% hint style="success" %}
**Recomendação do Zoom**

Configurar as configurações avançadas da mais específica para a mais geral para impedir o uso incorreto da licença.
{% endhint %}

#### <mark style="color:azul;">Os mapeamentos de webinar e Grande reunião  podem compartilhar um valor comum para aplicar ambos os complementos (Adicionar).</mark>

Para simplificar o processo do aplicativo, os administradores do Zoom podem Configurar o mesmo atributo e valor duas vezes para aplicar ambos os complementos de webinar e Grande reunião  (Adicionar) aos usuários, como visto na imagem a seguir com o **global\_users** valor. Esses complementos (Adicionar) também podem ser configurados independentemente, se desejado, como mostrado com o **webinar\_only** e **large\_reunião\_only** valores.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdY6Py9Rb7L7iKsez3UXpg9ZwL-gxgmpO5QjLDXdeZC42EJDCHEw82ghcAm4m5Rb8fZ8GQvT5rd47j-p4JeR6DUUAujw7ARMynCsLKPLrJVGjlkiEp2YtRk-sOZNaQPUQWYRRTsmQ?key=ug1dFE_WGWGnyMfD5tJnNw" alt=""><figcaption><p>Exemplo de atributos para large_reunião_only e webinar_only.</p></figcaption></figure></div>

#### <mark style="color:azul;">Usuários especificados e Grupos de usuário podem ser isentos de mapeamentos específicos</mark>

Cada opção em Mapeamento Avançado pode ser configurada para isentar usuários específicos e Grupos de usuário do comportamento de mapeamento. Isso pode ser benéfico para evitar a interrupção do serviço para usuários VIP devido a uma potencial Alterar na licença.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXftnv80dtlXFIYqMKvlB0mecwcoX7_IEQIFXed3x-9szHtQv3X-h_aLv5gkJ4_9q0wIJI3YlxNdPS3aR--_TOt3Xv8_ZGfv2Fqrv9hSSAEvaY4e69nEPQIpVGHMk6fTbKareeawww?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Exemplo de isenções de usuário.</p></figcaption></figure></div>

#### <mark style="color:azul;">Zoom suporta até oito atributos personalizados</mark>

Os administradores do Zoom podem Configurar até *oito* atributos personalizados para adicionar dados do usuário ao seu perfil do Zoom sob o [Gerenciamento de usuário avançado](https://zoom.us/account/user#/advanced) página. Depois de adicionar os campos personalizados, os administradores do Zoom podem Configurar o mapeamento na [Mapeamento de resposta](https://zoom.us/account/sso/mapping) página.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcxmWWYpKRYP078q0iwYdK9tfmcmAHLuwZtoSn7VoUeeRbdki2udbiF0Yh7pUczEG_rXqZGS1zBbDl4-OODAZYMFEkISb4L55mahN_6hAqt87dCo8fT4Yj7aQVw1ivuZtzksdmhQg?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="375"><figcaption><p>Exemplo de atributos personalizados</p></figcaption></figure></div>

#### <mark style="color:azul;">Mapear usuários para uma subconta irá</mark> *<mark style="color:azul;">somente</mark>* <mark style="color:azul;">aplicar uma licença de reunião e complementos</mark>

Mapear um usuário para uma subconta aplicará apenas a licença de reunião e os complementos do usuário, como Webinar e Reuniões grandes, à subconta. Grupos de usuários, Grupos de IM, Funções de usuário etc. não se aplicarão e devem ser configurados dentro da subconta.

Clientes/clientes que exigirem mais flexibilidade para o mapeamento de resposta com subcontas precisarão de uma URL intuitivo exclusiva e de uma nova configuração de SSO dentro da subconta.

### Mapeamento avançado: atribuição de grupo de usuário e grupo de contato

A atribuição de grupo de usuário e grupo de contato é a única área do mapeamento avançado que opera em dois modos distintos: *mapeamento padrão* e *multi-mapeamento*.

* **Mapeamento padrão** aplica uma única correspondência. Um administrador pode configurar muitos pares de atributo e valor, mas, quando um usuário se autentica, apenas a primeira entrada correspondente entra em vigor e o restante é ignorado. Alcançar um resultado específico, portanto, depende de uma configuração precisa e exata. Esse é o comportamento padrão para todas as contas.
* **Multi-mapeamento** é um modo opcional que aplica todas as correspondências. Uma única autenticação pode corresponder a vários atributos e valores ao mesmo tempo, atribuindo o usuário a vários grupos em uma única passagem. Isso o torna muito adequado a contas com estruturas de grupo complexas que colocam usuários em uma grande variedade de grupos de usuários e grupos de contato. O multi-mapeamento deve ser habilitado por meio do Suporte do Zoom.

#### <mark style="color:azul;">**O mapeamento padrão atribui um usuário ao primeiro grupo de usuários ou grupo de contato correspondente**</mark>

No mapeamento padrão, quando a asserção de um usuário corresponde a vários valores configurados dentro da categoria Grupo de usuários ou Grupo de contato, o Zoom aplica apenas a entrada correspondente mais alta na configuração. As entradas são avaliadas de cima para baixo, e a primeira que corresponde é aplicada. Todas as correspondências restantes nessa categoria são ignoradas.

Por exemplo, em uma configuração contendo vinte pares de atributo e valor mapeados para diferentes grupos de usuários, um usuário cuja asserção corresponda a vários desses pares é colocado apenas no grupo associado à entrada correspondente mais alta.

#### <mark style="color:azul;">Um único valor pode adicionar um usuário a vários grupos, e o primeiro grupo adicionado torna-se o Grupo primário</mark>

Os administradores do Zoom podem configurar o mapeamento de grupos de usuários para adicionar um usuário a vários grupos com um único valor. Esse comportamento se aplica tanto no mapeamento padrão quanto no multi-mapeamento.

O primeiro grupo de usuários adicionado será definido como o Grupo primário do usuário e determinará as configurações padrão do usuário *exceto se um grupo subjacente tiver uma configuração bloqueada*. Para mais informações sobre grupos de usuários, consulte nosso [artigo de suporte](https://support.zoom.us/hc/en-us/articles/204519819-Managing-user-groups-and-settings).

Na imagem a seguir, se um usuário passasse os valores para **Liderança**, **Recursos Humanos**, e **Regulado**, eles seriam colocados apenas nos grupos de **Liderança**, porque é a primeira correspondência e nenhuma outra correspondência se aplica.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdER0NnN7GSalp5YpVpM9EW068VLrDgdHOJty4Hm6blWIOEghH5Woj7B8s7io1X2U3ywZEiyvU5cJE4pEcCJtSrlhAsaPnzLK44CVAlU_k1Igqt4y8ejYfFAw-ILkKulqXUGqohrg?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Exemplo de mapeamento padrão de grupos de usuários.</p></figcaption></figure></div>

#### <mark style="color:azul;">O multi-mapeamento atribui um usuário a cada grupo de usuários e grupo de contato correspondente, para até 50 correspondências de regra</mark>

Quando o multi-mapeamento está habilitado, o Zoom aplica *cada* entrada correspondente nas categorias Grupo de usuários e Grupo de contato em vez de apenas a correspondência mais alta. O mesmo atributo pode ser configurado até cinquenta vezes, e cada valor configurado que corresponda a uma asserção coloca o usuário em seu grupo associado.

Isso significa que um único atributo passado com cinquenta valores distintos, cada um mapeado para um grupo diferente, pode colocar um usuário em todos os cinquenta grupos em uma única autenticação. Isso possibilita uma relação um-para-um entre os grupos de segurança do provedor de identidade e os grupos do Zoom, de modo que adicionar um usuário a um grupo de segurança dentro do provedor de identidade o atribui ao grupo correspondente do Zoom na próxima autenticação.

Na imagem a seguir, se um usuário passasse os valores para **liderança**, **teste**, **IA**, e **recursos\_humanos** com o multi-mapeamento habilitado, o usuário seria colocado em todos os grupos de usuários, porque o Zoom aplicará as 50 primeiras correspondências de regra quando o multi-mapeamento estiver habilitado.

<div data-with-frame="true"><figure><img src="https://1821044411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2F1BU0JBMg5uBirl6FGTX4%2FScreenshot%202026-08-19%20at%2012.17.26%E2%80%AFPM.png?alt=media&amp;token=cd1aba57-b23c-4989-a24d-e2dc37cf9785" alt="" width="563"><figcaption><p>Exemplo de grupos de usuários de multi-mapeamento</p></figcaption></figure></div>

A designação de Grupo primário não é afetada pelo modo de mapeamento. Em ambos o mapeamento padrão e o multi-mapeamento, o primeiro grupo correspondente adicionado torna-se o Grupo primário do usuário, exceto se um grupo subjacente tiver uma configuração bloqueada.

#### <mark style="color:azul;">O multi-mapeamento simplifica a atribuição de grupos em ambientes empresariais de grande porte</mark>

O multi-mapeamento reduz a precisão de configuração necessária para atribuir usuários a vários grupos de usuários ou grupos de contato. No mapeamento padrão, colocar um usuário em vários grupos depende de uma configuração exata de cima para baixo que se resolve corretamente em uma única avaliação. O multi-mapeamento remove essa restrição ao aplicar todas as entradas correspondentes de uma vez, o que dá suporte a ambientes em que os usuários pertencem a muitos grupos e em que configurações por atributo e por valor, de outra forma, seriam difíceis de executar em uma única passagem.

#### <mark style="color:azul;">O multi-mapeamento requer ativação por meio do Suporte do Zoom</mark>

O multi-mapeamento não é habilitado por meio da interface padrão de administração do SSO. Habilitar o recurso requer o envio de um [pedido de Suporte](https://support.zoom.com/hc/en/contact?id=contact_us) ao Zoom solicitando que o multi-mapeamento seja ativado para a conta. Até que a solicitação seja processada, a atribuição de Grupo de usuários e Grupo de contato opera sob o comportamento padrão de primeira correspondência.

### Mapeamento avançado: Mapeamento automático

#### <mark style="color:azul;">O Mapeamento automático serve como uma alternativa que atribui usuários a um grupo de usuário, canal ou grupo de IM nomeado após o valor declarado quando nenhuma regra explícita corresponde</mark>

O Mapeamento automático pode ser usado para atribuir automaticamente usuários a um Grupo de usuários, Canal e Grupo de IM com o nome do valor declarado. Diferentemente de outros componentes de mapeamento avançado, que podem ser configurados para atribuir um usuário a qualquer grupo com base no valor, o Mapeamento automático sempre atribui um usuário a um grupo com base no valor exato. Se o grupo não existia anteriormente, ele será criado automaticamente.

O Mapeamento automático funciona como uma alternativa e só se aplica quando a asserção de um usuário não corresponde a nenhuma das regras explícitas configuradas nas seções de mapeamento avançado acima. Se um usuário já estiver atribuído a um grupo por meio de uma regra explícita — por exemplo, colocado em um Grupo de usuários com base na associação ao grupo de segurança do provedor de identidade — essa atribuição explícita tem prioridade e a regra correspondente de Mapeamento automático é ignorada. No mesmo exemplo, um Grupo de usuários mapeado automaticamente a partir do valor do departamento do usuário não seria aplicado, porque a regra explícita do Grupo de usuários já teria correspondido.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcleVut-f8Pq1AdmwMk0CU5uE4MYhIFAdSPSxxVbyoMyS2e24V3RL9AD_VhcVCTtoh0PFswB_8JTwlOMYm_TCTKria2nIAOVtg7iI3rlKdsWAwpe5UlM-AfuthKuAnG8_mu71VPcw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Exemplo de uma configuração de Mapeamento automático.</p></figcaption></figure></div>

Por exemplo, se o Mapeamento automático estiver definido para mapear um usuário para os grupos com base em seu departamento, e o usuário não corresponder a uma regra explícita para essa categoria, então, se o valor do departamento ainda não estiver definido para o Grupo de usuários, Canal ou Grupo de IM, os usuários serão atribuídos automaticamente a um grupo que corresponda ao nome do departamento, conforme mostrado na tabela a seguir:

| Atributo     | Valor            | O grupo do Zoom já existe? | Resultado                                                 |
| ------------ | ---------------- | -------------------------- | --------------------------------------------------------- |
| Departamento | Recursos Humanos | Sim                        | Usuário adicionado ao grupo Recursos Humanos              |
| Departamento | Marketing        | Sim                        | Usuário adicionado ao grupo Marketing                     |
| Departamento | Vendas           | Não                        | Grupo Vendas é criado, usuário adicionado ao grupo Vendas |

## Solução de problemas de SSO

#### <mark style="color:azul;">Registros de resposta podem ser salvos para solução de problemas</mark>

O Zoom pode salvar registros de resposta de tentativas de autenticação por sete dias após uma autenticação. Esses registros de resposta podem ser uma ferramenta inestimável para solucionar problemas de configuração e erros de usuário, além das configurações de mapeamento de resposta. Consulte a seção sobre [solução de problemas de erros com registros de resposta](#using-saml-response-logs-to-troubleshoot) para mais informações.

{% hint style="success" %}
**Recomendação do Zoom**

Habilite o salvamento de registros de resposta para facilitar a solução de problemas.
{% endhint %}

#### <mark style="color:azul;">Usando Registros de Resposta para Solucionar Problemas</mark>

Registros de resposta salvos podem ser uma ferramenta inestimável para solucionar problemas de configuração e erros de usuário, além das configurações de mapeamento de resposta. Se sua configuração de SSO do Zoom estiver definida para salvar registros de resposta, eles podem ser acessados por meio da [Registro de resposta](https://zoom.us/account/sso/saml_logs) aba disponível na página de configuração do SSO em Configurações avançadas. Para ver os registros de resposta, clique em **Ver detalhes** ao lado de uma tentativa de autenticação.

#### <mark style="color:azul;">A maioria das autenticações será exibida nos registros de resposta</mark>

A maioria das tentativas de autenticação malsucedidas ou sem sucesso será exibida na página de registros de resposta. Se uma tentativa de autenticação não for exibida, é muito provável que o Zoom não tenha recebido uma asserção do seu provedor de identidade ou que o salvamento de registros de resposta esteja desabilitado.

#### <mark style="color:azul;">Os registros de resposta podem informar se sua configuração está incorreta ou se seu certificado está desatualizado</mark>

Quando o salvamento de registros de resposta está habilitado, as informações do provedor de identidade são declaradas ao Zoom para autenticar identidades de cada parte. Se uma configuração declarada ou sequência de informações, como o certificado X509 ou o ID do emissor, for diferente da configuração atual do Zoom, aparecerá um erro informando que as informações “não correspondem às configurações atuais de SSO”. Um administrador do Zoom pode atualizar a configuração de SSO para corresponder a esses valores declarados, se estiverem corretos, para resolver o erro.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe5ElE9oAkqrfuutEG32SjtnF-aPpSu_MbRIy3h6oRhTiHnBC3okBRHk57sWwuJgg3a8_WD_mYoK_Wd5bJ1zMkLScazjdXshmBUZyXvBVtmyQO75Rl7ox_MCgT6X-AzcA?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Exemplo de avisos de configuração incorreta.</p></figcaption></figure></div>

#### <mark style="color:azul;">Os registros de resposta informam quais valores e atributos estão sendo declarados</mark>

A revisão dos registros de resposta pode ajudar a resolver configurações de mapeamento de resposta ao verificar quais atributos e valores estão sendo declarados pelos usuários enquanto se autenticam. Eles podem ser comparados com a configuração para garantir que os atributos e valores correspondam.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe-BD98pFvpYplXC-sVB4KKlUFDc0dOzjv-VzEOyH5tOBQbt-yiK8e82nkLGC7FmBJIekP-VVqEBVnullP173ydJLkNDFh6nCcOfup1UHlTTYl2l0DDitymKeid4NO7ZZYaw6J3sQ?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Exemplo de informações sendo declaradas pelo serviço do provedor de identidade.</p></figcaption></figure></div>

Se atributos ou valores estiverem ausentes, as informações não estão sendo declaradas pelo serviço do provedor de identidade. Usuários que estiverem enfrentando esse problema são incentivados a entrar em contato com os serviços de suporte do provedor de identidade para obter mais ajuda.

#### <mark style="color:azul;">Os Registros de Resposta incluem um código de erro e uma breve explicação, se malsucedido</mark>

Se um usuário não conseguir se autenticar ou receber um erro, os registros de resposta contêm um código de erro e uma breve explicação do erro.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcUxXpQNQM4ZUpgIHUF2s__t4s3fM4sjWqXqv5y4i4oop4ygRKYcxxdeC7pIX7_O8sgxFmbrkPd6PrlLam4zptYZNKleBKEXFEUd0o97IvJZvRfZi81sSfKr6wwvfxemuzg_UDi?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Exemplo de código de erro e explicação.</p></figcaption></figure></div>

A maioria dos problemas pode ser identificada e resolvida usando essas mensagens de erro. Se você não conseguir resolver o erro, entre em contato com o Suporte do Zoom para obter assistência adicional.

#### <mark style="color:azul;">Erros de ID de rastreamento WEB</mark>

Se um usuário falhar na autenticação de SSO, ele receberá um código de erro de ID de rastreamento WEB. Esses códigos não são uma mensagem de erro relacionada a uma falha específica, mas sim um ID de log exclusivo que pode ser revisado em Mapeamento de Resposta para identificar problemas de autenticação.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdg3Btc3wYZ71fAL7VX5G0OiLOQ-YKOAmt1-fytPE2xDRktbVLQqw_r2rURYLExtZ2rSfIIqelDEM8oZ47-gFBKdn2Ze9V6kx5nB_kuxZlYIKP2Hy24Ot0SXrobSdLg4BfudOs_?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Exemplo de um erro exibido ao usuário com um código de erro de ID de rastreamento WEB.</p></figcaption></figure></div>

Para identificar o erro, se o registro de resposta estiver habilitado, navegue até a [Registro de resposta](https://zoom.us/account/sso/saml_logs) aba disponível na página de configuração do SSO em Configurações avançadas. A partir daí, insira o ID de rastreamento WEB no campo ID de rastreamento e pesquise para preencher o registro de resposta

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcbDm_F5qgN7TwBk0PiItomqHcaoFUFU8VAmTECFtzogW1sjvlJiIYaK2pXniGKDIEUnEZOg1-xHYrpteg6foFyec_SlpRVjqjUmrNa1lbPvdCEwnuZtOU1yvqfuGYh-enXmq5f?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Exemplo de pesquisa no Registro de resposta com o mencionado código de erro de ID de rastreamento WEB.</p></figcaption></figure></div>

Os registros de resposta devem exibir a asserção recebida e um código e mensagem de erro na parte inferior da resposta que podem ser usados para solução de problemas adicional.

### Solucionando problemas de SCIM

### Erros

#### <mark style="color:azul;">Usuário não existe ou não pertence a esta conta</mark>

Este erro ocorre quando o endereço de e-mail de um usuário-alvo não consegue ser provisionado devido a uma conta já existente. Os administradores Zoom são incentivados a entrar em contato com o usuário diretamente e Convidar manualmente o usuário para a conta.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdXyiyMnR4S4EhYFqFUXgrePk-RwciKw8-jcxKxViZiIZ4I2kp0j1f_alWR7Hq9WuYhwz6ohh4LodWERfiXSr27LFN20r-r95xBJ6AjD7lF9k58yIJeYLpMmHR3BHYcPTMYkVwqZw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Exemplo de um erro de provisionamento.</p></figcaption></figure></div>

#### <mark style="color:azul;">Você Não Pode Adicionar Usuários Pagos</mark>

Este erro ocorre quando o SCIM tenta provisionar um usuário quando não há licenças suficientes na conta. Para resolver o erro, o usuário deve ser provisionado como um usuário básico ou uma licença deve ser disponibilizada para provisionamento.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdXyiyMnR4S4EhYFqFUXgrePk-RwciKw8-jcxKxViZiIZ4I2kp0j1f_alWR7Hq9WuYhwz6ohh4LodWERfiXSr27LFN20r-r95xBJ6AjD7lF9k58yIJeYLpMmHR3BHYcPTMYkVwqZw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Exemplo de um erro de provisionamento.</p></figcaption></figure></div>

### Usando os registros SCIM para solucionar problemas de provisionamento de usuários

Zoom fornece os 100 registros mais recentes de solicitações de API em [Zoom Marketplace](https://marketplace.zoom.us/). Um administrador Zoom pode usar esses registros para confirmar quais informações estão sendo enviadas e recebidas por meio das APIs de provisionamento. Para Acessar os registros, entre no Zoom Marketplace como um administrador Zoom e clique em **Gerir**. Na página seguinte, Selecionar **Registros de chamadas** em **Gerenciamento de aplicativos pessoais**. A partir daí, clique em uma entrada para expandir os registros de API e revisar o conteúdo.

A imagem a seguir mostra um exemplo de uma solicitação de provisionamento de usuário SCIM, com a identidade e os atributos de licenciamento do usuário destacados para referência.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcIxosFPBR8E4f1hj0vZQ7_nxnRd_isIqJYhKTQbocw4UfXlCBCkscqx8bGvY8JwuazgtRROPJm9PCZfZ4hJ5GQBqBzJA-PgS-mXkptGa0xq82SMXjl9Ip-faCDk3OQuLUXK0iobQ?key=ug1dFE_WGWGnyMfD5tJnNw" alt=""><figcaption><p>Exemplo de uma solicitação de provisionamento de usuário SCIM.</p></figcaption></figure></div>

Assim como o mapeamento de resposta, o Zoom só pode aplicar as informações enviadas pelo provedor de identidade na solicitação de provisionamento. Use estes registros para confirmar que a identidade do usuário e os atributos de licenciamento estão sendo enviados pelo provedor de identidade. Se as informações esperadas estiverem ausentes dessas declarações, entre em contato com seu provedor de identidade para obter Suporte.

## Fluxos de dados e autenticação

#### <mark style="color:azul;">Autenticação SAML</mark>

O diagrama a seguir detalha o fluxo de autenticação SAML de um usuário ao iniciar uma sessão de logon único com o Zoom.

<div data-with-frame="true"><figure><img src="https://1821044411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fn4Ai7NfBYzUEjqKsNoVv%2FArtboard%2044.png?alt=media&amp;token=e49cfac0-e0bb-4c8a-803d-21f47d429dd1" alt=""><figcaption><p>Diagrama de um exemplo de fluxo de autenticação SAML.</p></figcaption></figure></div>

#### <mark style="color:azul;">Autenticação OIDC</mark>

O diagrama a seguir detalha o fluxo de autenticação OIDC de um usuário ao iniciar uma sessão de logon único com o Zoom.

<div data-with-frame="true"><figure><img src="https://1821044411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2FcjmgOKsyrj2jyyoIawfb%2FArtboard%2045.png?alt=media&amp;token=91662b66-e166-41b1-a1ee-a9351ae9a348" alt="Diagram of an example SAML authentication flow."><figcaption><p>Diagrama de um exemplo de fluxo de autenticação SAML.</p></figcaption></figure></div>

#### <mark style="color:azul;">Token de login web do SSO</mark>

Depois que um usuário se autentica, a sessão do usuário é criada dentro do navegador e tem duração de duas horas por padrão. Se o usuário continuar a usar ativamente sua página da web do Zoom, a sessão será atualizada; no entanto, se o usuário não usar sua página da web por duas horas, o token expirará e o usuário deverá se autenticar novamente. Os administradores do Zoom podem personalizar a duração da sessão ativa na [Segurança](https://zoom.us/account/setting/security) página em Usuários precisam iniciar sessão novamente após um período de inatividade e **Definir período de inatividade na web (minutos)**.

#### <mark style="color:azul;">Token de login do cliente</mark>

Quando um usuário tenta se autenticar via SSO dentro de um cliente, a máquina do usuário abrirá um navegador e o redirecionará para a página de login do provedor de identidade. Depois que um usuário se autentica, o navegador do usuário receberá um token de inicialização do cliente Zoom. Assim que um usuário clicar no botão “abrir” ou “iniciar”, o navegador usa o esquema de URL combinado com o token de inicialização para abrir o cliente Zoom.

O cliente Zoom usará o token de inicialização para obter o token de acesso e o token de atualização do servidor Zoom. O cliente usará o token de acesso por períodos de duas horas por vez e, quando ele expirar, usará o token de atualização para obter um novo conjunto de tokens, que são armazenados no banco de dados local do cliente. Esse processo de atualização é ilimitado por padrão e pode continuar alternando entre tokens até que um usuário saia ou os tokens expirem. Os administradores do Zoom podem personalizar a duração da sessão na [configurações de SSO](https://zoom.us/account/sso) página em [*impor logout automático*](#zoom-administrators-can-enforce-automatic-logout-after-a-defined-length-of-time).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/pt/area-do-administrador/account-and-endpoint-management/sso-field-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.