Configure o GroupTalk para o provisionamento automático de utilizadores com o Microsoft Entra ID

Este artigo descreve os passos que precisa de executar tanto no GroupTalk como no Microsoft Entra ID para configurar o provisionamento automático do utilizador. Quando configurado, o Microsoft Entra ID automaticamente provisiona e desaprovisiona utilizadores e grupos para GroupTalk usando o serviço de provisionamento Microsoft Entra. Para detalhes importantes sobre o que este serviço faz, como funciona e perguntas mais frequentes, consulte Automatizar o provisionamento e desprovisionamento de utilizadores para aplicações SaaS com Microsoft Entra ID.

Capacidades suportadas

  • Criar usuários no GroupTalk
  • Remover usuários no GroupTalk quando eles não precisarem mais de acesso
  • Mantenha os atributos do utilizador sincronizados entre o Microsoft Entra ID e o GroupTalk
  • Provisionar grupos e filiações de grupos no GroupTalk

Pré-requisitos

O cenário descrito neste artigo pressupõe que você já tenha os seguintes pré-requisitos:

Etapa 1: Planear a implementação de provisionamento

  1. Saiba mais sobre como funciona o serviço de provisionamento.
  2. Determine quem está no escopo do provisionamento.
  3. Escolha que dados mapear entre o Microsoft Entra ID e o GroupTalk.

Passo 2: Configure o GroupTalk para suportar o provisionamento com Microsoft Entra ID

  1. Contacte o Suporte do GroupTalk em support@grouptalk.com com o nome do inquilino e ID que gostaria de integrar na Microsoft Entra ID.
  2. Quando for notificado de que a configuração necessária para a sua integração com o Microsoft Entra está pronta, inicie sessão no GroupTalk Admin e navegue até à visualização da sua Organização.
  3. Um item de configuração da Integração Microsoft Entra deve ser visível. Selecione-o para verificar o nome e o ID do locatário para obter um JWT (Token Secreto).
  4. A URL do locatário do GroupTalk é https://api.grouptalk.com/api/scim/. A URL do Locatário e o Token Secreto obtidos na etapa anterior são inseridos na guia Provisionamento da sua aplicação GroupTalk.

Adicione GroupTalk da galeria de aplicações Microsoft Entra para começar a gerir o provisionamento para o GroupTalk.

  1. Selecione o botão Inscrever-se no GroupTalk , que o encaminhará para o aplicativo administrativo do GroupTalk.

  2. Se você já estiver conectado ao GroupTalk, saia para acessar a tela de login. Selecione o separador Microsoft Entra ID e selecione o botão Iniciar sessão.

    Conversa em Grupo

  3. Inicie sessão com a sua conta Administrativa do AD e aceite os direitos de acesso da aplicação GroupTalk. Você recebe uma mensagem de erro depois que isso é feito indicando que o usuário não está presente. Isso é esperado, já que seu usuário ainda não está provisionado para o GroupTalk, mas agora você adicionou o GroupTalk ao seu locatário.

  4. Volte ao portal Azure e verifique se GroupTalk foi agora adicionado às suas Aplicações Empresariais.

Saiba mais sobre como adicionar um aplicativo da galeria aqui.

Etapa 4: Definir quem está no escopo do provisionamento

O serviço de provisionamento Microsoft Entra permite-lhe definir quem é provisionado com base na atribuição à aplicação, ou com base nos atributos do utilizador 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 escopo é definido para todos os usuários e grupos, você pode especificar um filtro de escopo baseado em atributo.

  • Se precisar de funções extras, você pode atualizar o manifesto do aplicativo para adicionar novas funções.

Etapa 5: Configurar o provisionamento automático de usuários para o GroupTalk

Esta secção orienta-o pelos passos para configurar o serviço de provisionamento Microsoft Entra para criar, atualizar e desativar utilizadores e/ou grupos no TestApp com base nas atribuições de utilizadores e/ou grupos no Microsoft Entra ID.

