Tutorial: Configurar o Atmos para o provisionamento automático de usuário

Este tutorial descreve as etapas que devem ser seguidas no Atmos e no Microsoft Entra ID para configurar o provisionamento automático de usuários. Quando configurado, o Microsoft Entra ID provisiona e cancela o provisionamento de usuários e grupos para o Atmos automaticamente usando o serviço de provisionamento 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.

Funcionalidades com suporte

• Criar usuários no Atmos.
• Remover usuários no Atmos quando eles não precisarem mais de acesso.
• Mantenha os atributos do usuário sincronizados entre o Microsoft Entra ID e o Atmos.
• Provisionar grupos e associações a um grupo no Atmos.

Pré-requisitos

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

• Um locatário do Microsoft Entra.
• Uma das seguintes funções: Administrador de Aplicativos, Administrador de Aplicativos de Nuvem ou Proprietário do Aplicativo.
• Uma conta de usuário no Axis Security com permissões de Administrador.

Etapa 1: Planeje 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 quais dados mapear entre o Microsoft Entra ID e o Atmos.

Etapa 2: configurar o Atmos para dar suporte ao provisionamento com o Microsoft Entra ID

1. Faça logon no Console de Gerenciamento de Eixo.
2. Navegue até a tela Configurações->Provedores de Identidade.
3. Posicione o cursor sobre o Provedor de Identidade do Azure e selecione Editar.
4. Navegue até Configurações Avançadas.
5. Acesse Provisionamento Automático de Usuário (SCIM).
6. Clique em Gerar novo token.
7. Copie o Ponto de Extremidade do Provedor de Serviços do SCIM e o Token de Provisionamento do SCIM e cole-os em um editor de texto. Você precisará deles na Etapa 5.

Etapa 3: adicionar o Atmos da galeria de aplicativos do Microsoft Entra

Adicione o Atmos da galeria de aplicativos do Microsoft Entra para começar a gerenciar o provisionamento para ele. Se você já tiver configurado o Atmos para SSO, poderá usar o mesmo aplicativo. Saiba mais sobre como adicionar um aplicativo da galeria aqui.

Etapa 4: Defina quem estará no escopo de provisionamento

O serviço de provisionamento do Microsoft Entra permite definir o escopo do provisionamento com base na atribuição do aplicativo e/ou nos atributos do usuário/grupo. Se você optar por definir o escopo de provisionamento para seu aplicativo com base na atribuição, use as etapas a seguir para atribuir usuários e grupos ao aplicativo. Se optar por definir o escopo de provisionamento apenas com base nos atributos do usuário ou do grupo, use um filtro de definição de escopo, conforme descrito aqui.

• Comece pequeno. Teste com um pequeno conjunto de usuários e grupos antes de implementar para todos. Quando o escopo de provisionamento é definido para usuários e grupos atribuídos, é possível controlar isso atribuindo um ou dois usuários ou grupos ao aplicativo. Quando o escopo é definido para todos os usuários e grupos, é possível especificar um atributo com base no filtro de escopo.

• Caso você precise de mais funções, atualize o manifesto do aplicativo para adicionar novas funções.

Etapa 5: configurar o provisionamento automático de usuários no Atmos

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

Para configurar o provisionamento automático de usuários para o Atmos no Microsoft Entra ID, faça o seguinte:

1. Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.

2. Navegue até Identidade>Aplicativos>Aplicativos empresariais

   

3. Na lista de aplicativos, selecione Atmos.

   

4. Selecione a guia Provisionamento.

   

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

   

6. Na seção Credenciais do Administrador, cole o Ponto de Extremidade do Provedor de Serviços do SCIM obtido da configuração do SCIM do Axis (etapa 2) na URL do Locatário e cole o Token de Provisionamento do SCIM obtido da configuração do SCIM do Axis (etapa 2) em Token Secreto. Clique em Testar conexão para verificar se o Microsoft Entra ID pode se conectar ao Atmos. Se a conexão falhar, entre em contato com o Axis para verificar a configuração da sua conta.

   

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 marque a caixa de seleção Enviar uma notificação por email quando ocorrer uma falha.

   

8. Selecione Salvar.

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

10. Na seção Mapeamento de atributos, revise os atributos do usuário sincronizados do Microsoft Entra ID para o Atmos. Os atributos selecionados como propriedades Correspondentes são usados para fazer a correspondência entre as contas de usuário do Atmos para operações de atualização. Se você optar por alterar o atributo de destino correspondente, precisará verificar se a API do Atmos dá suporte à filtragem de usuários com base no atributo em questão. Selecione o botão Salvar para confirmar as alterações.

    Atributo	Type	Com suporte para filtragem	Necessário para o Atmos
    userName	String	✓	✓
    ativo	Boolean
    displayName	String		✓
    emails[type eq "work"].value	String
    name.givenName	String
    name.familyName	String
    externalId	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division	String

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

12. Na seção Mapeamento de atributos, revise os atributos do grupo sincronizados do Microsoft Entra ID para o Atmos. Os atributos selecionados como propriedades Correspondentes são usados para fazer a correspondência entre os grupos do Atmos para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributo	Type	Com suporte para filtragem	Necessário para o Atmos
    displayName	String	✓	✓
    membros	Referência
    externalId	String		✓

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 para o Atmos, altere o Status de provisionamento para Ativado na seção Configurações.

    

15. Defina os usuários e os grupos que deseja provisionar no Atmos escolhendo os valores apropriados em Escopo, na seção Configurações.

    

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

    

Essa operação começa o ciclo de sincronização inicial de todos os usuários e grupos definidos no Escopo na seção Configurações. O ciclo inicial leva mais tempo para ser executado do que os próximos ciclos, que ocorrem aproximadamente a cada 40 minutos, desde que o serviço de provisionamento do Microsoft Entra esteja em execução.

Etapa 6: 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 sucesso ou não
• Confira a barra de progresso para ver o status do ciclo de provisionamento e quanto falta para a 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.

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 atividade de provisionamento