Tutorial: Integração do SSO (logon único) do Microsoft Entra ao Freshservice

  • Artigo

Neste tutorial, você aprenderá a integrar o Freshservice ao Microsoft Entra ID. Ao integrar o Freshservice ao Microsoft Entra ID, você poderá:

  • Controlar no Microsoft Entra ID quem tem acesso ao Freshservice.
  • Permitir que os usuários se conectem automaticamente ao Freshservice com as respectivas contas do Microsoft Entra.
  • Gerencie suas contas em um local central.

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 logon único (SSO) do Freshservice.

Observação

Essa integração também está disponível para uso no ambiente de Nuvem do Governo dos EUA do Microsoft Entra. Você pode encontrar esse aplicativo na Galeria de Aplicativos de Nuvem do Governo dos EUA do Microsoft Entra e configurá-lo da mesma forma que você faz isso na nuvem pública.

Descrição do cenário

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

Para configurar a integração do Freshservice ao Microsoft Entra ID, você precisa adicionar o Freshservice 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é Identidade>Aplicativos>Aplicativos empresariais>Novo aplicativo.
  3. Na seção Adicionar por meio da galeria, digite Freshservice na caixa de pesquisa.
  4. Escolha Freshservice no painel de resultados e, em seguida, 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 Freshservice

Configure e teste o SSO do Microsoft Entra com o Freshservice 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 Freshservice.

Para configurar e testar o SSO do Microsoft Entra com o Freshservice, conclua os seguintes blocos de construção:

  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 Freshservice – para definir as configurações de logon único no lado do aplicativo.
    1. Criar um usuário de teste do Freshservice – para ter um equivalente de B. Fernandes no Freshservice 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>Freshservice>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, insira os valores para os seguintes campos:

    a. Na caixa de texto URL de Entrada digite uma URL usando o seguinte padrão: https://<company-name>.freshservice.com

    b. Na caixa de texto Identificador (ID da Entidade) , digite uma URL usando o seguinte padrão: https://<company-name>.freshservice.com

    c. No URL de resposta caixa de texto, digite uma URL usando o seguinte padrão: https://<company-name>.freshservice.com/login/saml

    Observação

    Esses valores não são reais. Atualize esses valores com a URL de Resposta, o Identificador e a URL de Logon reais. Entre em contato com equipe de suporte ao Cliente do Freshservice para obter esses valores. Você também pode consultar os padrões mostrados na seção Configuração Básica do SAML.

  6. Na página Configurar o Logon Único com SAML, na seção Certificado de Autenticação SAML, localize Certificado (Base64) e escolha Baixar para fazer o download do certificado e salvá-lo no computador.

    The Certificate download link

  7. Na seção Configurar o Freshservice no portal do Azure, 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

Nessa seção, você permitirá que B.Fernandes use o logon único concedendo a ela acesso ao Freshservice.

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

  1. Em uma janela diferente do navegador da Web, entre no site da empresa Freshservice como um administrador

  2. No menu à esquerda, clique em Administração e selecione Segurança de Helpdesk em Configurações Gerais.

    Admin

  3. Em Segurança, clique em Ir para a seção Segurança do Freshservice 360.

    Security

  4. Na seção Segurança , realize as seguintes etapas:

    Single Sign On

    a. Para Logon Único, selecione Ativado.

    b. No Método de Logon, selecione SSO SAML.

    c. Na caixa de texto ID da Entidade fornecida pelo IdP, cole o valor da ID da Entidade copiado anteriormente.

    d. Na caixa de texto URL de SSO do SAML, cole o valor da URL de Logon copiado anteriormente.

    e. Nas Opções de Assinatura, selecione Apenas Asserções Assinadas na lista suspensa.

    f. Na caixa de texto URL de Logoff, cole o valor da URL de Logoff copiado anteriormente.

    g. Na caixa de texto Certificado de Segurança, cole o valor Certificado (Base64) que você obteve anteriormente.

    h. Clique em Save (Salvar).

Criar um usuário de teste do Freshservice

Para permitir que os usuários do Microsoft Entra façam logon no FreshService, eles devem ser provisionados no Freshservice. No caso do FreshService, o provisionamento é uma tarefa manual.

Para provisionar uma conta de usuário, execute as seguintes etapas:

  1. Faça logon no site da empresa FreshService como administrador.

  2. No menu à esquerda, clique em Admin.

  3. Na seção Gerenciamento de Usuários, clique em Solicitantes.

    Requesters

  4. Clique em Novo Solicitante.

    New Requesters

  5. Na seção Novo Solicitante, insira os dados nos campos obrigatórios e clique em Salvar. New Requester

    Observação

    O titular da conta do Microsoft Entra recebe um email com um link para confirmar a conta, a fim de torná-la ativa

    Observação

    É possível usar qualquer outra ferramenta de criação da conta de usuário do FreshService ou as APIs fornecidas pelo FreshService para provisionar as contas de usuário do Microsoft Entra.

Observação

O Freshservice também dá suporte ao provisionamento automático de usuário. Encontre aqui mais detalhes de como configurá-lo.

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 para ser redirecionado à URL de Logon do Freshservice, na qual você poderá iniciar o fluxo de logon.

  • Acesse diretamente a URL de Logon do Freshservice e inicie o fluxo de logon nela.

  • Você pode usar os Meus Aplicativos da Microsoft. Ao clicar no bloco do Freshservice em Meus Aplicativos, você será conectado automaticamente ao Freshservice, para o qual configurou o SSO. Para obter mais informações sobre os Meus Aplicativos, confira Introdução aos Meus Aplicativos.

Próximas etapas

Após configurar o Freshservice, você poderá impor controles de sessão, que protegem contra exfiltração e infiltração de dados confidenciais de 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.