Configurar o aplicativo Entra ID Wizard no Control Hub

Habilitar o Entra ID no Control Hub

No Webex for Government, o aplicativo Entra ID Wizard está disponível para clientes do GCC Moderate Entra ID e do GCC High Entra ID.

Alguns dos recursos descritos neste artigo ainda não estão disponíveis para todos os clientes.

Antes de começar

Certifique-se de ter acesso a uma conta Entra ID que tenha autoridade para conceder o consentimento do administrador de todo o inquilino para um aplicativo.

Você deve ser um administrador completo em sua organização do Control Hub para configurar o aplicativo Entra ID Wizard.

1	Faça login no Control Hub.
2	Vá para Configurações da organização e, em seguida, role para baixo até o aplicativo Microsoft Entra ID Wizard.
3	Clique em Configurar para iniciar a configuração.
4	(Opcional) Para administradores do Webex for Government, selecione Entra Worldwide ou Entra GCC High e clique em Continuar. A Entra Worldwide envia o Wizard para o Entra AD para o GCC Moderate e Commercial. O Entra GCC High envia o Wizard para o Entra AD para o GCC High.
5	Autentique sua conta de administrador do Entra ID. Se você não for um administrador global ou com funções privilegiadas no Entra ID, poderá solicitar acesso para conceder permissão ao aplicativo Entra ID Wizard. Se você tiver privilégios completos de administrador no Entra ID, poderá revisar e conceder acesso às solicitações acessando Identidade > Aplicativos > Aplicativos corporativos. Em Atividade, selecione Solicitações de consentimento do administrador, clique em Integração de Cisco Webex identidade e selecione Revisar permissões e aceitar. Esse processo concede autenticação geral ao aplicativo Webex . Por fim, clique na guia Tudo (pré-visualização), selecione Integração de Cisco Webex identidade e clique em Revisar aplicativo. Em Segurança > Permissões, clique em Conceder consentimento do administrador para que a Cisco conceda todas as permissões necessárias para ativar o Entra ID no Control Hub. Consulte o suporte da Microsoft para obter mais informações sobre esse processo.
6	Revise as permissões e clique em Aceitar para conceder à conta autorização para acessar seu inquilino Entra ID. Cisco WebexO Identity Integration é um aplicativo corporativo Entra ID no Entra ID. O aplicativo Wizard se conecta a esse aplicativo para acessar as APIs gráficas do Entra ID. As permissões necessárias para acessá-lo são as permissões mínimas necessárias para suportá-lo e usá-lo.
7	Para clientes SMB, aceite as configurações padrão marcando a caixa de seleção Sincronizar padrões e clicando em Continuar. Para clientes corporativos, vá para a próxima etapa e continue com a configuração. Se você aceitar as configurações padrão, isso significa que você deseja: Sincronize todos os usuários com o Webex. Aceite os mapeamentos de atributos padrão. Ative o botão para sincronizar todas as imagens de perfil dos usuários para serem exibidas no Webex Services. Ative a sincronização automática após a conclusão da configuração.
8	Para clientes corporativos (mais de 1000 usuários) ou clientes que desejam definir as configurações manualmente, clique na guia Atributos e mapeie os atributos. Clique em Salvar. Você pode mapear outros atributos do usuário do Entra ID para o Webex ou alterar os mapeamentos de atributos do usuário existentes usando a página Atributos. Você pode personalizar o mapeamento assegurando-se de configurá-lo corretamente. O valor que você mapeia como nome de usuário é importante. O Webex usa o endereço de e-mail do usuário como nome de usuário. Por padrão, o UserPrincipalName (UPN) no Entra ID é mapeado para o endereço de e-mail (nome de usuário) no Control Hub. Você não pode editar o mapeamento durante a primeira configuração. Nesse ponto, a instância correspondente não foi criada completamente e não há nenhuma instância do atributo de mapeamento personalizado. No entanto, você pode clicar em Editar para alterá-lo quando a configuração for concluída.
9	Adicione usuários ao escopo de sincronização clicando na guia Usuários. Você pode inserir o nome de usuário para pesquisar e adicionar o usuário no escopo da sincronização. Você também pode remover um usuário do escopo de sincronização clicando no ícone da Lixeira do lado direito. Clique em Salvar. Se você quiser selecionar todos os usuários do Entra ID, selecione Selecionar todos os usuários. Se você selecioná-la, não precisará selecionar grupos no escopo, pois essa opção sincroniza os grupos ao mesmo tempo. Não recomendamos o uso do Select all users para clientes corporativos importantes com centenas de milhares de usuários, pois o processo de inicialização exige muito tempo. Se você sincronizar acidentalmente muitos usuários no Control Hub, a exclusão desses usuários também levará mais tempo. Clique em Salvar.
10	Na guia Grupos, você pode pesquisar grupos individuais e adicioná-los ao Webex. Clique na guia Sincronizar membros do grupo para pesquisar e selecionar todos os usuários em grupos específicos. Clique na guia Sincronizar grupos de crianças para selecionar os grupos de pais cujos filhos você deseja sincronizar. Selecionar um grupo principal sincroniza somente os usuários em seus grupos secundários. Use a guia Sincronizar membros do grupo para sincronizar o grupo principal maior. Por padrão, somente os usuários nos grupos selecionados sincronizam com o Webex. Vá para a guia Mais e selecione Sincronizar objetos do grupo se você também quiser sincronizar os próprios grupos. Você pode sincronizar até oito grupos de crianças ao mesmo tempo. Você não pode sincronizar grupos de distribuição do Entra ID no Control Hub.
11	(Opcional) Na guia Mais, você tem a opção de configurar algumas opções avançadas de sincronização: Sincronizar avatares do usuário — ative isso para permitir que o aplicativo Webex sincronize todos os avatares do usuário dentro do escopo com o Webex. Quando o avatar de um usuário é atualizado, o avatar do usuário é atualizado automaticamente no Webex. Ele pode não ser atualizado imediatamente porque depende da notificação de atualização para acionar a atualização. A atualização do avatar aparecerá no cartão de contato do usuário quando ele fizer login pela primeira vez após a alteração. Sincronizar objetos de grupo — ative isso para que os objetos de grupo selecionados na guia Grupos sejam sincronizados com o Webex. Ative o login único — ative-o para configurar o OpenID Connect (OIDC) SSO para sua organização. Se sua organização já tiver o SSO ativado usando uma das opções de SAML, você deve primeiro desabilitar a opção SAML antes de ativar o OIDC SSO no aplicativo Entra ID Wizard. Identifique e sincronize objetos da sala — ative isso para sincronizar objetos da sala com o Webex. Antes de ativar a sincronização da sala no Control Hub, verifique se todos os endereços de e-mail dos recursos da sala são exclusivos e não se sobrepõem ao seu diretório de usuário existente. Se um recurso da sala e um usuário ativo compartilharem o mesmo endereço de e-mail, o processo de sincronização converterá a conta do usuário em um objeto da sala. Essa alteração impede que o usuário faça login no Webex para mensagens, reuniões ou chamadas, pois as contas de sala não oferecem suporte à autenticação de identidade comum.
12	Você pode decidir se deseja permitir que a sincronização ocorra imediatamente ou em um estágio posterior. Se você selecionar a opção Permitir agora, ela aplicará todas as configurações à próxima sincronização. Se você selecionar a opção Salvar e permitir mais tarde, a sincronização só será iniciada quando você permitir a sincronização automática.
13	O aplicativo se comunica com o Entra ID para definir a configuração e agenda a sincronização.

