Tutorial: integração do Microsoft Entra ao Help Scout

  • Artigo

Neste tutorial, você aprenderá a integrar o Help Scout ao Microsoft Entra ID. Ao integrar o Help Scout ao Microsoft Entra ID, será possível:

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

Pré-requisitos

Para configurar a integração do Microsoft Entra ao Help Scout, você precisará dos seguintes itens:

  • Uma assinatura do Microsoft Entra. Caso você não tenha uma assinatura, obtenha uma conta gratuita.
  • Assinatura habilitada para logon único do Help Scout.

Descrição do cenário

Neste tutorial, configure e teste o logon único do Microsoft Entra em um ambiente de teste.

  • O Help Scout dá suporte ao SSO iniciado por SP e IdP.
  • O Help Scout dá suporte ao provisionamento de usuário Just-In-Time.

Para configurar a integração do Help Scout com o Microsoft Entra ID, você precisará adicionar o Help Scout à sua lista de aplicativos SaaS gerenciados por meio da galeria.

  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 Help Scout na caixa de pesquisa.
  4. Selecione Help Scout 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ê pode adicionar um aplicativo ao seu locatário, adicionar usuários/grupos ao aplicativo, atribuir funções, bem como percorrer a configuração de SSO. Saiba mais sobre os assistentes do Microsoft 365.

Configurar e testar o SSO do Microsoft Entra para o Help Scout

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

Para configurar e testar o SSO do Microsoft Entra para o Help Scout, 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 SSO do Help Scout – para definir as configurações de logon único no lado do aplicativo.
    1. Criar um usuário de teste do Help Scout – para ter um equivalente de B. Fernandes no Help Scout que esteja vinculado à representação de usuário do Microsoft Entra.
  3. Testar o SSO – para verificar se a configuração funciona.

Configurar o SSO do Microsoft Entra

Siga estas etapas para habilitar o SSO 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>Help Scout>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.

    Edit Basic SAML Configuration

  5. Na seção Configuração básica do SAML, execute as etapas a seguir caso deseje configurar o aplicativo no modo IDP iniciado:

    a. Identificador é o URI do Público-alvo (ID da Entidade do Provedor de Serviços) do Help Scout e começa com urn:

    b. URL de Resposta é a URL de Postback (URL do Serviço do Consumidor de Declaração) do Help Scout e começa com https://

    Observação

    Os valores nessas URLs são apenas para demonstração. Atualize esses valores com a URL de Resposta e o Identificador reais. Você obtém esses valores da guia Logon único na seção de Autenticação, que é explicada posteriormente no tutorial.

  6. Clique em Definir URLs adicionais e execute o passo seguinte se quiser configurar a aplicação no modo SP iniciado:

    Na caixa de texto URL de Logon, digite a URL: https://secure.helpscout.net/members/login/

  7. Na página Configurar logon único com SAML, na seção Certificado de Autenticação SAML, clique em Fazer o download para fazer o download do Certificado (Base64) usando as opções fornecidas de acordo com seus requisitos e salve-o no computador.

    The Certificate download link

  8. Na seção Configurar o Help Scout, copie as URLs apropriadas de acordo com suas necessidades.

    Copy configuration URLs

Criar um usuário de teste do Microsoft Entra

Nesta seção, você criará um usuário de teste chamado B.Fernandes.

  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

Nesta seção, você permitirá que B. Fernandes use o logon único, concedendo acesso ao Help Scout.

  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>Help Scout.
  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 SSO do Help Scout

  1. Em outra janela do navegador da Web, entre em seu site de empresa do Help Scout como administrador

  2. Clique em Gerenciar no menu superior e, em seguida, selecione Empresa no menu suspenso.

    Screenshot shows the Manage menu with Company selected.

  3. Selecione Autenticação no painel de navegação à esquerda.

    Screenshot shows Authentication selected.

  4. Isso direciona-o à seção de configurações do SAML e executa as seguintes etapas:

    Screenshot shows the Single Sign-On tab where you enter the specified information.

    a. Copie o valor da URL de Postback (URL do Serviço do Consumidor de Declaração) e cole o valor na caixa de texto URL de Resposta na seção Configuração Básica do SAML.

    b. Copie o valor do URI do Público-alvo (ID da Entidade do Provedor de Serviços) e cole-o na caixa de texto Identificador na seção Configuração Básica do SAML.

  5. Ative a opção Habilitar SAML e execute as seguintes etapas:

    Screenshot shows the Single Sign-On tab where you enable SAML and add other information.

    a. Na caixa de texto URL de Logon Único, cole o valor da URL de Logon.

    b. Clique em Carregar Certificado para carregar o Certificado(Base64) baixado anteriormente.

    c. Insira os domínios de email de sua organização, por exemplo: contoso.com na caixa de texto Domínios de Email. Você pode separar múltiplos domínios com uma vírgula. A qualquer momento um Administrador ou Usuário do Help Scout que insere esse domínio específico na Página de logon do Help Scout serão roteados para o Provedor de Identidade para autenticar com suas credenciais.

    d. Por fim, você pode alternar Forçar Logon SAML se desejar que os Usuários façam logon somente no Help Scout por meio desse método. Se você ainda desejar deixar a opção para que eles possam entrar com suas credenciais do Help Scout, pode a deixar desativada. Mesmo se estiver habilitada, um Proprietário de Conta sempre será capaz de fazer logon no Help Scout com a senha da conta.

    e. Clique em Save (Salvar).

Criar um usuário de teste do Help Scout

Nesta seção, um usuário chamado B.Fernandes será criado no Help Scout. O Help Scout dá suporte ao provisionamento de usuário 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 Help Scout, um novo será criado após a autenticação.

Testar o SSO

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

Iniciado por SP:

  • Clique em Testar esse aplicativo para ser redirecionado à URL de Logon do Help Scout, na qual você poderá iniciar o fluxo de logon.

  • Acesse diretamente a URL de logon do Help Scout e inicie o fluxo de logon.

Iniciado por IdP:

  • Clique em Testar este aplicativo e você será conectado automaticamente ao Help Scout para o qual configurou o SSO.

Use também os Meus Aplicativos da Microsoft para testar o aplicativo em qualquer modo. Quando você clicar no bloco do Help Scout, em Meus Aplicativos, se ele estiver configurado no modo SP, você será redirecionado à página de logon do aplicativo para iniciar o fluxo de logon e, se ele estiver configurado no modo IdP, você será conectado automaticamente ao Help Scout para o qual configurou o SSO. Para obter mais informações sobre os Meus Aplicativos, confira Introdução aos Meus Aplicativos.

Próximas etapas

Depois de configurar o Help Scout, você poderá impor o controle de sessão, que fornece proteção contra a 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.