Configurar o Templafy OpenID Connect para provisionamento automático de usuários com o Microsoft Entra ID

O objetivo deste artigo é demonstrar as etapas a serem executadas no Templafy OpenID Connect e no Microsoft Entra ID para configurar o Microsoft Entra ID para provisionar e desprovisionar automaticamente usuários e/ou grupos para o Templafy OpenID Connect.

Nota

Este artigo descreve um conector baseado no serviço de provisionamento de utilizadores do Microsoft Entra. Para obter detalhes importantes sobre o que esse serviço faz, como funciona e perguntas frequentes, consulte Automatizar o provisionamento e o desprovisionamento de usuários para aplicativos SaaS com o Microsoft Entra ID.

Pré-requisitos

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

- Uma conta de usuário do Microsoft Entra com uma assinatura ativa. Se ainda não tiver uma, pode criar uma conta gratuitamente. - Uma das seguintes funções: - Administrador de Aplicações - Administrador de Aplicações Cloud - Proprietário de Aplicações..

• Um Templafy inquilino.
• Uma conta de usuário no Templafy com permissões de administrador.

Etapa 1: Planejar a implantação do provisionamento

1. Saiba como funciona o serviço de aprovisionamento.
2. Determine quem faz parte do escopo de aprovisionamento.
3. Determine quais dados mapear entre o Microsoft Entra ID e o Templafy OpenID Connect.

Atribuindo usuários ao Templafy OpenID Connect

O Microsoft Entra ID usa um conceito chamado atribuições para determinar quais usuários devem receber acesso aos aplicativos selecionados. No contexto do provisionamento automático de usuários, somente os usuários e/ou grupos que foram atribuídos a um aplicativo no Microsoft Entra ID são sincronizados.

Antes de configurar e habilitar o provisionamento automático de usuários, você deve decidir quais usuários e/ou grupos no Microsoft Entra ID precisam de acesso ao Templafy OpenID Connect. Uma vez decidido, você pode atribuir esses usuários e/ou grupos ao Templafy OpenID Connect seguindo as instruções aqui:

• Atribuir um usuário ou grupo a um aplicativo corporativo

Dicas importantes para atribuir usuários ao Templafy OpenID Connect

• É recomendável que um único usuário do Microsoft Entra seja atribuído ao Templafy OpenID Connect para testar a configuração de provisionamento automático de usuário. Mais usuários e/ou grupos podem ser atribuídos posteriormente.

• Ao atribuir um usuário ao Templafy OpenID Connect, você deve selecionar qualquer função válida específica do aplicativo (se disponível) na caixa de diálogo de atribuição. Os utilizadores com a Função de Acesso Padrão são excluídos do provisionamento.

Etapa 2: Configurar o Templafy OpenID Connect para dar suporte ao provisionamento com o Microsoft Entra ID

Antes de configurar o Templafy OpenID Connect para provisionamento automático de usuários com o Microsoft Entra ID, você precisa habilitar o provisionamento SCIM no Templafy OpenID Connect.

1. Faça login no Admin Console do Templafy. Selecione Administração.

   

2. Selecione Método de autenticação.

   

3. Copie o valor da chave de API SCIM. Esse valor é inserido no campo Token secreto na guia Provisionamento do seu aplicativo Templafy OpenID Connect.

   

Passo 3: Adicionar o Templafy OpenID Connect a partir da galeria

Para configurar o Templafy OpenID Connect para provisionamento automático de usuários com o Microsoft Entra ID, você precisa adicionar o Templafy OpenID Connect da galeria de aplicativos Microsoft Entra à sua lista de aplicativos SaaS gerenciados.

Para adicionar o Templafy OpenID Connect da galeria de aplicativos do Microsoft Entra, execute as seguintes etapas:

1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.
2. Navegue até Entra ID>Enterprise apps>Novo aplicativo.
3. Na seção Adicionar da galeria, digite Templafy OpenID Connect, selecione Templafy OpenID Connect na caixa de pesquisa.
4. Selecione Templafy OpenID Connect no painel de resultados e adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.

Etapa 4: Configurar o provisionamento automático de usuários para o Templafy OpenID Connect

Esta seção orienta você pelas etapas para configurar o serviço de provisionamento do Microsoft Entra para criar, atualizar e desabilitar usuários e/ou grupos no Templafy OpenID Connect com base em atribuições de usuário e/ou grupo no Microsoft Entra ID.

Gorjeta

