Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este artigo descreve as etapas a serem seguidas no Playvox e no Microsoft Entra ID para configurar o provisionamento automático de usuários. Quando configurado, o Microsoft Entra ID provisiona e desprovisiona automaticamente usuários ou grupos para o Playvox usando o serviço de provisionamento do Microsoft Entra. Para obter detalhes importantes sobre o que esse serviço faz e como funciona, e para perguntas frequentes, consulte Automatizar o provisionamento e o desprovisionamento de usuários para aplicativos SaaS com o Microsoft Entra ID.
Capacidades suportadas
- Crie usuários no Playvox.
- Remova os usuários no Playvox quando eles não precisarem mais de acesso.
- Mantenha os atributos do usuário sincronizados entre o Microsoft Entra ID e o Playvox.
Pré-requisitos
O cenário neste artigo pressupõe que você já tenha os seguintes pré-requisitos:
- Um tenant do Microsoft Entra.
- Uma das seguintes funções: Administrador de Aplicativos, Administrador de Aplicativos na Nuvem ou Proprietário de Aplicativos.
- Uma conta de usuário na Playvox com permissões de Super Admin.
Etapa 1: Planear o seu processo de provisionamento
Determine quem está dentro do âmbito de provisionamento.
Determine quais dados mapear entre o Microsoft Entra ID e o Playvox.
Etapa 2: Configurar o Playvox para dar suporte ao provisionamento usando o Microsoft Entra ID
Inicie sessão no console de administração da Playvox e aceda a Definições > de Chaves API.
Selecione Criar chave de API.
Insira um nome significativo para a chave da API e selecione Salvar. Depois que a chave da API for gerada, selecione Fechar.
Na chave de API que você criou, selecione o ícone Detalhes .
Copie e salve o valor BASE64 KEY . Mais tarde, no portal do Azure, insira esse valor na caixa de texto Token Secreto na guia Provisionamento do seu aplicativo Playvox.
Etapa 3: Adicionar Playvox da galeria de aplicativos do Microsoft Entra
Para começar a gerir o provisionamento para a Playvox, adicione a Playvox ao seu tenant Microsoft Entra a partir da galeria de aplicativos. Para saber mais, consulte o Guia de Início Rápido: Adicionar uma aplicação ao locatário do Microsoft Entra.
Se você configurou anteriormente o Playvox para logon único (SSO), você pode usar o mesmo aplicativo. No entanto, recomendamos que você crie um aplicativo separado ao testar a integração inicialmente.
Etapa 4: Definir quem está no escopo do provisionamento
O serviço de provisionamento do Microsoft Entra permite definir o escopo de quem é provisionado com base na atribuição ao aplicativo ou com base nos atributos do usuário ou grupo. Se você optar por definir o escopo de quem é provisionado para seu aplicativo com base na atribuição, poderá usar as etapas para atribuir usuários e grupos ao aplicativo. Se você optar por definir o escopo de quem é provisionado com base apenas nos atributos do usuário ou grupo, poderá usar um filtro de escopo.
Comece pequeno. Teste com um pequeno conjunto de usuários e grupos antes de distribuir para todos. Quando o âmbito do aprovisionamento está definido para os utilizadores e os grupos atribuídos, pode controlar isto ao atribuir um ou dois utilizadores ou grupos à aplicação. Quando o âmbito está definido para todos os utilizadores e grupos, pode especificar um filtro de âmbito baseado em atributos.
Se você precisar de funções extras, poderá atualizar o manifesto do aplicativo para adicionar novas funções.
Etapa 5: Configurar o provisionamento automático de usuários para o Playvox
Esta seção orienta você pelas etapas para configurar o serviço de provisionamento do Microsoft Entra para criar, atualizar e desabilitar usuários ou grupos, com base nas atribuições de usuário ou grupo na ID do Microsoft Entra.
Para configurar o provisionamento automático de usuários para Playvox no Microsoft Entra ID:
Entre no centro de administração do Microsoft Entra como, no mínimo, um administrador de aplicações na nuvem.
Navegue até Entra ID>Enterprise apps.
Na lista de aplicativos, procure e selecione Playvox.
Selecione o separador Aprovisionamento.
Selecione + Nova configuração.
No campo URL do Tenant, introduza o URL do Tenant Playvox e o Secret Token. Selecione Test Connection para garantir que Microsoft Entra ID pode ligar-se ao Playvox. Se a ligação falhar, certifique-se de que a sua conta Playvox tem as permissões de administrador necessárias e tente novamente.
Selecione Criar para criar a sua configuração.
Selecione Propriedades na página de Visão Geral.
Selecione o lápis para editar as propriedades. Habilite e-mails de notificação e forneça um e-mail para receber e-mails de quarentena. Ative a opção para evitar eliminação acidental. Selecione Aplicar para salvar as alterações.
Selecione Mapeamento de Atributos no painel esquerdo e selecione utilizadores.
Analise os atributos de usuário sincronizados do ID do Microsoft Entra para o Playvox na seção Mapeamento de Atributos . Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário no Playvox para operações de atualização. Se você optar por alterar o atributo de destino correspondente, certifique-se de que a API Playvox ofereça suporte à filtragem de usuários com base nesse atributo. Selecione Salvar para confirmar as alterações.
Atributo Tipo Suportado para filtragem nome de utilizador Cordão ✓ ativo booleano nome de exibição Cordão emails[tipo = "trabalho"].valor Cordão nome.dado Cordão nome.sobrenome Cordão nome formatado Cordão Id externo Cordão Para configurar filtros de escopo, consulte as instruções a seguir fornecidas no artigo Filtro de escopo.
Use provisionamento sob demanda para validar a sincronização com um pequeno número de utilizadores antes de uma implementação mais ampla na sua organização.
Quando estiver pronto para provisionar, selecione Iniciar Provisão na página de Visão Geral .
Etapa 6: Monitorar sua implantação
Depois de configurar o provisionamento, use os seguintes recursos para monitorar sua implantação:
- Use os logs de provisionamento para determinar quais usuários são provisionados com ou sem êxito
- Verifique a barra de progresso para ver o status do ciclo de provisionamento e quão perto ele está de ser concluído
- Se a configuração de provisionamento parecer estar em um estado não íntegro, o aplicativo entrará em quarentena. Saiba mais sobre os estados de quarentena de provisionamento no artigo de status de quarentena de aplicativo de.
Recursos adicionais
- Gerenciando o provisionamento de conta de usuário para aplicativos corporativos
- O que é acesso a aplicativos e logon único com o Microsoft Entra ID?