Suporte ao serviço de diretório UC conectado à nuvem Webex para Unity Connection

Visão geral

Você pode sincronizar e gerenciar usuários da nuvem Active Directory (por exemplo, Microsoft Entra ID) em uma infraestrutura de UC hospedada no local ou na nuvem, como Cisco Unified Communications Manager (Unified Communications Manager) e Cisco Unity Connection (Unity Connection) com o serviço de diretório de UC conectado à nuvem Webex. Durante a sincronização, o sistema importa uma lista de usuários e dados de usuários associados do Entra ID (ou de um serviço similar do Cloud Directory) que são sincronizados com o Webex Common Identity Service. Você deve selecionar o cluster Unity Connection do Control Hub que precisa de sincronização, selecionar o mapeamento de campo de ID de usuário do Unity Connection apropriado e, em seguida, selecionar o contrato de sincronização necessário para realizar a sincronização.

Pré-requisito

Integre os clusters do Unity Connection à UC conectada à nuvem. Consulte Configurar UC conectada à nuvem para dispositivos locais
Sincronize usuários do Entra ID no Control Hub
Os clusters do Unity Connection devem ser da versão 11.5 (1) SU9, 12.5 (1) SU4 ou 14 e posterior

Ativar serviço de diretório

Você deve ativar o Serviço de Diretório para cada cluster na UC conectada à nuvem Webex para permitir a sincronização e o gerenciamento de usuários da nuvem para o Unity Connection.

Por padrão, o Directory Service não está habilitado para todos os clusters integrados.

1	Na visualização do cliente no Control Hub, vá para Serviços > UC conectada. No cartão Gerenciamento de UC, clique em Inventário. A lista de grupos de clusters aparece com a descrição, o status, os clusters e os nós.
2	Clique em Detalhes ao lado do grupo de clusters ao qual o nó pertence. A página Inventário é exibida, mostrando a lista de clusters pertencentes ao grupo de clusters selecionado.
3	Clique em Detalhes ao lado do cluster ao qual o nó do produto específico pertence. O nome do Node com a versão, o produto e o status é exibido.
4	Clique no ícone de elipse ⎯ ao lado de Histórico de eventos e escolha Gerenciamento de serviços. A página Gerenciamento de serviços é exibida com a lista de serviços.
5	Use o botão de alternância para ativar o Serviço de Diretório.
6	Clique em Enviar.

Serviço de diretório

Use a placa Directory Service para sincronizar usuários de diretórios baseados em nuvem para o Unity Connection.

1	Na visualização do cliente no Control Hub, vá para Serviços > UC conectada.
2	Na placa Serviço de Diretório, clique em Exibir clusters. A página Serviço de Diretório é exibida.

Você pode ver a lista de detalhes do cluster nesta página.

Exibir detalhes do cluster

Na página Seleção de cluster no Serviço de Diretório, escolha um cluster com o qual você deseja sincronizar os dados do usuário.

A página de seleção de clusters também fornece os detalhes do cluster, o status do provisionamento, o último estado sincronizado, o produto associado e o motivo da falha, se houver. Você pode selecionar o fuso horário local; por padrão, o fuso horário do navegador é selecionado.

Detalhes do cluster	Descrição
Nome do cluster	O nome do cluster.
Status	Status da sincronização.
Última sincronização	Data da última sincronização.
Produto	Detalhes do produto.

Sincronização do Provision Directory Service

A sincronização do Webex Cloud-Connected UC Directory Service permite que você importe dados do usuário final do Webex Common Identity Service para o banco de dados do Unity Connection para exibir na janela Configuração do usuário final.

Certifique-se de não realizar nenhuma operação de provisionamento durante a atualização programada do módulo de UC conectado à nuvem Webex.

Caso você execute o provisionamento durante a atualização do módulo, as etapas 1, 2 ou 3 podem mostrar estados de erro após um determinado período e o botão de nova tentativa aparece após algum tempo. Você pode reiniciar o provisionamento selecionando o botão Repetir. Certifique-se de verificar o status do cluster para concluir o upgrade antes de tentar o provisionamento novamente.

