Configurar o TheOrgWiki para provisionamento automático de usuário com Microsoft Entra ID

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

Observação

Este artigo descreve um conector criado com base no serviço de provisionamento de usuários da 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.

Capacidades suportadas

  • Crie usuários no TheOrgWiki.
  • Remova os usuários no TheOrgWiki quando eles não precisarem mais de acesso.
  • Suporte à autenticação por token de longa duração.

Pré-requisitos

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

  • - Uma conta de usuário Microsoft Entra com uma assinatura ativa. Se você ainda não tem uma conta, é possível criar uma conta gratuita. - Uma das seguintes funções: – Administrador de Aplicativos – Administrador de Aplicativos na Nuvem – Proprietário do Aplicativo ..
  • Um tenant do OrgWiki.
  • Uma conta de usuário no TheOrgWiki com permissões de administrador.

Etapa 1: Atribuir usuários ao TheOrgWiki

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

Antes de configurar e habilitar o provisionamento automático de usuário, você deve decidir quais usuários e/ou grupos no Microsoft Entra ID precisam de acesso ao TheOrgWiki. Depois de decidir, você pode atribuir esses usuários e/ou grupos ao TheOrgWiki seguindo as instruções Atribuir um usuário ou grupo a um aplicativo empresarial.

Dicas importantes para atribuir usuários ao TheOrgWiki

  • É recomendável que um único usuário Microsoft Entra seja atribuído ao TheOrgWiki 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 TheOrgWiki, é necessário selecionar qualquer função específica ao aplicativo válida (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 TheOrgWiki para provisionamento

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

  1. Entre no Console de Administração do TheOrgWiki. Selecione o Console de Administração.

    Captura de tela do Org Wiki com o avatar do usuário e o Console do Administrador destacado.

  2. No Console de Administração, selecione a guia Configurações.

    Captura de tela do Console de Administração do The Org Wiki com a aba Configurações destacada.

  3. Navegue até Contas de Serviço.

    Captura de tela da página Contas de Serviço no Console de Administração do The Org Wiki.

  4. Selecione +Conta de Serviço. Em Tipo de Conta de Serviço, selecione Baseada em Token. Clique em Salvar.

    Captura de tela da caixa de diálogo Nova Conta de Serviço com as opções Tipo de Conta de Serviço, Baseada em Token e Salvar destacadas.

  5. Copie os Tokens Ativos. Esse valor será inserido no campo Token Secreto na guia Provisionamento do aplicativo TheOrgWiki.

    Captura de tela da caixa de diálogo Gerenciar Tokens para provisionamento do SCIM.

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

  1. Entre no centro de administração do Microsoft Entra como pelo menos um Administrador de Aplicativos em Nuvem.

  2. Navegue até Entra ID>Aplicativos corporativos>Novo aplicativo.

  3. Na seção Adicionar da galeria, digite TheOrgWiki e selecione TheOrgWiki no painel de resultados.

    Captura de tela de TheOrgWiki na lista de resultados.

  4. Selecione o botão Inscrever-se no TheOrgWiki, que redirecionará você à página de logon do TheOrgWiki.

    Captura de tela da página de login do The Org Wiki onde a URL está destacada.

  5. No canto superior direito, selecione Logon.

    Captura de tela do canto superior direito da página de logon com a opção Entrar destacada.

  6. Como TheOrgWiki é um aplicativo OpenIDConnect, escolha fazer logon no OrgWiki usando sua conta corporativa Microsoft.

    Captura de tela da página de entrada do The Org Wiki com a opção Entrar com a conta da Microsoft destacada.

  7. Após uma autenticação bem-sucedida, o aplicativo é adicionado automaticamente ao seu locatário e você será redirecionado para sua conta theOrgWiki.

    Captura de tela de Adicionar SCIM do OrgWiki.

Etapa 4: Configurar o provisionamento automático de usuário para TheOrgWiki

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

Configurar o provisionamento automático de usuário para TheOrgWiki no Microsoft Entra ID

  1. Entre no centro de administração do Microsoft Entra como pelo menos um Administrador de Aplicativos em Nuvem.

  2. Navegue até Entra ID>Enterprise apps

    Captura de tela do painel de aplicativos corporativos.

  3. Na lista de aplicativos, selecione TheOrgWiki.

    Captura de tela do link OrgWiki na lista Aplicativos.

  4. Selecione a guia Provisionamento.

    Captura de tela das opções Gerenciar com a opção Provisionamento destacada.

  5. Selecione + Nova configuração.

    Captura de tela da nova configuração.

  6. Na seção Credenciais de Administrador, insira https://<TheOrgWiki Subdomain value>.theorgwiki.com/api/v2/scim/v2/ na URL do Inquilino.

    Exemplo: https://test1.theorgwiki.com/api/v2/scim/v2/

    Observação

    O Valor de Subdomínio só pode ser definido durante o processo de inscrição inicial para o TheOrgWiki.

  7. Insira o valor do token no campo Token Secreto que você recuperou anteriormente de TheOrgWiki. Selecione Test Connection para garantir que Microsoft Entra ID possa se conectar ao TheOrgWiki. Se a conexão falhar, verifique se a sua conta do TheOrgWiki tem permissões de Administrador e tente novamente.

    Captura de tela da conexão de teste de provisionamento.

  8. Selecione Criar para criar sua configuração.

  9. Selecione Propriedades na página Visão Geral .

  10. Selecione o ícone Editar para editar as propriedades. Habilite emails de notificação e forneça um email para receber notificações de quarentena. Habilitar prevenção de exclusões acidentais. Escolha Aplicar para salvar as alterações.

    Captura de tela das propriedades de provisionamento.

  11. Selecione Mapeamento de Atributos no painel esquerdo e selecione usuários.

  12. Examine os atributos de usuário sincronizados de Microsoft Entra ID para TheOrgWiki na seção Attribute- Mapping. Os atributos selecionados como propriedades Correspondentes são usados para fazer a correspondência das contas de usuário no TheOrgWiki para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Captura de tela dos atributos de usuário TheOrgWiki. .

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

  14. Use o provisionamento sob demanda para validar a sincronização com um pequeno número de usuários antes de implantar de forma mais ampla em sua organização.

  15. Quando estiver pronto para provisionar, selecione Iniciar Provisionamento na página Visão Geral .

Etapa 5: monitorar a implantação

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

  1. Utilize os logs de provisionamento para determinar quais usuários foram provisionados com sucesso ou sem sucesso.
  2. Verifique a barra de progresso para ver o status do ciclo de provisionamento e o quão perto está da conclusão
  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 no artigo estado de quarentena de provisionamento de aplicativos.

Mais recursos