Depois que a sincronização for concluída, um dos seguintes resultados aparecerá no campo Status do trabalho:

Ativo: a sincronização foi bem-sucedida.
Quarentena: o trabalho de sincronização foi colocado em quarentena no Entra ID após várias falhas. Consulte a documentação do Entra ID para obter mais informações.
NotRun: esse status aparece somente após a primeira configuração. O serviço ainda não foi executado após a primeira configuração.

Você também pode clicar em Exibir resumo para ver informações adicionais , como a hora e a data da última sincronização e o número de usuários sincronizados, ignorados ou que falharam:

Usuários

Sincronizado: mostra o número de usuários que foram sincronizados com sucesso com o Webex.
Ignorado: mostra o número de usuários que foram ignorados na última sincronização. Por exemplo, novos usuários no Entra ID que não foram adicionados ao escopo de sincronização do aplicativo Entra ID Wizard. Esses usuários não foram sincronizados com o Webex; adicione-os ao escopo de sincronização para sincronizá-los com o Webex .
Falha: mostra o número de usuários que falharam na sincronização. Consulte o registro de auditoria de provisionamento de aplicativos Entra ID para obter mais informações sobre por que esses usuários não conseguiram sincronizar. Se você precisar sincronizar esses usuários imediatamente, poderá provisionar usuários sob demanda.

