Configure "Granicus Forms & Workflow" para o provisionamento automático de utilizadores com Microsoft Entra ID

Este artigo descreve os passos que deve realizar tanto no Forms & Workflow como no Microsoft Entra ID para configurar o provisionamento automático do utilizador. Quando configurado, o Microsoft Entra ID provisiona e desativa automaticamente utilizadores e grupos para Formulários e Fluxo de Trabalho usando o serviço de provisionamento Microsoft Entra. Para obter detalhes importantes sobre o que este serviço faz, como funciona e perguntas frequentes, consulte o artigo Automatize o aprovisionamento e desaprovisionamento de utilizadores para aplicações SaaS com o Microsoft Entra ID.

Capacidades suportadas

Prerequisites

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

• Um tenant Microsoft Entra
• Uma das seguintes funções: Administrador de Aplicativos, Administrador de Aplicativos na Nuvem ou Proprietário de Aplicativos.
• Uma conta de utilizador em Formulários & Fluxo de Trabalho com permissões do Proprietário da Conta.

Etapa 1: Planear o seu processo de 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 Forms & Workflow.

Passo 2: Configure Formulários e Fluxo de Trabalho para suportar o provisionamento com o ID Microsoft Entra

Este procedimento está detalhado no centro de ajuda de Formulários e Fluxo de Trabalho.

Passo 3: Adicionar Formulários e Fluxo de Trabalho a partir da galeria de aplicações Microsoft Entra

Adicione Formulários e Fluxo de Trabalho a partir da galeria de aplicações Microsoft Entra para começar a gerir o provisionamento para Formulários e Fluxo de Trabalho. Se já configurou anteriormente o Forms & Workflow para SSO, pode usar a mesma aplicação. No entanto, é recomendável que você crie um aplicativo separado ao testar a integração inicialmente. 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 âmbito está definido para todos os utilizadores e grupos, pode especificar um filtro de âmbito baseado em atributos.

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

Passo 5: Configurar o provisionamento automático do utilizador para Formulários e Fluxo de Trabalho

Esta secção guia-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 Formulários e Fluxo de Trabalho no Microsoft Entra ID:

1. Entre no centro de administração do Microsoft Entra como, no mínimo, um administrador de aplicações na nuvem.

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

   

3. Na lista de aplicações, selecione Formulários e Fluxo de Trabalho.

   

4. Selecione a guia Provisionamento .

   

5. Selecione + Nova configuração.

   

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

   

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 .

   

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

11. Revise os atributos do utilizador que estão sincronizados do Microsoft Entra ID para Formulários e Fluxo de Trabalho na secção de Mapeamento de Atributos . Os atributos selecionados como propriedades de Correspondência são usados para corresponder as contas de utilizador em Formulários e Fluxo de Trabalho para operações de atualização. Se optar por alterar o atributo-alvo correspondente, precisa de garantir que a API Forms & Workflow suporta filtragem dos utilizadores com base nesse atributo. Selecione o botão Salvar para confirmar as alterações.

    Attribute	Tipo	Suportado para filtragem	Exigido pela Forms & Workflow
    userName	String	✓	✓
    ativo	booleano		✓
    emails[tipo = "trabalho"].valor	String
    nome.dado	String		✓
    nome.sobrenome	String		✓
    externalId	String		✓

12. Revise os atributos do grupo que estão sincronizados de Microsoft Entra ID para OpenForms na secção Attribute-Mapping. Os atributos selecionados como propriedades de correspondência são usados para corresponder os grupos no OpenForms para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Attribute	Tipo	Suportado para filtragem	Exigido pela Forms & Workflow
    nome de exibição	String	✓	✓
    externalId	String		✓
    members	Reference

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 no artigo estado de quarentena de aprovisionamento de aplicativos.

Mais recursos

• Gerenciando o provisionamento de contas de usuário para aplicativos corporativos
• O que é o acesso a aplicações e o login único com Microsoft Entra ID?

Conteúdo relacionado

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