Tutorial: Configurar o Templafy SAML2 para provisionamento automático de usuários

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

Nota

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 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 tutorial pressupõe que você já tenha os seguintes pré-requisitos:

• Um locatário do Microsoft Entra.
• Um inquilino Templafy.
• 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 vai estar no âmbito do aprovisionamento.
3. Determine quais dados mapear entre o Microsoft Entra ID e o Templafy SAML2.

Atribuindo usuários ao Templafy SAML2

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 acessar o Templafy SAML2. Uma vez decidido, você pode atribuir esses usuários e/ou grupos ao Templafy SAML2 seguindo as instruções aqui:

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

Dicas importantes para atribuir usuários ao Templafy SAML2

• É recomendável que um único usuário do Microsoft Entra seja atribuído ao Templafy SAML2 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 SAML2, você deve selecionar qualquer função válida específica do aplicativo (se disponível) na caixa de diálogo de atribuição. Os usuários com a função Acesso Padrão são excluídos do provisionamento.

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

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

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

   

2. Clique em 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 SAML2.

   

Passo 3: Adicionar o Templafy SAML2 a partir da galeria

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

Para adicionar o Templafy SAML2 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é Identity>Applications>Enterprise applications>Novo aplicativo.
3. Na seção Adicionar da galeria, digite Templafy SAML2, selecione Templafy SAML2 na caixa de pesquisa.
4. Selecione Templafy SAML2 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 SAML2

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 SAML2 com base em atribuições de usuário e/ou grupo na ID do Microsoft Entra.

Gorjeta

Você também pode optar por habilitar o logon único baseado em SAML 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 do usuário, embora esses dois recursos se complementem.

Para configurar o provisionamento automático de usuários para Templafy SAML2 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 até Aplicativos de identidade>>Aplicativos corporativos

   

3. Na lista de aplicativos, selecione Templafy SAML2.

   

4. Selecione o separador Aprovisionamento.

   

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

   

6. Na seção Credenciais do administrador, insira https://scim.templafy.com/scim a URL do locatário. Insira o valor da chave de API SCIM recuperado anteriormente em Token secreto. Clique em Testar Conexão para garantir que o 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. Clique em Guardar.

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

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

    Atributo	Type	Suportado para filtragem
    nome de utilizador	String	✓
    ativo	Boolean
    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[digite eq "fax"].value	String
    externalId	String
    endereços[tipo eq "trabalho"].localidade	String
    endereços[tipo eq "trabalho"].postalCode	String
    endereços[digite eq "work"].region	String
    endereços[digite eq "trabalho"].streetEndereço	String
    endereços[tipo eq "trabalho"].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

    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 que são sincronizados do ID do Microsoft Entra para o Templafy SAML2 na seção Mapeamentos de Atributos. Os atributos selecionados como propriedades correspondentes são usados para corresponder aos grupos no Templafy SAML2 para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributo	Type	Suportado para filtragem
    displayName	String	✓
    membros	Referência
    externalId	String

    Nota

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

13. Para configurar filtros de âmbito, veja as instruções seguintes disponibilizadas no Tutorial de filtro de âmbito.

14. Para habilitar o serviço de provisionamento do Microsoft Entra para Templafy SAML2, 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 SAML2 escolhendo os valores desejados em Escopo na seção Configurações.

    

16. Quando estiver pronto para provisionar, clique em 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 monitorar o progresso e seguir os links para o relatório de atividade de provisionamento, que descreve todas as ações executadas pelo serviço de provisionamento do Microsoft Entra no Templafy SAML2.

Etapa 5: Monitorar sua implantação

Depois de configurar o aprovisionamento, utilize os seguintes recursos para monitorizar a sua implementação:

• Utilize os registos de aprovisionamento para determinar quais os utilizadores que foram aprovisionados com ou sem êxito
• Verifique a barra de progresso para ver o estado do ciclo de aprovisionamento e quão próximo está da conclusão
• 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 aqui.

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?

Próximos passos

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