Grupos

Sincronizado: mostra o número de grupos que foram sincronizados com sucesso com o Webex e criados no Control Hub.
A ser sincronizado: esse status indica que todos os usuários em um grupo ainda não foram adicionados. Os usuários devem primeiro ser sincronizados com êxito com o Webex.

Depois de configurar o aplicativo Entra ID Wizard, você pode adicionar domínios que já foram verificados no Entra ID ao Control Hub. Consulte Gerenciar seus domínios para obter mais informações.

Migre as configurações existentes do aplicativo Cisco Webex Enterprise para o aplicativo Entra ID Wizard

Se você já configurou um aplicativo Cisco Webex corporativo no Entra ID, você pode migrar todas as suas configurações para o aplicativo Entra ID Wizard automaticamente. Você pode gerenciar o Entra ID no Control Hub sem perder nenhuma das configurações anteriores.

1	Faça login no Control Hub com uma conta completa de administrador do cliente.
2	Vá para Configurações da organização e, em seguida, role para baixo até a seção Microsoft Entra ID Wizard App.
3	Clique em Configurar para iniciar a configuração.
4	Autentique a conta de administrador do Entra ID com a configuração do Entra ID. Certifique-se de usar uma conta que tenha as permissões descritas na próxima etapa.
5	Revise as permissões e clique em Aceitar para conceder à conta autorização para acessar seu inquilino Entra ID. Cisco WebexA sincronização de identidade é um aplicativo corporativo Entra ID no Entra ID. O aplicativo Wizard se conecta a esse aplicativo para acessar as APIs gráficas do Entra ID. As permissões necessárias para acessá-lo são as permissões mínimas necessárias para suportá-lo e usá-lo.
6	Selecione Migrar aplicativo existente.
7	Depois de aceitar solicitações adicionais de permissão somente para leitura, selecione o aplicativo existente que você deseja migrar para o aplicativo Wizard e selecione Continuar. Se o aplicativo existente selecionado não provisionar usuários para o mesmo Control Hub, a migração falhará.
8	Depois que a migração for concluída, recomendamos que você execute uma execução seca antes de ativar a sincronização automática para garantir que não haja erros.

Execute uma corrida a seco

Antes de ativar a sincronização automática, recomendamos que você faça uma execução seca primeiro para garantir que não haja erros. Quando a produção a seco for concluída, você poderá baixar um relatório de produção a seco para ver informações detalhadas. As colunas disponíveis no relatório são:

Tabela 1. Descrições das colunas do relatório de execução a seco
Nome da coluna	Descrição
Tipo de objeto	Tipo de objeto no Entra ID, como usuário ou grupo.
Tipo de ação	Tipo de ação que será executada no objeto durante uma sincronização. Os tipos de ação possíveis são: Combinado — O objeto corresponde ao Entra ID e ao Control Hub. Adicionar — O objeto será adicionado ao Control Hub. Desativar — O objeto está no Control Hub, mas foi removido no Entra ID ou não foi adicionado ao escopo de sincronização. Após a sincronização, o objeto será desativado.
Inserir ID	ID do objeto no Entra ID.
Insira o nome	Nome do objeto no Entra ID.
Nome Webex	Nome do objeto no Webex.
Razão	Motivo pelo qual um tipo de ação ocorrerá durante uma sincronização.