Na página Seleção de cluster no Serviço de Diretório, escolha um cluster que você deseja provisionar para ativar a sincronização.

Clique em Iniciar provisionamento.

Na janela de configuração do Field Mapping, certifique-se de que o mapeamento escolhido para o campo ID de usuário do Unity Connection identifique exclusivamente o usuário dentro do cluster depois de iniciar o provisionamento.

Escolha o mapeamento de campo de ID de usuário do Unity Connection apropriado para sincronizar o usuário a partir do Webex:

O campo ID do usuário no Unity Connection é mapeado para o ID de e-mail do usuário no Webex.
O campo ID de e-mail no Unity Connection é mapeado para o ID de e-mail do usuário no Webex.
O campo ID do usuário no Unity Connection mapeia para o ID de e-mail sem a parte do domínio do usuário no Webex.

Uma nova conta de usuário será criada se o mapeamento não puder ser feito com êxito para uma conta de usuário existente no Unity Connection. O ID de e-mail (ou a parte de ID do ID de e-mail) do usuário será usado como identificador exclusivo para a conta de usuário recém-criada.

Clique em Avançar.

Selecione um contrato na lista suspensa para criar um novo contrato de sincronização.

Depois que o novo contrato de sincronização for criado, todos os contratos de sincronização existentes apontando para o diretório local serão excluídos. Você pode fazer alterações no novo contrato de sincronização após sua criação.

Na seção Pré-visualização do contrato, revise os detalhes do contrato (detalhes do diretório LDAP externo existente disponíveis no Unity Connection) antes de iniciar a sincronização.

Você pode ver os seguintes detalhes:

Informações do grupo
Modelo de grupo de recursos aplicados com modelos universais de linha e dispositivo
Detalhes de linha e máscara para números de telefone sincronizados para usuários inseridos
Usuários recém-provisionados e suas extensões

Seção Campos de usuário padrão a serem sincronizados. Os seguintes campos de usuário são sincronizados do Webex Common Identity Service para o Unity Connection:

Campos de usuário do Unity Connection sincronizados	Campos de usuário do Webex Common Identity Service sincronizados
ID de usuário	O nome de usuário é sincronizado se a opção “O campo ID do usuário no Unity Connection mapeia a ID de e-mail do usuário no Webex” for escolhida.
	ID de usuário existente (ID de e-mail no Unity Connection) do banco de dados do Unity Connection que corresponde ao ID de e-mail no Webex Common Identity Service se a opção “ID de e-mail no Unity Connection mapear para a ID de e-mail do usuário no Webex” for escolhida.
	ID de e-mail sem a parte do domínio se a opção “O campo ID do usuário no Unity Connection mapeia a ID de e-mail sem a parte do domínio do usuário no Webex” for escolhida.
Primeiro nome	Nome. Nome dado
Último nome	Nome. Nome da família
Nome de exibição	Nome de exibição
Número de telefone	Números de telefone. Trabalho
Número de celular	Números de telefone. Celular
ID de e-mail	e-mails
Título	título

Nome do host ou endereço IP do servidor de diretórios

Clique em Avançar para selecionar o filtro de grupo.

Na lista suspensa Selecionar grupos, selecione o (s) grupo (s) específico (s) que você deseja sincronizar. Clique na caixa de seleção Selecionar todos os grupos se quiser selecionar todos os grupos de usuários.

Por padrão, todos os usuários são sincronizados. Se você não selecionar nenhum grupo, todos os usuários e dados de usuários associados serão sincronizados automaticamente.

Para grupos aninhados em um diretório, os usuários devem selecionar o grupo de usuários do subconjunto especificamente durante o provisionamento, pois eles não são incluídos por padrão no grupo principal. Você precisa verificar se há algum aninhamento repetitivo (se houver) para garantir que somente os usuários necessários sejam incluídos durante o provisionamento.

Qualquer modificação no contrato de sincronização, por exemplo, a remoção de um usuário ou grupo alvo, não será propagada durante a sincronização periódica. Você deve desabilitar o Serviço de Diretório desse cluster no Control Hub e, em seguida, reprovisionar o cluster novamente com o contrato de sincronização novo ou modificado.

