Compartilhar via

Integração do logon único do Microsoft Entra ao PoliteMail – SSO

  • Artigo

Neste tutorial, você aprenderá como integrar o PoliteMail – SSO com o Microsoft Entra ID. Ao integrar o PoliteMail – SSO com o Microsoft Entra ID, você poderá:

  • Controlar quem tem acesso ao PoliteMail – SSO no Microsoft Entra ID.
  • Permitir que seus usuários entrem automaticamente no PoliteMail – SSO com suas contas do Microsoft Entra.
  • Gerencie suas contas em um local central.

Pré-requisitos

Para integrar o Microsoft Entra ID ao PoliteMail – SSO, você precisará:

  • Uma assinatura do Microsoft Entra. Caso você não tenha uma assinatura, obtenha uma conta gratuita.
  • Assinatura habilitada para logon único (SSO) do PoliteMail – SSO.

Descrição do cenário

Neste tutorial, você vai configurar e testar o SSO do Microsoft Entra em um ambiente de teste.

  • O PoliteMail – SSO dá suporte ao SSO iniciado por SP.
  • O PoliteMail – SSO dá suporte ao provisionamento de usuário just in time.

Adicionar o PoliteMail – SSO a partir da galeria

Para configurar a integração do PoliteMail – SSO ao Microsoft Entra ID, você precisará adicionar o PoliteMail – SSO a partir da galeria à lista de aplicativos SaaS gerenciados.

  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>Novo aplicativo.
  3. Na seção Adicionar por meio da galeria, digite PoliteMail – SSO na caixa de pesquisa.
  4. Selecione PoliteMail – SSO no painel de resultados e adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.

Opcionalmente, você também pode usar o Assistente de Configuração de Aplicativos do Enterprise. Neste assistente, você poderá adicionar um aplicativo ao locatário, adicionar usuários/grupos ao aplicativo, atribuir funções e também percorrer a configuração de SSO. Saiba mais sobre os assistentes do Microsoft 365.

Configurar e testar o SSO do Microsoft Entra no PoliteMail – SSO

Configure e teste o SSO do Microsoft Entra com o PoliteMail – SSO usando um usuário de teste chamado B.Fernandes. Para que o SSO funcione, precisará estabelecer uma relação de vínculo entre um usuário do Microsoft Entra e o usuário relacionado no PoliteMail – SSO.

Para configurar e testar o SSO do Microsoft Entra com o PoliteMail – SSO, execute as seguintes etapas:

  1. Configurar o SSO do Microsoft Entra – para permitir que os usuários usem esse recurso.
    1. Crie um usuário de teste do Microsoft Entra para testar o logon único do Microsoft Entra com B.Silva.
    2. Atribuir o usuário de teste do Microsoft Entra – para permitir que B.Fernandes use o logon único do Microsoft Entra.
  2. Configurar o PoliteMail – SSO – para definir as configurações de logon único no lado do aplicativo.
    1. Criar usuário de teste do PoliteMail – SSO – para ter um equivalente a B. Fernandes no PoliteMail – SSO que esteja vinculado à representação de usuário do Microsoft.
  3. Testar o SSO – para verificar se a configuração funciona.

Configurar o SSO do Microsoft Entra

Siga estas etapas para habilitar SSO do Microsoft Entra no Centro de administração do Microsoft Entra.

  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>PoliteMail – SSO>Logon único.

  3. Na página Selecionar um método de logon único, escolha SAML.

  4. Na página Configurar o logon único com o SAML, clique no ícone de caneta da Configuração Básica do SAML para editar as configurações.

    Captura de tela que mostra como editar a Configuração Básica do SAML.

  5. Na seção Configuração básica de SAML, realize as seguintes etapas:

    a. Na caixa de texto Identificador (ID da Entidade) , digite uma URL usando o seguinte padrão: https://<YOUR_POLITEMAIL_HOSTNAME>

    b. Na caixa de texto URL de Resposta, digite uma URL nos seguintes padrões:

    URL de Resposta
    https://<YOUR_POLITEMAIL_HOSTNAME>/api/Saml2/Acs
    https://<YOUR_POLITEMAIL_HOSTNAME>/ssv3/Saml2/Acs

    c. Na caixa de texto URL de Entrada digite uma URL usando o seguinte padrão: https://<YOUR_POLITEMAIL_HOSTNAME>

    Observação

    Esses valores não são reais. Atualize esses valores com o identificador real, a URL de Resposta e a URL de Entrada. Contate a equipe de suporte do PoliteMail – SSO para obter esses valores. Consulte também os padrões mostrados na seção Configuração Básica do SAML no Centro de administração do Microsoft Entra.

  6. O aplicativo PoliteMail – SSO espera as declarações do SAML em um formato específico, o que exige que você adicione mapeamentos de atributo personalizados à configuração de atributos do token SAML. A captura de tela a seguir mostra a lista de atributos padrão.

    Captura de tela que mostra a imagem da configuração dos atributos.

  7. Além do mencionado acima, o aplicativo PoliteMail – SSO espera que mais alguns atributos (mostrados abaixo) sejam retornados na resposta do SAML. Esses atributos também são pré-populados, mas você pode examiná-los de acordo com seus requisitos.

    Nome Atributo de Origem
    função user.assignedroles

    Observação

    Clique aqui para saber como configurar a Função no Microsoft Entra ID.

  8. Na seção Certificado de Autenticação SAML, clique no botão Editar para abrir a caixa de diálogo Certificado de Autenticação SAML.

    Captura de tela que mostra como editar o Certificado de autenticação SAML.

  9. Na seção Certificado de Autenticação SAML, copie o Valor da Impressão Digital e salve-o em seu computador.

    A captura de tela mostra a cópia do valor da Impressão digital

  10. Na seção Configurar o PoliteMail – SSO do Predict360, copie as URLs apropriadas de acordo com suas necessidades.

    Captura de tela que mostra como copiar as URLs de configuração.