1	Faça login no Control Hub com uma conta de administrador completa.
2	Vá para Configurações da organização e, em seguida, role para baixo até a seção Sincronização de diretórios.
3	Clique nos três pontos verticais ao lado da instância que você deseja sincronizar e selecione Dry-run.
4	Quando o ensaio estiver concluído, clique em Baixar resumo para baixar o relatório como um arquivo CSV.

Desativar a sincronização do Entra ID

Pausar a sincronização entre o Control Hub e o Entra ID é simples e não afeta sua configuração existente. Você pode retomar a sincronização a qualquer momento.

Quando a sincronização é desativada, os usuários e grupos que foram sincronizados anteriormente se tornam gerenciáveis diretamente no Control Hub, assim como os usuários ou grupos adicionados manualmente. Se você reativar a sincronização, esses usuários e grupos serão ressincronizados e todas as alterações feitas enquanto a sincronização foi pausada serão substituídas pelo Entra ID.

1	Faça login no Control Hub.
2	Vá para as configurações da organização e role para baixo até o aplicativo Microsoft Entra ID Wizard.
3	Desative o botão de sincronização do Entra ID.

Ativar ou desativar a sincronização automática

O aplicativo Entra ID Wizard e seu serviço de back-end correspondente verificam se a sincronização automática está ativada para determinar quando sincronizar usuários ou grupos do Entra ID com o Webex. Ative a sincronização automática para permitir o provisionamento automático da sincronização de usuários e grupos. Quando você desativa a sincronização automática, o aplicativo Wizard não sincroniza nada com o Webex, mas a configuração existente é preservada.

Normalmente, os usuários são sincronizados a cada 40 minutos de acordo com a política da Microsoft.

Você precisa desativar a sincronização do Entra ID e não apenas a sincronização automática para fazer alterações nos usuários ou grupos sincronizados.

1	Faça login no Control Hub como administrador completo do cliente.
2	Vá para Configurações da organização e, em seguida, role para baixo até a seção Sincronização de diretórios.
3	Mude o botão para a direita para ativar a sincronização automática. Desative-o alternando o botão de sincronização automática para a esquerda.

Edite a configuração do aplicativo Entra ID Wizard

1	Faça login no Control Hub com uma conta de administrador completa.
2	Vá para Configurações da organização e, em seguida, role para baixo até a seção Sincronização de diretórios.
3	Clique em Editar configuração.
4	Personalize o mapeamento de atributos selecionando um atributo na coluna da esquerda que se origina do Entra ID. O atributo de destino no Webex Cloud está na coluna da direita. Consulte Mapeamento de atributos do aplicativo Entra ID Wizard para obter mais informações sobre mapeamento de atributos.
5	Nas guias Usuários e grupos, adicione ou remova usuários e grupos do escopo da sincronização. Os grupos aninhados não são sincronizados automaticamente com a nuvem. Certifique-se de selecionar todos os grupos que estejam aninhados nos grupos que você deseja sincronizar.
6	Na guia Mais, altere suas preferências, se necessário.
7	Clique em Salvar para salvar a configuração modificada. Suas atualizações serão aplicadas na próxima sincronização. O mecanismo de sincronização automática Entra ID lida com a sincronização de usuários e grupos de usuários.

Edite o nome da instância Webex

Altere a forma como o nome da instância Cisco Webex Identity aparece na lista de aplicativos corporativos do Entra ID.

1	Faça login no Control Hub com uma conta de administrador completa.
2	Vá para Configurações da organização e, em seguida, role para baixo até a seção Sincronização de diretórios.
3	Clique em Editar nome da instância.
4	Insira o nome da nova instância e clique em Salvar.

Exclua a configuração do aplicativo Entra ID Wizard