Você também pode optar por ativar o logon único baseado em conexão OpenID para Templafy, seguindo as instruções fornecidas no artigo Templafy Single sign-on. O logon único pode ser configurado independentemente do provisionamento automático do usuário, embora esses dois recursos se complementem.

Para configurar o provisionamento automático de usuários para o Templafy OpenID Connect no Microsoft Entra ID:

1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.

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

   

3. Na lista de aplicativos, selecione Templafy OpenID Connect.

   

4. Selecione o separador Aprovisionamento.

   

5. Defina o Modo de Aprovisionamento como Automático.

   

6. Na seção Credenciais do administrador, insira a https://scim.templafy.com/scim do locatário. Insira o valor da chave de API SCIM recuperado anteriormente em Token secreto. Selecione Testar Conexão para garantir que Microsoft Entra ID possa se conectar ao Templafy. Se a ligação falhar, certifique-se de que a sua conta Templafy tem permissões de Administrador e tente novamente.

   

7. No campo Email de notificação, digite o endereço de e-mail de uma pessoa ou grupo 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.

   

8. Selecione Guardar.

9. Na seção Mapeamentos, selecione Sincronizar usuários do Microsoft Entra com o Templafy OpenID Connect.

10. Analise os atributos de usuário sincronizados do Microsoft Entra ID para o Templafy OpenID Connect na seção Mapeamento de Atributos. Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário no Templafy OpenID Connect para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributo	Tipo	Suportado para filtragem
    nome de utilizador	Cadeia	✓
    ativo	booleano
    nome de exibição	Cadeia
    título	Cadeia
    idiomaPreferido	Cadeia
    nome.nomeProprio	Cadeia
    nome.apelido	Cadeia
    phoneNumbers[tipo eq "trabalho"].valor	Cadeia
    phoneNumbers[tipo igual a "telemóvel"].valor	Cadeia
    phoneNumbers[tipo eq "fax"].value	Cadeia
    Id externo	Cadeia
    endereços[tipo eq "trabalho"].localidade	Cadeia
    endereços[tipo eq "trabalho"].postalCode	Cadeia
    endereços[tipo eq "work"].região	Cadeia
    endereços[digite eq "trabalho"].streetEndereço	Cadeia
    endereços[tipo eq "trabalho"].país	Cadeia
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Utilizador:departamento	Cadeia
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organização	Cadeia

    Nota

    O recurso de descoberta de esquema está habilitado para este aplicativo.

11. Na seção Mapeamentos, selecione Sincronizar grupos do Microsoft Entra com o Templafy.

12. Analise os atributos de grupo sincronizados do Microsoft Entra ID para o Templafy OpenID Connect na seção Mapeamento de Atributos. Os atributos selecionados como propriedades correspondentes são usados para corresponder aos grupos no Templafy OpenID Connect 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	Cadeia	✓
    membros	Referência
    Id externo	Cadeia

    Nota

    O recurso de descoberta de esquema está habilitado para este aplicativo.

13. Para configurar filtros de escopo, consulte as instruções a seguir fornecidas no artigo Filtro de escopo .

14. Para habilitar o serviço de provisionamento do Microsoft Entra para o Templafy OpenID Connect, altere o Status de provisionamento para Ativado na seção Configurações.

    

15. Defina os usuários e/ou grupos que você gostaria de provisionar para o Templafy OpenID Connect escolhendo os valores desejados em Escopo na seção Configurações.

    

16. Quando estiver pronto para provisionar, selecione Salvar.

    

    Esta operação inicia a sincronização inicial de todos os usuários e/ou grupos definidos em Escopo na seção Configurações. A sincronização inicial leva mais tempo para ser executada do que as sincronizações subsequentes, que ocorrem aproximadamente a cada 40 minutos, enquanto o serviço de provisionamento do Microsoft Entra estiver em execução. Você pode usar a seção Detalhes da Sincronização para acompanhar o progresso e seguir os links para o relatório de atividade de provisionamento, que descreve as ações executadas pelo serviço de provisionamento do Microsoft Entra no Templafy OpenID Connect.

Etapa 5: 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 os estados de quarentena de provisionamento no artigo de status de quarentena de aplicativo de.

Registo de alterações

• 05/04/2023 - Adicionado suporte para Schema Discovery.

Mais recursos

• Gerir o aprovisionamento de contas de utilizador para Aplicações Empresariais
• O que é acesso ao aplicativo e logon único com o Microsoft Entra ID?

Conteúdo relacionado

• Saiba como analisar os registos e obter relatórios sobre a atividade de aprovisionamento