Tutorial: configurar o Templafy OpenID Connect para o provisionamento automático de usuário

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

Anotação

Este tutorial descreve um conector criado sobre o serviço de provisionamento de usuário do Microsoft Entra. Para obter detalhes importantes sobre o que esse serviço faz, como ele funciona e perguntas frequentes, confira Automatizar o provisionamento e o desprovisionamento de usuários para aplicativos SaaS com o Microsoft Entra ID.

Pré-requisitos

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

• Um locatário do Microsoft Entra.
• Um locatário do Templafy.
• Uma conta de usuário no Templafy com permissões de Administrador.

Etapa 1: planejar a implantação do provisionamento

1. Saiba mais sobre como funciona o serviço de provisionamento.
2. Determine quem estará no escopo de provisionamento.
3. Determine os dados que devem ser mapeados entre o Microsoft Entra ID e o Templafy OpenID Connect.

Como atribuir 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ário, 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ário, decida quais usuários e/ou grupos do Microsoft Entra ID precisam ter acesso ao Templafy OpenID Connect. Depois de decidir isso, você poderá atribuir esses usuários e/ou grupos ao Templafy OpenID Connect seguindo estas instruções:

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

Dicas importantes para atribuir usuários ao Templafy OpenID Connect

• Recomendamos que um só usuário do Microsoft Entra seja atribuído ao Templafy OpenID Connect para testar a configuração de provisionamento automático de usuário. Outros usuários e/ou grupos podem ser atribuídos mais tarde.

• Ao atribuir um usuário ao Templafy OpenID Connect, você precisará selecionar qualquer função válida específica do aplicativo (se disponível) na caixa de diálogo de atribuição. Usuários com a função 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 o provisionamento automático de usuário com o Microsoft Entra ID, você precisará habilitar o provisionamento do SCIM nele.

1. Entre no Console de Administração do Templafy. Clique em Administração.

   

2. Clique em Método de Autenticação.

   

3. Copie o valor da Chave de API do SCIM. Esse valor será inserido no campo Token Secreto na guia Provisionamento do aplicativo Templafy OpenID Connect.

   

Etapa 3: adicionar o Templafy OpenID Connect por meio da galeria

Para configurar o Templafy OpenID Connect para o provisionamento automático de usuário com o Microsoft Entra ID, você precisará adicioná-lo à lista de aplicativos SaaS gerenciados por meio da galeria de aplicativos do Microsoft Entra.

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

1. Iniciar sessão no centro de administração do Microsoft Entra como, pelo menos, Administrador de aplicativos de nuvem.
2. Navegue até Identidade>Aplicativos>Aplicativos empresariais>Novo aplicativo.
3. Na seção Adicionar da galeria, digite Templafy OpenID Connect e selecione Templafy OpenID Connect na caixa de pesquisa.
4. Selecione Templafy OpenID Connect no painel de resultados e, em seguida, adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.

Etapa 4: configurar o provisionamento automático de usuário para o Templafy OpenID Connect

Esta seção descreve as etapas de configuração do serviço de provisionamento do Microsoft Entra para criar, atualizar e desabilitar usuários e/ou grupos no Templafy OpenID Connect com base nas atribuições de usuário e/ou grupo do Microsoft Entra ID.

Dica

Você também pode optar por habilitar o logon único baseado no OpenID Connect para o Templafy seguindo as instruções fornecidas no Tutorial de logon único do Templafy. O logon único pode ser configurado independentemente do provisionamento automático de usuário, embora esses dois recursos sejam complementares.

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

1. Iniciar sessão no centro de administração do Microsoft Entra como, pelo menos, Administrador de aplicativos de nuvem.

2. Navegue até Identidade>Aplicativos>Aplicativos empresariais

   

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

   

4. Selecione a guia Provisionamento.

   

5. Defina o Modo Provisionamento como Automático.

   

6. Na seção Credenciais de Administrador, insira https://scim.templafy.com/scim em URL do Locatário. Insira o valor da Chave de API do SCIM recuperado anteriormente em Token Secreto. Clicar em Testar conectividade para testar a conectividade entre o Microsoft Entra ID e o Templafy. Se a conexão falhar, verifique se a sua conta do Templafy tem permissões de Administrador e tente novamente.

   

7. No campo Notificação por Email, insira o endereço de email de uma pessoa ou grupo que deverá receber as notificações de erro de provisionamento e selecione a caixa de seleção - Enviar uma notificação por email quando ocorrer uma falha.

   

8. Clique em Salvar.

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

10. Revise os atributos de usuário que serão sincronizados do Microsoft Entra ID com o Templafy OpenID Connect na seção Mapeamento de atributos. Os atributos selecionados como propriedades Correspondentes são usados para fazer a correspondência das contas de usuário no Templafy OpenID Connect em operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributo	Tipo	Com suporte para filtragem
    userName	Cadeia de caracteres	✓
    ativo	Booliano
    displayName	String
    title	String
    preferredLanguage	String
    name.givenName	String
    name.familyName	String
    phoneNumbers[type eq "work"].value	String
    phoneNumbers[type eq "mobile"].value	String
    phoneNumbers[type eq "fax"].value	String
    externalId	String
    addresses[type eq "work"].locality	String
    addresses[type eq "work"].postalCode	String
    addresses[type eq "work"].region	String
    addresses[type eq "work"].streetAddress	String
    addresses[type eq "work"].country	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization	String

    Anotação

    O recurso Descoberta de Esquema está habilitado para este aplicativo.

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

12. Revise os atributos de grupo que serão 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 fazer a correspondência dos grupos no Templafy OpenID Connect em operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributo	Tipo	Com suporte para filtragem
    displayName	String	✓
    membros	Referência
    externalId	String

    Anotação

    O recurso Descoberta de Esquema está habilitado para este aplicativo.

13. Para configurar filtros de escopo, consulte as seguintes instruções fornecidas no tutorial do Filtro de Escopo.

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

    

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

    

16. Quando você estiver pronto para provisionar, clique em Salvar.

    

    Essa operação inicia a sincronização inicial de todos os usuários e/ou grupos definidos no Escopo na seção Configurações. A sincronização inicial leva mais tempo para ser executada do que as sincronizações seguintes, que ocorrem aproximadamente a cada 40 minutos, desde que o serviço de provisionamento do Microsoft Entra esteja em execução. Use a seção Detalhes da Sincronização para monitorar o progresso e siga os links para o relatório de atividades de provisionamento, que descreve todas as ações executadas pelo serviço de provisionamento do Microsoft Entra no Templafy OpenID Connect.

Etapa 5: monitorar a implantação

Depois de configurar o provisionamento, use os seguintes recursos para monitorar a implantação:

• Use os logs de provisionamento para determinar quais usuários foram provisionados com êxito ou não
• Confira a barra de progresso para ver o status do ciclo de provisionamento e saber como fechá-la para concluir
• Se a configuração de provisionamento aparentar um estado não íntegro, o aplicativo entrará em quarentena. Saiba mais sobre os estados de quarentena aqui.

Log de alterações

• 04/05/2023 – Adicionado suporte para Descoberta de Esquema.

Mais recursos

• Gerenciamento do provisionamento de conta de usuário para Aplicativos Empresariais
• O que é o acesso a aplicativos e logon único com o Microsoft Entra ID?

Próximas etapas

• Saiba como fazer revisão de logs e obter relatórios sobre a atividade de provisionamento