Clique em Avançar para preparar o processo de sincronização.

Na janela Ativar sincronização, ative a sincronização quando o sistema copiar com êxito os dados do usuário em um espaço de armazenamento temporário no Unity Connection e um novo contrato de sincronização for criado (após as etapas 1 e 2, conforme mostrado na captura de tela abaixo).

A opção Baixar relatório de download permite que você visualize parcialmente os resultados. Para obter os relatórios completos do cluster Unity Connection, execute o seguinte comando CLI: file get activelog /cm/trace/CIService/log4j/DryRunResults.csv. Aqui, o resultado da execução a seco do Unity Connection mostra o seguinte:

Para implantações de Fresh Entra ID:

Novos usuários — Os usuários não estão presentes no Cisco Unified CM banco de dados no servidor Unity Connection, mas estão presentes no Webex Identity Service.
Usuários correspondentes — Os usuários estão presentes no Cisco Unified CM banco de dados no servidor Unity Connection e no Webex Identity Service.
Usuários combinados CUC — Usuários presentes no Webex Identity Service e importados no 'Unity Connection Database' no nó Unity Connection.
Usuários incompatíveis — Os usuários estão presentes no Cisco Unified CM banco de dados no servidor Unity Connection e não estão presentes no Webex Identity Service.

Para que o AD local insira migrações de ID:

As configurações do CCUC Directory Sync não serão migradas. Você precisa provisionar o CCUC Directory Sync na região de destino após a migração.

O campo ID do usuário no Unity Connection é mapeado para o ID de e-mail do usuário no Webex. Todos os campos do relatório de execução a seco são iguais às implantações do Fresh Entra ID.
O campo ID de e-mail no Unity Connection é mapeado para o ID de e-mail do usuário no Webex. Todos os campos do relatório de execução a seco são iguais às implantações do Fresh Entra ID.
O campo ID do usuário no Unity Connection mapeia para o ID de e-mail sem a parte do domínio do usuário no Webex:
- Novos usuários — Usuários com ID de usuário sem parte de domínio não estão presentes no Cisco Unified CM banco de dados no servidor Unity Connection, mas estão presentes no Webex Identity Service.
- Usuários correspondentes — Usuários com ID de usuário sem parte de domínio estão presentes no Cisco Unified CM banco de dados no servidor Unity Connection e no Webex Identity Service.
- Usuários combinados CUC — Usuários com ID de usuário sem parte de domínio estão presentes no Webex Identity Service e importados no 'Unity Connection Database' no nó Unity Connection.
- Usuários incompatíveis — Usuários com ID de usuário sem parte de domínio estão presentes no Cisco Unified CM banco de dados no servidor Unity Connection e não estão presentes no Webex Identity Service.

Você pode verificar o relatório e decidir se deseja manter a mesma lista de usuários e adicionar ou excluir usuários. Com base na decisão, você pode interromper o processo e reverter as alterações de provisionamento.

Todas as atualizações feitas nos dados do usuário no diretório da nuvem após a sincronização de diretórios serão atualizadas no próximo período de sincronização. Isso ocorre porque o diretório da nuvem é sincronizado periodicamente uma vez por dia.

Após a verificação do contrato de sincronização, clique em Visualizar no Unity Connection para entrar na sua infraestrutura local e fazer alterações no contrato de sincronização recém-criado.

É necessário acesso à VPN.

Marque a caixa de seleção para concordar com os termos em que o contrato de sincronização é revisado e verificado no Unity Connection.

Clique em Ativar sincronização para continuar com a sincronização.

Durante a sincronização, você não poderá realizar nenhuma ação até a conclusão. Depois que a sincronização for concluída para um cluster específico, a página Serviço de Diretório lista esse cluster com um estado Provisionado. Neste ponto, você autorizou com sucesso a Entra ID a provisionar e sincronizar usuários Webex na infraestrutura de UC e concluiu as etapas para configurar a sincronização.

Depois que o provisionamento inicial for concluído, a sincronização periódica acontece a cada 24 horas. Qualquer alteração feita no diretório da nuvem será propagada para os clusters durante esse período.