Quando você exclui o aplicativo Entra ID Wizard, ele remove a configuração para sincronização do Entra ID. O Webex e o Entra ID não retêm a configuração excluída. Se você quiser usar a sincronização do Entra ID no futuro, precisará fazer uma reconfiguração completa.

Não exclua o Cisco Webex aplicativo do Entra ID.

Se você fizer isso, ainda poderá configurar uma nova instância do aplicativo Entra ID Wizard, mas primeiro deverá excluir a instância do Control Hub.

1	Faça login no Control Hub com uma conta de administrador completa.
2	Vá para Configurações da organização e, em seguida, role para baixo até a seção Sincronização de diretórios.
3	Clique em Excluir instância.
4	Na instância Delete Entra ID? Na página, selecione Revogar o consentimento do administrador do Entra ID se quiser remover o contrato de consentimento do Webex. Ao selecionar essa opção, você deve inserir suas credenciais e conceder as permissões novamente.
5	Clique em Excluir.

Provisionar um usuário para o Webex sob demanda

Você pode provisionar um usuário para o Webex imediatamente, independentemente da sincronização do Entra ID, e verificar instantaneamente o resultado. Isso ajuda na solução de problemas durante a configuração.

1	Faça login no Control Hub com uma conta de administrador completa.
2	Vá para Configurações da organização e role para baixo até a seção Sincronização de diretórios.
3	Clique em Provisionar um usuário sob demanda.
4	Pesquise e selecione o usuário que você deseja provisionar e clique em Provisionar.
5	Um dos seguintes resultados aparece quando ele é concluído: Sucesso no provisionamento: O novo usuário foi criado com sucesso no Webex. Provisionamento ignorado: o provisionamento foi ignorado por algum motivo, geralmente porque o usuário já existe. Os detalhes aparecem na página de resumo dos resultados. Falha no provisionamento: o provisionamento falhou. Os detalhes aparecem na página de resumo dos resultados.
6	Clique em Tentar novamente para provisionar o mesmo usuário novamente, caso ele tenha sido ignorado ou falhado.
7	Clique em Provisionar outro usuário para retornar à página de provisionamento.
8	Clique em Concluído ao terminar.

Mapeamento de atributos do aplicativo Entra ID Wizard

O aplicativo Entra ID Wizard pode oferecer suporte e sincronizar quaisquer alterações feitas em suas expressões de atributos. Por exemplo, no Entra ID, você pode mapear o displayNamepara que ele exiba os givenNameatributos surnamee. Essas alterações aparecem no aplicativo Wizard.

Você pode encontrar mais informações sobre o mapeamento de expressões de atributos no Entra ID no site de ajuda da Microsoft.

Use a tabela a seguir para obter informações sobre atributos específicos do Entra ID.

O Entra ID não sincroniza valores nulos. Se você definir um valor de atributo como nulo no Entra ID, ele não será excluído ou corrigido com um valor nulo no Webex. Consulte as limitações no site de ajuda da Microsoft para obter mais informações.