Para configurar o provisionamento automático de utilizadores para o GroupTalk no Microsoft Entra ID:

  1. Inicie sessão no centro de administração Microsoft Entra pelo menos como Cloud Application Administrator.

  2. Navegue para Entra ID>aplicações empresariais

    Folha de aplicativos corporativos

  3. Na lista de aplicativos, selecione GroupTalk.

    Link GroupTalk na lista de Aplicações

  4. Selecione a guia Provisionamento .

    Guia Provisionamento

  5. Selecione + Nova configuração.

    Captura de ecrã da aba Aprovisionamento automático.

  6. No campo URL do Inquilino , introduza o URL do Tenant e o Token Secreto do GroupTalk. Selecione Test Connection para garantir que Microsoft Entra ID pode ligar-se ao GroupTalk. Se a ligação falhar, certifique-se de que a sua conta GroupTalk tem as permissões de administrador necessárias e tente novamente.

    Captura de ecrã da ligação de teste de provisionamento.

  7. Selecione Criar para criar a sua configuração.

  8. Selecione Propriedades na página de Visão Geral.

  9. No campo Email de notificação , digite o endereço de e-mail de uma pessoa que deve receber as notificações de erro de provisionamento e marque a caixa de seleção Enviar uma notificação por e-mail quando ocorrer uma falha .

    Captura de ecrã das propriedades de provisionamento.

  10. Selecione Mapeamento de Atributos no painel esquerdo e selecione utilizadores.

  11. Revise os atributos do utilizador que estão sincronizados de Microsoft Entra ID para GroupTalk na secção Attribute-Mapping. Os atributos selecionados como as propriedades de correspondência de são usados para corresponder às contas de usuário no GroupTalk durante as operações de atualização. Se você optar por alterar o atributo de destino correspondente , precisará garantir que a API do GroupTalk ofereça suporte à filtragem de usuários com base nesse atributo. Selecione o botão Salvar para confirmar as alterações.

    Atributo Tipo Suportado para filtragem
    nome de utilizador Cordão
    phoneNumbers[tipo igual a "telemóvel"].valor Cordão
    emails[tipo = "trabalho"].valor Cordão
    ativo booleano
    nome.dado Cordão
    nome.sobrenome Cordão
    Id externo Cordão
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:centroDeCustos Cordão
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organização Cordão
    urn:ietf:params:scim:schemas:extension:grouptalk:2.0:User:label1 Cordão
    urn:ietf:params:scim:schemas:extension:grouptalk:2.0:User:label2 Cordão
    urn:ietf:params:scim:schemas:extension:grouptalk:2.0:User:label3 Cordão
    urn:ietf:params:scim:schemas:extension:grouptalk:2.0:Utilizador:label4 Cordão
    urn:ietf:params:scim:schemas:extension:grouptalk:2.0:Utilizador:label5 Cordão
  12. Revise os atributos do grupo que estão sincronizados de Microsoft Entra ID para GroupTalk na secção Attribute-Mapping. Os atributos selecionados como propriedades de correspondência são usados para corresponder aos grupos no GroupTalk para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributo Tipo Suportado para filtragem
    nome de exibição Cordão
    Membros Referência
    Id externo Cordão
    urn:ietf:params:scim:schemas:extension:grouptalk:2.0:Group:description Cordão
  13. Para configurar os filtros de escopo, consulte as instruções fornecidas no artigo sobre filtros de alcance.

  14. 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.

  15. 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:

  1. Use os logs de provisionamento para determinar quais usuários são provisionados com ou sem êxito
  2. Verifique a barra de progresso para ver o status do ciclo de provisionamento e quão perto ele está de ser concluído
  3. Se a configuração de provisionamento parecer estar em um estado não íntegro, o aplicativo entrará em quarentena. Saiba mais sobre o estado de quarentena de provisionamento de aplicativos no artigo Estado de Quarentena de Provisionamento de Aplicativos.

Recursos adicionais