Tutorial: Configurar Jellyfish para provisionamento automático de usuários

Este tutorial descreve as etapas que você precisa executar no Jellyfish e no Microsoft Entra ID para configurar o provisionamento automático de usuários. Quando configurado, o Microsoft Entra ID provisiona e desprovisiona automaticamente os usuários para Jellyfish usando o serviço de provisionamento do Microsoft Entra. Para obter detalhes importantes sobre o que esse serviço faz, como funciona e perguntas frequentes, consulte Automatizar o provisionamento e o desprovisionamento de usuários para aplicativos SaaS com o Microsoft Entra ID.

Capacidades suportadas

• Crie usuários em Jellyfish.
• Remova os usuários em Jellyfish quando eles não precisarem mais de acesso.
• Mantenha os atributos do usuário sincronizados entre o Microsoft Entra ID e Jellyfish.
• Logon único para Jellyfish (recomendado).

Pré-requisitos

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

• Um locatário do Microsoft Entra
• Uma das seguintes funções: Administrador de Aplicativos, Administrador de Aplicativos na Nuvem ou Proprietário de Aplicativos.
• Uma conta de usuário em Jellyfish com permissões de administrador.

Etapa 1: Planejar a implantação do provisionamento

• Saiba como funciona o serviço de aprovisionamento.
• Determine quem vai estar no âmbito do aprovisionamento.
• Determine quais dados mapear entre o Microsoft Entra ID e Jellyfish.

Etapa 2: Gerar credencial para provisionamento

1. Faça login no portal Jellyfish e navegue até Key Management > API Keys.

2. Clique em Gerar Novo

   

3. Procure a conta de administrador criada como parte dos pré-requisitos e clique em Criar. (Opcionalmente) defina um prazo de validade, observando que a credencial deve ser atualizada uma vez expirada.

   

4. A chave da API será baixada, certifique-se de que essa chave seja mantida segura, pois isso concederá acesso à conta de usuário para a qual foi gerada. Recomenda-se excluir a chave de API baixada assim que o provisionamento do usuário estiver configurado.

Etapa 3: Adicionar águas-vivas da galeria de aplicativos do Microsoft Entra

Adicione Jellyfish da galeria de aplicativos do Microsoft Entra para começar a gerenciar o provisionamento para Jellyfish. Se você já configurou Jellyfish 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 estará no escopo do provisionamento

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

• Comece pequeno. Teste com um pequeno conjunto de usuários antes de distribuir para todos. Quando o escopo para provisionamento é definido como usuários atribuídos, você pode controlar isso atribuindo um ou dois usuários ao aplicativo. Quando o escopo é definido para todos os usuários, você pode especificar um filtro de escopo baseado em atributo.

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

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

Esta seção orienta você pelas etapas para configurar o serviço de provisionamento do Microsoft Entra para criar, atualizar e desabilitar usuários no Jellyfish com base nas atribuições de usuário no Microsoft Entra ID.

Para configurar o provisionamento automático de usuários para Jellyfish no Microsoft Entra ID:

1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.

2. Navegue até Aplicativos de identidade>>Aplicativos corporativos

   

3. Na lista de aplicativos, selecione Águas-vivas.

   

4. Selecione o separador Aprovisionamento.

   

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

   

6. Na seção Credenciais de administrador, insira a URL do locatário que será na forma de https://< organisation.securesme.com>. Este será o mesmo endereço usado para fazer login no portal Jellyfish. Para a entrada do Token Secreto , a chave da API gerada anteriormente na etapa 2. Em seguida, clique em Autorizar, certifique-se de inserir as credenciais de administrador da sua conta Jellyfish. Clique em Testar Conexão para garantir que o Microsoft Entra ID possa se conectar a Jellyfish. Se a conexão falhar, verifique se sua conta Jellyfish tem permissões de administrador e tente novamente.

   

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

   

8. Selecione Guardar.

9. Na seção Mapeamentos, selecione Sincronizar usuários do Microsoft Entra com águas-vivas.

10. Analise os atributos de usuário sincronizados do Microsoft Entra ID para Jellyfish na seção Attribute-Mapping . Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário em Jellyfish para operações de atualização. Se você optar por alterar o atributo de destino correspondente, precisará garantir que a API Jellyfish ofereça suporte à filtragem de usuários com base nesse atributo. Selecione o botão Salvar para confirmar as alterações.

    Atributo	Type	Suportado para filtragem	Exigido por águas-vivas
    nome de utilizador	String	✓	✓
    active	Boolean		✓
    title	String
    emails[type eq "work"].value	String
    name.givenName	String
    name.familyName	String

11. Para configurar filtros de âmbito, veja as instruções seguintes disponibilizadas no Tutorial de filtro de âmbito.

12. Para habilitar o serviço de provisionamento do Microsoft Entra para Jellyfish, altere o Status de provisionamento para Ativado na seção Configurações.

    

13. Defina os usuários que você gostaria de provisionar para Jellyfish escolhendo os valores desejados em Escopo na seção Configurações .

    

14. Quando estiver pronto para provisionar, clique em Salvar.

    

Esta operação inicia o ciclo de sincronização inicial de todos os usuários definidos em Escopo na seção Configurações. O ciclo inicial leva mais tempo para ser executado do que os ciclos subsequentes, que ocorrem aproximadamente a cada 40 minutos, enquanto o serviço de provisionamento do Microsoft Entra estiver em execução.

Etapa 6: Monitorar sua implantação

Depois de configurar o aprovisionamento, utilize os seguintes recursos para monitorizar a sua implementação:

• Utilize os registos de aprovisionamento para determinar quais os utilizadores que foram aprovisionados com ou sem êxito
• Verifique a barra de progresso para ver o status do ciclo de provisionamento e quão perto ele está de ser concluído
• 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

• Gerir o aprovisionamento de contas de utilizador para Aplicações Empresariais
• O que é acesso ao aplicativo e logon único com o Microsoft Entra ID?

Próximos passos

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