Share via

Tutorial: Configurar o XM Fax e o XM SendSecure para provisionamento automático de usuários

  • Artigo

Este tutorial descreve as etapas que você precisa executar no XM Fax e XM SendSecure e 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 XM Fax e XM SendSecure usando o serviço de provisionamento 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 no XM Fax e no XM SendSecure.
  • Remova os usuários no XM Fax e no XM SendSecure quando eles não precisarem mais de acesso.
  • Mantenha os atributos do usuário sincronizados entre o Microsoft Entra ID e o XM Fax e o XM SendSecure.
  • Logon único para XM Fax e XM SendSecure (recomendado).

Pré-requisitos

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

Etapa 1: Planejar a implantação do provisionamento

Etapa 2: Configurar o XM Fax e o XM SendSecure para oferecer suporte ao provisionamento com o Microsoft Entra ID

Criar um token de acesso

  1. Na sua conta empresarial do XM Cloud, clique em Nome>da empresa Tokens de acesso.
  2. Crie um novo token de acesso com a permissão Provisionamento de usuário (usando SCIM).
  3. Copie o token de acesso. Você precisará dele como o Token Secreto no ID do Microsoft Entra.

URL do locatário

  • Para configurar o serviço de provisionamento do Microsoft Entra, você precisará da URL do locatário.

  • O URL do inquilino depende da região, do nome da sua conta enterprise e tem o seguinte esquema: https://<domain>/api/scim/v2/enterprises/<enterprise_name>/

Exemplos:

  • https://portal.xmedius.com/api/scim/v2/enterprises/acme/
  • https://portal.xmedius.eu/api/scim/v2/enterprises/my_corporation/
  • https://portal.xmedius.ca/api/scim/v2/enterprises/another_company/

Adicione XM Fax e XM SendSecure da galeria de aplicativos Microsoft Entra para começar a gerenciar o provisionamento para XM Fax e XM SendSecure. Se você configurou anteriormente o XM Fax e o XM SendSecure para SSO, poderá 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 XM Fax e XM SendSecure

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 TestApp com base nas atribuições de usuário na ID do Microsoft Entra.

Para configurar o provisionamento automático de usuários para XM Fax e XM SendSecure 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

    Captura de ecrã da folha Aplicações empresariais.

  3. Na lista de aplicativos, selecione XM Fax e XM SendSecure.

    Captura de tela do link XM Fax e XM SendSecure na lista Aplicativos.

  4. Selecione o separador Aprovisionamento.

    Captura de ecrã do separador Aprovisionamento.

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

    Captura de ecrã do separador Aprovisionamento automático.

  6. Na seção Credenciais do administrador, insira o URL do locatário XM Fax e XM SendSecure e o token secreto da Etapa 2. Clique em Testar Conexão para garantir que o Microsoft Entra ID possa se conectar ao XM Fax e ao XM SendSecure. Se a conexão falhar, verifique se a URL e o token de acesso estão corretos.

    Captura de tela do Token.

  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.

    Captura de ecrã do e-mail de notificação.

  8. Selecione Guardar.

  9. Na seção Mapeamentos, selecione Sincronizar usuários do Microsoft Entra com XM Fax e XM SendSecure.

  10. Analise os atributos de usuário sincronizados do Microsoft Entra ID para XM Fax e XM SendSecure na seção Mapeamento de Atributos . Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário no XM Fax e XM SendSecure para operações de atualização. Se você optar por alterar o atributo de destino correspondente, precisará garantir que a API XM Fax e XM SendSecure 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 pelo XM Fax e XM SendSecure
    nome de utilizador String ✓ ✓
    emails[type eq "work"].value String ✓
    active Boolean
    title String
    name.givenName String
    name.familyName String
    endereços[digite eq "trabalho"].streetEndereço String
    endereços[tipo eq "trabalho"].localidade String
    endereços[digite eq "work"].region String
    endereços[tipo eq "trabalho"].postalCode String
    endereços[tipo eq "trabalho"].country String
    phoneNumbers[type eq "work"].value String
    phoneNumbers[type eq "mobile"].value String
    phoneNumbers[digite eq "fax"].value String
    externalId String ✓
    roles[primary eq "True"].value String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization 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 XM Fax e XM SendSecure, altere o Status de provisionamento para Ativado na seção Configurações.

    Captura de tela do status de provisionamento ativado.

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

    Captura de tela do escopo de provisionamento.

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

    Captura de tela de Salvando a configuração de provisionamento.

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

Próximos passos