Configure Jostle para provisionamento automático de utilizadores com o Microsoft Entra ID

Este artigo descreve os passos que precisa de executar tanto no Jostle como no Microsoft Entra ID para configurar o provisionamento automático do utilizador. Quando configurado, Microsoft Entra ID automaticamente provisiona e desativa utilizadores e grupos para Jostle usando o serviço de provisionamento Microsoft Entra. Para detalhes importantes sobre o que este serviço faz, como funciona e perguntas mais frequentes, consulte Automatizar o provisionamento e desprovisionamento de utilizadores para aplicações SaaS com Microsoft Entra ID.

Capacidades suportadas

  • Criar usuários no Jostle
  • Remover usuários no Jostle quando eles não precisarem mais de acesso
  • Mantenha os atributos do utilizador sincronizados entre o Microsoft Entra ID e o Jostle
  • Logon único para Jostle (recomendado)

Pré-requisitos

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

Etapa 1: Planejar a implantação do provisionamento

  1. Saiba como funciona o serviço de aprovisionamento.
  2. Determine quem está incluído no escopo de para o provisionamento de.
  3. Determine que dados mapear entre Microsoft Entra ID e Jostle.

Passo 2: Configure o Jostle para suportar provisionamento com Microsoft Entra ID

Conta de automatização

Antes de começar, você precisará criar um usuário de automação em sua intranet do Jostle. Esta é a conta que vais usar para configurar com o Azure. Os utilizadores de automação podem ser criados em Administração Configurações > Contas de utilizador e dados > Gerir utilizadores de automação.

Para obter mais detalhes sobre usuários de automação e como criar um, consulte este artigo.

Uma vez criada, a conta de utilizador de Automação deve ser ativada (ou seja, iniciar sessão na sua intranet pelo menos uma vez) antes de poder ser usada para configurar Azure.

Gerenciar o provisionamento de usuários

Antes de começar, verifique se a assinatura da sua conta inclui recursos de SSO/provisionamento de usuários. Se isso não acontecer, você pode entrar em contato com seu Gerente success@jostle.me de Sucesso do Cliente e eles podem ajudá-lo a adicioná-lo à sua conta.

A próxima etapa é obter a URL da API e a chave da API do Jostle:

  1. Vá para a navegação principal e selecione Configurações do administrador.

  2. Em Dados do usuário de/para outros sistemas , selecione Gerenciar provisionamento de usuário . Se você não vir "Gerenciar provisionamento de usuário" aqui e tiver verificado que sua conta inclui SSO/provisionamento de usuário, entre em contato com o Suporte support@jostle.me para ter esta página ativada em suas Configurações de administrador).

  3. Na seção Detalhes da API de provisionamento de usuário , vá para o campo URL base , selecione o botão Copiar e salve a URL em algum lugar que você possa acessá-la facilmente mais tarde.

    Captura de ecrã dos detalhes da API de Provisionamento do Utilizador.

  4. Em seguida, selecione Adicionar uma nova chave... botão

  5. No ecrã seguinte, vá para o campo Usuário de Automação e use o menu suspenso para selecionar a sua conta de Usuário de Automação.

    Captura de ecrã da Conta de Integração.

  6. No campo Provisioning API key description atribui um nome à tua chave (como Azure) e depois seleciona o botão Adicionar.

  7. Assim que a sua chave for gerada, certifique-se de que a copia imediatamente e a guarda onde guardou o seu URL (uma vez que é a única vez que a sua chave aparece).

  8. De seguida, vais usar a URL API e API key para configurar a integração no Azure.

Adicione o Jostle da galeria de aplicações Microsoft Entra para começar a gerir o provisionamento para o Jostle. Se você já configurou o Jostle para SSO, você pode usar o mesmo aplicativo. No entanto, é recomendável que você crie um aplicativo separado ao testar a integração inicialmente. Saiba mais sobre como adicionar uma aplicação a partir 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 utilizadores e grupos antes de implementar 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 você precisar de funções extras, poderá atualizar o manifesto do aplicativo para adicionar novas funções.

Etapa 5: Configurar o provisionamento automático de usuários para Jostle

Esta secção orienta-o pelos passos para configurar o serviço de provisionamento Microsoft Entra para criar, atualizar e desativar utilizadores e grupos na aplicação Jostle com base nas atribuições de utilizadores e grupos no Microsoft Entra ID.

Nota

Para mais informações sobre o provisionamento automático do utilizador para o Jostle, consulte User-Provisioning-Azure-Integration.

Para configurar o provisionamento automático de utilizadores no Jostle através do Microsoft Entra ID:

  1. Inicie sessão no centro de administração Microsoft Entra pelo menos como Cloud Application Administrator.

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

    Captura de ecrã da seção de Aplicações Empresariais.

  3. Na lista de aplicativos, selecione Jostle.

    Captura de ecrã do link Jostle na lista de Candidaturas.

  4. Selecione a guia Provisionamento e selecione Introdução.

    Captura de ecrã do separador Provisionamento.

  5. Selecione + Nova configuração.

    Captura de ecrã da aba Aprovisionamento automático.

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

    Captura de ecrã da ligação de teste de provisionamento.

  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 .

    Captura de ecrã das propriedades de provisionamento.

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

  11. Revise os atributos do utilizador que estão sincronizados de Microsoft Entra ID para Jostle na secção Attribute-Mapping. Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário no Jostle para operações de atualização. Se optar por alterar o atributo alvo correspondente, precisa de garantir que a API Jostle suporta filtrar utilizadores com base nesse atributo. Selecione o botão Salvar para confirmar as alterações.

    Atributo Tipo Suportado para filtragem
    nome de utilizador Cordão
    ativo booleano
    nome.dado Cordão
    nome.sobrenome Cordão
    emails[tipo = "trabalho"].valor Cordão
    e-mails[tipo eq "pessoal"].valor Cordão
    e-mails[tipo eq "alternate1"].valor Cordão
    e-mails[tipo eq "alternate2"].valor Cordão
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:rotuloEmailAlternativo1 Cordão
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:alternateEmail2Label Cordão
  12. Para configurar os filtros de escopo, consulte as instruções fornecidas no artigo sobre filtros de alcance.

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

  14. 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 os estados de quarentena de provisionamento no artigo de status de quarentena de aplicativo de.

Mais recursos