Tabela 2. Insira a ID nos mapeamentos Webex
Inserir atributo ID (fonte)	Atributo de usuário Webex (destino)	Descrição
Atributos preenchidos por padrão
Nome principal do usuário	Nome de usuário	É a ID exclusiva do usuário no Webex. É um e-mail formatado.
Nome de exibição	Nome de exibição	Nome do usuário exibido no aplicativo Webex.
sobrenome	Nome. Nome da família
Nome dado	Nome. Nome dado
ID do objeto	ID externa	É o UID do usuário no Entra ID. Geralmente, é uma string de 16 bytes. Não recomendamos que você altere esse mapeamento.
Atributos adicionais disponíveis
Título do trabalho	título
Local de uso	endereços [digite eq “trabalho"] .país	Recomendamos usar o mapeamento Usagelocation para endereços [digite eq “work"] .country. Se você escolher outro atributo, deverá garantir que os valores dos atributos estejam em conformidade com os padrões. Por exemplo, EUA deveriam ser EUA. A China deveria ser CN, e assim por diante.
cidade	endereços [digite eq “work"] .localidade
Endereço da rua	endereços [digite eq “work"] .streetAddress
estado	endereços [digite eq “trabalho"] .região
Código postal	endereços [digite eq “work"] .postalCode
Número de telefone	Números de telefone [digite eq “trabalho"] .valor
celular	Números de telefone [digite eq “celular"] .valor
Número de telefone por fax	Números de telefone [digite eq “fax"] .valor
gerente	gerente	Sincroniza as informações do gerente dos usuários com o Webex para que os usuários sempre possam ver as informações corretas do gerente no cartão de contato do usuário. Quando um usuário é criado, o Entra ID verifica se o objeto gerenciador do usuário está no Webex Identity ou não. Se não, o atributo manager do usuário será ignorado. Se houver um atributo de gerente, duas condições devem ser atendidas para que o atributo seja exibido no cartão de contato do usuário: O objeto gerenciador é sincronizado com o Webex. O usuário membro está ativo no aplicativo Webex. Tecnicamente, ele pode acionar o evento de back-end para consultar o atributo manager do usuário periodicamente. Portanto, quando as informações do gerente do usuário são adicionadas ou alteradas, o atributo do gerente do usuário pode ser atualizado por meio do serviço acionado. Essas condições verificam a atualização do atributo manager do usuário quando o token de autenticação de um usuário expira. As alterações nos atributos do gerente não serão refletidas no cartão de contato do usuário até que ele faça login pela primeira vez após a alteração.

FAQ

Como posso migrar para o aplicativo Entra ID Wizard a partir da provisão do Cisco Directory Connector?

Durante a configuração, o aplicativo Wizard detecta se sua organização usa o Directory Connector. Se estiver habilitada, uma caixa de diálogo na qual você pode escolher usar o Entra ID e bloquear o Directory Connector. Clique em Bloquear para confirmar que você deseja continuar a configuração do aplicativo Entra ID Wizard.

Você também pode optar por desativar o Directory Connector antes de configurar o aplicativo Wizard. Após a configuração, o aplicativo Wizard gerencia os perfis de usuário. No entanto, o aplicativo Wizard gerencia somente os usuários que foram adicionados ao escopo de sincronização; você não pode usar o aplicativo Wizard para gerenciar usuários sincronizados pelo Directory Connector que não faziam parte do escopo de sincronização.

Posso configurar o logon único com o Microsoft Entra?

Você pode configurar uma integração de logon único (SSO) entre uma organização cliente do Control Hub e uma implantação que usa o Microsoft Entra ID como provedor de identidade.

Quando o avatar do usuário é atualizado no Webex?

Os avatares do usuário são sincronizados com o Webex quando o usuário é criado no Webex Identity. Essa atualização depende da atualização do avatar do usuário no Entra ID. O aplicativo Wizard então recupera o novo avatar do Entra ID. O cartão de contato do usuário é atualizado quando o usuário faz login pela primeira vez após a alteração.

Por que um usuário não aparece em um grupo no Control Hub imediatamente após a sincronização e como isso pode ser resolvido?

As sincronizações de usuários e grupos são processos independentes. Embora as sincronizações de usuários possam ocorrer separadamente, as sincronizações de grupos ocorrem automaticamente a cada 12 horas. Se um usuário estiver sincronizado por meio de um grupo, mas não aparecer imediatamente no grupo no Control Hub, esse comportamento ainda é esperado. Se um usuário aparecer somente na lista de usuários principal, mas não no grupo, nenhuma ação adicional será necessária. Basta aguardar a conclusão do próximo ciclo de sincronização do grupo.

Quando um usuário é marcado como inativo no Entra ID, o que acontece com esse usuário na minha organização Webex?

Os usuários marcados como Inativos no Entra ID também recebem essa designação no Control Hub. Usuários inativos são ignorados nas sincronizações e não serão modificados em nenhuma alteração futura no Control Hub. No entanto, os usuários inativos continuarão aparecendo na sua organização do Control Hub até que você os remova diretamente.

Cisco AI Assistant

Obrigado pelos seus comentários.