Você deve ativar a sincronização dentro de 20 horas a partir do momento em que o novo contrato for criado. Os usuários sincronizados com LDAP ficam inativos e são removidos após 24 horas de inatividade. Os usuários não poderão fazer login e usar os serviços do Unity Connection.

Depois que o provisionamento do Entra ID for concluído para um determinado cluster, você não poderá criar novos contratos de sincronização nem modificar nenhuma configuração para o mesmo cluster, exceto as configurações do grupo. Se você quiser criar um novo contrato de sincronização para o mesmo cluster, acesse a página Gerenciamento de Serviços e desative o Serviço de Diretório. Em seguida, você pode criar um novo contrato para provisionamento.

Se a sincronização falhar por qualquer motivo, as últimas alterações de provisionamento serão refletidas no próximo período de sincronização no dia seguinte.

Se você estiver usando o Entra ID IdP durante a autenticação SSO após o provisionamento bem-sucedido, certifique-se de configurar as reivindicações corretas no Entra ID IdP. Por exemplo, durante o provisionamento, se a opção 1 for selecionada para o mapeamento do ID do usuário, certifique-se de que user.userprincipalname esteja definido como o UID na seção “Declarações adicionais”.

Os seguintes atributos são sincronizados do Webex Common Identity Service para o Unity Connection:

Campos de usuário do Unity Connection sincronizados	Campos de usuário do Webex Common Identity Service sincronizados
ID de usuário	O nome de usuário é sincronizado se a opção “O campo ID do usuário no Unity Connection mapeia a ID de e-mail do usuário no Webex” for escolhida.
	ID de usuário existente (ID de e-mail no Unity Connection) do banco de dados do Unity Connection que corresponde ao ID de e-mail no Webex Common Identity Service se a opção “ID de e-mail no Unity Connection mapear para a ID de e-mail do usuário no Webex” for escolhida.
	ID de e-mail sem a parte do domínio se a opção “O campo ID do usuário no Unity Connection mapeia a ID de e-mail sem a parte do domínio do usuário no Webex” for escolhida.
Primeiro nome	Nome. Nome dado
Último nome	Nome. Nome da família
Nome de exibição	Nome de exibição
Número de telefone	Números de telefone. Trabalho
Número de celular	Números de telefone. Celular
ID de e-mail	e-mails
Título	título

Todas as atualizações feitas nos dados do usuário no diretório da nuvem após a sincronização de diretórios serão atualizadas no próximo período de sincronização. Isso ocorre porque o diretório da nuvem é sincronizado periodicamente uma vez por dia.
O logon único (SSO) deve ser usado para logins. Este documento aborda somente a integração de logon único (SSO).
Após o reprovisionamento, se você perceber que os usuários marcados como Usuários incompatíveis são iguais aos Novos Usuários (usuários que compartilham o mesmo ID de e-mail), recomendamos que você aguarde no máximo 48 horas para que as alterações de sincronização entrem em vigor.
1. Desative o Serviço de Diretório na página Gerenciamento de Serviços no Control Hub.
2. Desative a caixa de seleção Ativar sincronização do servidor LDAP no sistema LDAP.
3. Ative o Serviço de Diretório na página Gerenciamento de Serviços no Control Hub.

Status da provisão

No painel do Serviço de Diretório, você pode visualizar e rastrear o status do seu cluster e revisar os erros.

A tabela a seguir lista o status da provisão, a descrição e as ações correspondentes.

Tabela 1. Status de provisionamento
Status da provisão	Descrição
Processando	O provisionamento está em andamento.
Ação necessária	Execute as etapas necessárias se houver alguma intervenção manual necessária para um cluster específico. Por exemplo, Se você quiser continuar ou abandonar a sincronização após a execução a seco. Depois que o novo contrato for criado, verifique se há notificações e tome as medidas necessárias conforme necessário.
Erro	Se houver alguma ação necessária no assistente “Ativar sincronização”, verifique-a e, se necessário, execute as ações necessárias. No caso de erros durante qualquer estágio do provisionamento, o administrador deve auditar a página Histórico de Eventos do serviço: Serviço Cisco Webex Control Hub de Diretório. Isso ajuda você a isolar, depurar e solucionar os possíveis problemas. Para acessar eventos, consulte Acessar o histórico de eventos para serviços híbridos. Para obter mais informações sobre os vários tipos de eventos e seus detalhes, consulte a tabela “Eventos e possíveis resoluções” abaixo.
Provisionado	O provisionamento do cluster foi concluído.
Não provisionado	O provisionamento do cluster ainda não começou.

