Configurar o PrinterLogic SaaS para provisionamento automático de usuários com o Microsoft Entra ID

Este artigo descreve as etapas que você precisa executar no PrinterLogic SaaS e no Microsoft Entra ID para configurar o provisionamento automático de usuário. Quando configurado, o Microsoft Entra ID realiza automaticamente o provisionamento e o desprovisionamento de utilizadores e grupos para o SaaS da PrinterLogic , utilizando 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

  • Criar usuários no PrinterLogic SaaS
  • Remover usuários no PrinterLogic SaaS quando eles não precisarem mais de acesso
  • Mantenha os atributos do usuário sincronizados entre o Microsoft Entra ID e o PrinterLogic SaaS
  • Provisionar grupos e afiliações a grupos no PrinterLogic SaaS
  • Início de sessão único para PrinterLogic SaaS (recomendado)
  • Autenticação com token portador de longa duração suportada.

Pré-requisitos

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

Etapa 1: Planear a implementação de 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 quais dados mapear entre o Microsoft Entra ID e o PrinterLogic SaaS.

Etapa 2: Configurar o PrinterLogic SaaS para dar suporte ao provisionamento com o Microsoft Entra ID

  1. No PrinterLogic, navegue até Definições > de Ferramentas > Gerais.

  2. Role até a seção Configurações do Provedor de Identidade.

  3. Selecione a opção SCIM .

  4. Verifique se ID do Microsoft Entra está selecionado no menu suspenso.

  5. Selecione Gerar token SCIM.

    Token Scim

  6. Copie e guarde o token Bearer. Esse valor é inserido no campo Token secreto na guia Provisionamento do seu aplicativo SaaS PrinterLogic.

  7. Insira https://gw.app.printercloud.com/{instance_name}/scim/v2 no campo URL do locatário na guia Provisionamento do seu aplicativo SaaS PrinterLogic.

Adicione PrinterLogic SaaS da galeria de aplicativos Microsoft Entra para começar a gerenciar o provisionamento para o SaaS PrinterLogic. Se você tiver configurado anteriormente PrinterLogic SaaS para SSO, você pode usar o mesmo aplicativo. No entanto, recomendamos 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 do Microsoft Entra permite definir o escopo de quem é provisionado com base na atribuição ao aplicativo ou com base nos atributos do usuário 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 usuários e grupos antes de distribuir 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 PrinterLogic SaaS

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

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

  1. Entre no centro de administração do Microsoft Entra como, no mínimo, um administrador de aplicações na nuvem.

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

    Módulo de aplicações empresariais

  3. Na lista de aplicativos, selecione PrinterLogic SaaS.

    O link do SaaS PrinterLogic na lista de aplicações

  4. Selecione o separador Aprovisionamento.

    guia de provisionamento

  5. Selecione + Nova configuração.

    Captura de ecrã da aba Aprovisionamento automático.

  6. No campo URL do Inquilino, introduza o URL do Inquilino do PrinterLogic SaaS e o Token Secreto. Selecione Testar conexão para garantir que o Microsoft Entra ID possa se conectar ao SaaS PrinterLogic. Se a ligação falhar, certifique-se de que a sua conta SaaLogic PrinterLogic 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ã da página de propriedades de Provisionamento que mostra as notificações e as configurações de eliminação.

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

  11. Analise os atributos de usuário sincronizados do Microsoft Entra ID para o PrinterLogic SaaS na seção Attribute-Mapping. Os atributos selecionados como propriedades de correspondência são usados para corresponder às contas de usuário no PrinterLogic SaaS durante operações de atualização. Se você optar por alterar o atributo de destino correspondente, precisará garantir que a API SaaS da PrinterLogic ofereça suporte à filtragem de usuários 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
    título Cordão
    nome.dado Cordão
    nome.sobrenome Cordão
    emails[tipo = "trabalho"].valor Cordão
    Id externo Cordão
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Utilizador:departamento Cordão
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Utilizador:gestor Cordão
    urn:ietf:params:scim:schemas:extension:printercloud:2.0:User:authPin Cordão
    urn:ietf:params:scim:schemas:extension:printercloud:2.0:User:authPinUser Cordão
    urn:ietf:params:scim:schemas:extension:printercloud:2.0:Utilizador:badgeId Cordão
  12. Analise os atributos de grupo que são sincronizados de Microsoft Entra ID para PrinterLogic SaaS na secção Attribute-Mapping. Os atributos selecionados como propriedades de Correspondência são usados para correspondência de grupos no PrinterLogic SaaS para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributo Tipo Suportado para filtragem
    nome de exibição Cordão ✓
    Id externo Cordão
    Membros Referência
  13. Para configurar os filtros de escopo, consulte as instruções fornecidas no artigo sobre filtros de alcance.

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

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

Recursos adicionais