Compartilhar via

Configurar o IMAP do Zenvoices para logon único com a ID do Microsoft Entra

Neste artigo, você aprenderá a integrar o Zenvoices IMAP à ID do Microsoft Entra. Ao integrar o Zenvoices IMAP ao Microsoft Entra ID, você poderá:

Usar o Microsoft Entra ID para controlar quem pode acessar o Zenvoices IMAP. Permita que os usuários sejam conectados automaticamente ao Zenvoices IMAP com suas contas do Microsoft Entra. Gerenciar suas contas em um local central: o portal do Azure.

Pré-requisitos

Para começar, você precisará dos seguintes itens:

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

Para configurar a integração do Zenvoices IMAP no Microsoft Entra ID, você precisa adicionar o Zenvoices IMAP por meio da galeria à sua 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é Entrar ID>Aplicativos empresariais>Novo aplicativo.

  3. Na seção Adicionar por meio da galeria, insira Zenvoices IMAP na caixa de pesquisa.

  4. Selecione Zenvoices IMAP no painel de resultados e adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.

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é Entra ID>Aplicativos empresariais>Zenvoices IMAP>Autenticação única.

  3. Execute as seguintes etapas na seção a seguir:

    1. Selecione Ir para o aplicativo.

      Captura de tela mostrando a configuração da identidade.

    2. Copie a ID do aplicativo (cliente) e use-a posteriormente na configuração do lado do Zenvoices IMAP.

      Captura de tela dos valores do cliente do aplicativo.

    3. Na guia Pontos de extremidade, copie o link Documento de metadados do OpenID Connect e use-o posteriormente na configuração do lado do Zenvoices IMAP.

      Captura de tela mostrando os pontos de extremidade na guia.

  4. Navegue até guia Autenticação no menu esquerdo e execute as seguintes etapas:

    1. Na caixa de texto URIs de Redirecionamento, digite uma URL usando o seguinte padrão: https://app.zenvoices.com/ChannelConnector/ProcessEntraIMAPAuthorizationResult

      Captura de tela mostrando os valores de redirecionamento.

    2. Selecione o botão Configurar.

  5. Navegue até a guia Certificados e segredos no menu esquerdo e execute as seguintes etapas:

    1. Vá para a guia Segredos do Cliente e selecione +Novo segredo do cliente.

    2. Insira uma Descrição válida na caixa de texto, selecione dias de Expiração na lista suspensa de acordo com suas necessidades e, em seguida, selecione Adicionar.

      Captura de tela mostrando o valor dos segredos do cliente.

    3. Depois de adicionar um segredo do cliente, um Valor será gerado. Copie o valor e use-o posteriormente na configuração do lado do Zenvoices IMAP.

      Captura de tela mostrando como adicionar um segredo do cliente.

Criar um usuário de teste do Microsoft Entra

Nesta seção, crie um usuário de teste chamado B.Simon.

  1. Entre no centro de administração do Microsoft Entra como, no mínimo, Administrador de Usuários.
  2. Navegue até Entra ID>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

Nesta seção, você permitirá que B.Simon use o logon único concedendo acesso ao Zenvoices IMAP.

  1. Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
  2. Navegue até Entra ID>aplicativos empresariais>Zenvoices IMAP.
  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.Simon na lista de Usuários e, em seguida, selecione o botão Selecionar na parte inferior da tela.
    2. Se você espera atribuir uma função aos usuários, você pode selecioná-la no menu dropdown 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 , selecione o botão Atribuir .

Configurar o SSO do Zenvoices IMAP

Para concluir a configuração da federação do OAuth/OIDC no lado do Zenvoices IMAP, é necessário enviar os valores copiados, como ID do Locatário, ID do Aplicativo e Segredo do Cliente do Entra para a equipe de suporte do Zenvoices IMAP. Eles definem essa configuração para ter a conexão do OIDC definida corretamente em ambos os lados.

  • Last updated on