Tabela 2. Eventos e resoluções
Eventos	Ação necessária
Falha na sincronização periódica	Certifique-se de aguardar a conclusão da sincronização periódica do dia seguinte. Verifique se a sincronização foi concluída com êxito. Se o problema persistir, entre em contato com o Cisco TAC suporte.
Falha na cópia de dados	Clique no botão Tentar novamente para continuar a transferência de dados. Se o problema persistir, entre em contato com o Cisco TAC suporte.
Falha no contrato de sincronização	Clique no botão Repetir para tentar novamente a criação do contrato de sincronização. Se o problema persistir, entre em contato com o Cisco TAC suporte.
Ignorando a sincronização periódica	Nenhuma ação é necessária.
Falha na transferência de dados	Clique no botão Tentar novamente para continuar a transferência de dados. Se o problema persistir, entre em contato com o Cisco TAC suporte.
Sincronização de usuário incompatível	Verifique os registros de sincronização de diretórios no Unity Connection em busca de erros na sincronização do usuário ou entre em contato com o Cisco TAC suporte para obter mais assistência.
Usuários provisionados com sucesso	Nenhuma ação é necessária.
Transferência periódica de dados de sincronização bem-sucedida	Nenhuma ação é necessária.
Falha ao obter detalhes do usuário de alguns dos grupos selecionados do Webex Common Identity.	Navegue até o Painel e selecione o cluster para obter os detalhes dos grupos com falha clicando no link de download fornecido. Verifique se os usuários estão presentes no Webex Common Identity e clique em Repetir. Entre em contato com o Cisco TAC suporte para obter mais assistência.
Falha ao obter detalhes do usuário de todos os grupos selecionados do Webex Common Identity.	Clique no botão Tentar novamente para continuar a transferência de dados. Se o problema persistir, entre em contato com o Cisco TAC suporte para obter mais assistência.

Importar usuários para o Unity Connection

Você pode importar usuários do Entra ID manualmente de Importar usuários Cisco Unity Connection depois que o provisionamento do cluster for feito a partir do Control Hub.

As duas formas de importar usuários são as seguintes:

Crie usuários do Unity Connection a partir dos dados do Entra ID usando a ferramenta Importar usuários

Em Cisco Unity Connection Administração, expanda Usuários e selecione Importar usuários.

Na página Importar usuários, importe as contas de usuário do Entra ID para criar usuários do Unity Connection.

Selecione Diretório LDAP no campo Localizar usuários finais em.
Selecione o modelo no qual o novo usuário se baseia.
Especifique o alias, o nome ou o sobrenome das contas de usuário do Entra ID que você deseja importar.
Marque as caixas de seleção nas contas de usuário que você deseja importar e selecione Importar selecionadas.

Crie usuários do Unity Connection a partir dos dados do Entra ID usando a ferramenta Bulk Administration

Em Cisco Unity Connection Administração, expanda Ferramentas e selecione Ferramenta de administração em massa.

Para adicionar usuários do Unity Connection, execute as seguintes etapas na página Bulk Administration Tool:

Em Selecionar operação, selecione Exportar.
Em Selecionar tipo de objeto, selecione Usuários do diretório LDAP.
Insira os valores em todos os campos obrigatórios.
Selecione Enviar.

Isso cria um arquivo CSV com os dados do usuário do Entra ID. Abra o arquivo CSV em um aplicativo de planilha ou editor de texto e edite os dados conforme aplicável. Agora, importe os dados do arquivo CSV.
Em Selecionar operação, selecione Criar.
Em Selecionar tipo de objeto, selecione Usuários com caixa de correio.
Insira os valores em todos os campos obrigatórios.
Selecione Enviar.

Quando a importação estiver concluída, revise o arquivo que você especificou no campo Nome do Arquivo de Objetos com Falha para verificar se todos os usuários foram criados com êxito.