Criar um usuário de teste do Microsoft Entra

Nesta seção, você criará um usuário de teste chamado B.Fernandes no Centro de administração do Microsoft Entra.

  1. Entre no centro de administração do Microsoft Entra como, no mínimo, Administrador de Usuários.
  2. Navegue até Identidade>Usuários>Todos os usuários.
  3. Na parte superior da tela, selecione Novo usuário>Criar novo usuário.
  4. Nas propriedades do Usuário, siga estas etapas:
    1. No campo Nome de exibição, insira B.Simon.
    2. No campo Nome principal do usuário, insira o username@companydomain.extension. Por exemplo, B.Simon@contoso.com.
    3. Marque a caixa de seleção Mostrar senha e, em seguida, anote o valor exibido na caixa Senha.
    4. Selecione Examinar + criar.
  5. Selecione Criar.

Atribuir o usuário de teste do Microsoft Entra

Nessa seção você irá permitir que B.Simon use o logon único do Microsoft Entra concedendo acesso ao PoliteMail – SSO.

  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>PoliteMail – SSO.
  3. Na página de visão geral do aplicativo, selecione Usuários e grupos.
  4. Selecione Adicionar usuário/grupo e, em seguida, Usuários e grupos na caixa de diálogo Adicionar atribuição.
    1. Na caixa de diálogo Usuários e grupos, selecione B.Fernandes na lista Usuários e clique no botão Selecionar na parte inferior da tela.
    2. Se você estiver esperando que uma função seja atribuída aos usuários, escolha-a na lista suspensa Selecionar uma função. Se nenhuma função tiver sido configurada para esse aplicativo, você verá a função "Acesso Padrão" selecionada.
    3. Na caixa de diálogo Adicionar atribuição, clique no botão Atribuir.

Configurar o PoliteMail – SSO

Para configurar o logon único no PoliteMail – SSO, é necessário enviar o Valor da Impressão Digital e as URLs apropriadas e copiadas do centro de administração do Microsoft Entra, para a equipe de suporte do PoliteMail – SSO. Eles definem essa configuração para ter a conexão de SSO de SAML definida corretamente em ambos os lados.

Criar um usuário de teste do PoliteMail – SSO

Nesta seção, um usuário chamado B.Fernandes será criado no PoliteMail – SSO. O PoliteMail – SSO é compatível com o provisionamento just-in-time, que está habilitado por padrão. Não há itens de ação para você nesta seção. Se um usuário ainda não existir no PoliteMail – SSO, um será criado quando você tentar acessar o PoliteMail – SSO.

Testar o SSO

Nesta seção, você vai testar a configuração de logon único do Microsoft Entra com as opções a seguir.

  • Clique em Testar este aplicativo no Centro de administração do Microsoft Entra. Isso redirecionará para a URL de SSO do PoliteMail, na qual você poderá iniciar o fluxo de logon.

  • Acesse diretamente a URL do SSO do PoliteMail e inicie o fluxo de logon a partir daí.

  • Você pode usar os Meus Aplicativos da Microsoft. Ao clicar no bloco do PoliteMail - SSO em "Meus Aplicativos", você será redirecionado para a URL do SSO do PoliteMail. Para obter mais informações sobre os Meus Aplicativos, confira Introdução aos Meus Aplicativos.

Próximas etapas

Depois de configurar o SSO do PoliteMail – SSO, você poderá impor o controle de sessão, que fornece proteção contra exfiltração e infiltração dos dados confidenciais da sua organização em tempo real. O controle da sessão é estendido do acesso condicional. Saiba como impor o controle de sessão com o Microsoft Defender for Cloud Apps.