Compartilhar via

Tutorial: configurar o TheOrgWiki para provisionamento automático de usuário

  • Artigo

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

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 OrgWiki.
  • Uma conta de usuário no TheOrgWiki com permissões de administrador.

Atribuir usuários ao TheOrgWiki

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ário, decida quais usuários e/ou grupos do Microsoft Entra ID precisam ter acesso ao TheOrgWiki. Depois de decidir, será possível atribuir esses usuários e/ou grupos ao TheOrgWiki seguindo estas instruções:

Dicas importantes para atribuir usuários ao TheOrgWiki

  • Recomendamos que um só usuário do 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.

Configurar o TheOrgWiki para provisionamento

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

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

    Captura de tela do Org Wiki com o avatar do usuário e a opção Console de Administração destacada.

  2. No Console de Administração, clique na guia Configurações.

    Captura de tela do Console de Administração do The Org Wiki com a guia 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. Clique em +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 o provisionamento automático de usuário com o Microsoft Entra ID, você precisará adicioná-lo, por meio da galeria de aplicativos do Microsoft Entra, à lista de aplicativos SaaS gerenciados.

  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 TheOrgWiki e selecione TheOrgWiki no painel de resultados.

    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 logon do The Org Wiki com a opção URL destacada

  5. No canto superior direito, selecione Logon.

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

  6. Como o TheOrgWiki é um aplicativo OpenIDConnect, opte por fazer logon no OrgWiki usando sua conta corporativa da 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 a autenticação bem-sucedida, o aplicativo será adicionado automaticamente ao seu locatário e você será redirecionado à conta do TheOrgWiki.

    Adicionar SCIM do OrgWiki

Configurar o provisionamento automático de usuário para o TheOrgWiki

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

Para configurar o provisionamento automático de usuário para o TheOrgWiki 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

    Folha de aplicativos empresariais

  3. Na lista de aplicativos, selecione TheOrgWiki.

    O link do OrgWiki na lista de aplicativos

  4. Selecione a guia Provisionamento.

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

  5. Defina o Modo Provisionamento como Automático.

    Captura de tela da lista suspensa Modo Provisionamento com a opção Automático destacada.

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

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

Anotação

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

  1. Insira o valor do token no campo Token Secreto, que você recuperou anteriormente do TheOrgWiki. Clique em Testar conectividade para verificar se o Microsoft Entra ID consegue se conectar ao TheOrgWiki. Se a conexão falhar, verifique se a sua conta do TheOrgWiki tem permissões de Administrador e tente novamente.

    URL do locatário + token

  2. 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.

    Email de notificação

  3. Clique em Salvar.

  4. Na seção Mapeamentos, selecione Sincronizar usuários do Microsoft Entra com o TheOrgWiki.

  5. Revise os atributos de usuário que serão sincronizados do Microsoft Entra ID com o TheOrgWiki 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 TheOrgWiki para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributos de usuário do TheOrgWiki.

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

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

    Status do provisionamento ativado

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

    Escopo de provisionamento

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

    Salvar a configuração de provisionamento

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 demora mais para ser executada do que as posteriores. Para obter mais informações sobre o tempo necessário para o provisionamento de usuários e/ou grupos, confira Quanto tempo levará para provisionar os usuários?.

Use a seção Status Atual 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 TheOrgWiki. Para obter mais informações, consulte Verificar o status do provisionamento de usuário. Para ler os logs de provisionamento do Microsoft Entra, consulte Relatórios sobre provisionamento automático de contas de usuário.

Mais recursos

Próximas etapas