Solução de problemas de sincronização

Esta seção fornece as informações e soluções necessárias para resolver alguns dos problemas comuns que você pode enfrentar durante os vários estágios de sincronização de usuários do Control Hub no banco de dados do Unity Connection.

Usuários incompatíveis

Se você encontrar usuários incompatíveis, ative a sincronização dentro de 20 horas após a criação do novo contrato. Os usuários existentes são marcados como inativos e excluídos Unified CM após 24 horas de inatividade.

Erro — Falha na cópia de dados. Por favor, tente novamente

A comunicação entre a UC conectada à nuvem e a nuvem Webex é interrompida ou não é possível obter dados do usuário da nuvem Webex.

Solução: Para confirmar se sua conectividade foi bem-sucedidaCisco Cloud, verifique o status desses serviços em: https://status.webex.com/. Clique em Tentar novamente.
A comunicação entre a UC conectada à nuvem e o Unity Connection é interrompida ou não é possível enviar os dados do usuário para o banco de dados do Unity Connection.

Solução: verifique a conectividade de rede entre a UC conectada à nuvem e o Unity Connection e clique em Repetir. Se o problema persistir, entre em contato com o Cisco TAC suporte.

Erro — Falha ao criar o contrato de sincronização. Por favor, tente novamente

A comunicação entre a UC conectada à nuvem e o Unity Connection é interrompida ou não é possível enviar os dados do contrato de sincronização para o banco de dados do Unity Connection.

Solução: verifique a conectividade de rede entre a UC conectada à nuvem e o Unity Connection e clique em Repetir. Se o problema persistir, entre em contato com o Cisco TAC suporte.
O contrato de sincronização não foi criado com sucesso.

Erro — Falha ao ativar a sincronização de diretórios. Por favor, tente novamente

A comunicação entre a UC conectada à nuvem e o Unity Connection é interrompida e o serviço Cisco DirSync não é acionado.

Solução: verifique a conectividade de rede entre a UC conectada à nuvem e o Unity Connection e clique em Repetir. Se o problema persistir, entre em contato com o Cisco TAC suporte.

Não foi possível obter os detalhes do contrato de sincronização. Por favor, tente depois de algum tempo.

A comunicação entre a UC conectada à nuvem e o Unity Connection é interrompida.

Solução: verifique a conectividade de rede entre a UC conectada à nuvem e o Unity Connection e clique em Repetir. Se o problema persistir, entre em contato com o Cisco TAC suporte.

Falha ao buscar dados do usuário para grupos selecionados

Durante o primeiro provisionamento, você pode encontrar problemas ao baixar dados do usuário de qualquer um dos grupos específicos que você selecionou para sincronização. Na mensagem de erro, clique no link de download para ver os detalhes das informações do grupo que falhou.

Você também pode baixar informações de grupos com falha para clusters que já estão provisionados na página Histórico de eventos em. Cisco Webex Control Hub Navegue até o Painel e selecione o cluster para obter os detalhes dos grupos com falha clicando no link de download fornecido. Verifique se os usuários estão presentes no Webex Common Identity e clique em Repetir. Entre em contato com o Cisco TAC suporte para obter mais assistência.

Problemas e limitações conhecidos do Unity Connection

Se você estiver enfrentando um problema com esse recurso, verifique se é algo que já conhecemos e se há uma solução alternativa recomendada.

Você pode desabilitar o Serviço de Diretório para um cluster do Control Hub e, em seguida, reativar o cluster novamente. Recomendamos que você espere pelo menos 60 segundos antes de ativar o Serviço de Diretório para sincronização.
Após a exclusão, caso deseje integrar novamente o mesmo cluster do Unity Connection à organização, você deve primeiro desabilitar o Serviço de Diretório e, em seguida, provisionar novamente o mesmo cluster.
Durante o provisionamento, a lista de detalhes do grupo não é preenchida devido a problemas de sincronização com o Webex Common Identity Service. Recomenda-se que os usuários abandonem o provisionamento e tentem novamente após algum tempo.

Cisco AI Assistant

Obrigado pelos seus comentários.