Configurar o SSO do Active Directory com o Token da Web JSON

    Este artigo descreve o processo para configurar o  JWT SSO  no Freshservice para autenticação usando o Active Directory. Um script precisará ser hospedado no servidor IIS e terá acesso ao Active Directory para autenticar seus usuários no Freshservice.

Nota: No momento, esta opção está disponível apenas se você se inscreveu no Freshworks Suite of Products a partir de fevereiro de 2020. Estaremos implementando essa opção gradualmente para clientes que se inscreveram antes disso.

Etapa 1: instalar o Internet Information Services (IIS)

    Os Serviços de Informações da Internet (Gerenciador do IIS) devem ser configurados no Windows Server para hospedar o arquivo de script ASP clássico que acessará as informações do usuário no Active Directory. Você pode seguir as etapas fornecidas neste artigo para instalar o IIS 8 no Windows Server 2012. Escolha as seguintes opções ao instalar a função IIS no servidor.

• Servidor Web (IIS)

  • Segurança

    • Autenticação do Windows

  • Desenvolvimento de aplicações

    • ASP

• Ferramentas de gerenciamento

  • Console de Gerenciamento do IIS

    Você precisa do ASP para hospedar o script ASP clássico e a Autenticação do Windows para autenticar usuários no Active Directory for Freshservice. Portanto, se você já instalou o IIS, verifique se esses recursos estão instalados.

Etapa 2: editar o arquivo de script ASP clássico

1. Faça o download dos arquivos ADScriptJWT.asp , Constants.asp e jwt.all.asp anexados abaixo.

2. Abra o arquivo Constants.aspe atribua os seguintes valores às variáveis.

   1. sLdapReaderUsername = "domínio \ nome de usuário"  ( nome de usuário da conta do AD que possui privilégio somente leitura para todos os usuários no AD)

   2. sLdapReaderPassword = "senha"  (senha dessa conta de usuário)

   3. sRSAPrivateKey - Para criar a parte da assinatura, é necessário pegar o cabeçalho codificado, a carga útil codificada, a chave privada RSA e assinar isso. Você pode gerar a Chave RSA usando o seguinte script:
      
      generate RSA key 
      ssh-keygen -t rsa -b 1024 -m PEM -f jwtRS256.key
      # use a senha vazia
      openssl rsa -in jwtRS256.key -pubout -outform PEM -out jwtRS256.key.pub
      
      Ou use os geradores on-line Link1 ,  Link2
      
      

3. sReturnURL : o URL de redirecionamento do Freshservice para o qual o usuário será redirecionado assim que a autenticação for bem-sucedida < https://domain.freshworks.com/sp/OIDC/13415184120 >
   
   

4. Salve o arquivo Constants.asp.

Por exemplo:

sLdapReaderUsername = "FRESHSERVICE \ admin"

sLdapReaderPassword = "xxxxxxxxx"

sRSAPrivateKey = "----- COMEÇA A CHAVE PRIVADA RSA ----- <Chave Privada RSA como sequência de linhas única> ---- END CHAVE PRIVADA RSA -----"

sReturnURL = " https://domain.freshworks.com/sp/OIDC/134151841209466902/implicit "

Nota: Ao executar comandos no Linux / Mac, serão gerados dois arquivos que contêm as chaves pública e privada RSA jwtRS256.key e jwtRS256.key.pub Certifique-se de copiar o conteúdo de várias linhas dos arquivos .key, altere para um único linha entre aspas duplas antes de colar junto com o sRSAPrivateKey no arquivo Constants.asp.

Etapa 3: Para configurar o script ASP no IIS

1. Criar um novo site no IIS, passar pela criação de um novo site a seção neste artigo (você pode criar um novo site ou usar o site existente disponível em IIS).

2. Clique no site e clique duas vezes em ASP no painel direito. 

3. Defina Ativar caminhos pai como verdadeiro .

4. Clique no site novamente e clique duas vezes em Autenticação . 

5. Clique com o botão direito do mouse em Autenticação do Windows e selecione Ativar .
   Nota: Desative todos os outros tipos de autenticação. O IIS usará a autenticação integrada do Windows. Para tornar isso possível, o servidor IIS deve ser instalado no domínio do Active Directory que contém os usuários.

6. Clique com o botão direito do mouse no site, selecione Explorar . 

7. Cole os 3 arquivos - ADScriptJWT.asp , Constants.asp e jwt.all.asp que já estão configurados. 

8. Navegue para o caminho ADScriptJWT.asp. 

9. Você será autenticado e conectado ao Freshservice.

Pré-requisitos / Pontos a serem lembrados: 

• O script ASP clássico usa seu atributo de email como um titular de email. Ele buscará o endereço de email do seu atributo de email. Portanto, é obrigatório ter o atributo de email preenchido em Atributos do Usuário para efetuar login com êxito no Freshservice. Portanto, se você receber o erro “Não foi possível fazer login no Freshservice. Entre em contato com o administrador ”, verifique se o endereço de email está configurado para você no Active Directory.

• Por padrão, a opção  runat = "server"  para tags Javascript será ativada quando você estiver criando um site no IIS. 

• Tente acessar o script em http: //dc-svr01/test.asp e veja se o script foi executado ou não. Verifique se o IIS chama esse script com autenticação integrada e NÃO via autenticação anônima. 

• Altere a autenticação para usar apenas NTLM e não negociar com o Kerberos.

Etapa 4: configurar o SSO para Freshservice

1. Faça login na sua conta Freshservice. 

2. Clique no ícone Configurações do administrador . 

3. Clique em Segurança do suporte técnico em Configurações gerais . 

4. Clique no link - Gerenciar a segurança do suporte técnico a partir do Freshworks 360 Security . Isso abre a página Segurança da organização em uma nova guia.
   

5. Navegue até o cartão de logon único em Métodos de login . 

6. Alterne o interruptor . Por padrão, o SAML SSO será selecionado.
   

7. Clique no menu suspenso e selecione JWT SSO . Um URL de redirecionamento será gerado automaticamente na caixa de campo URL de redirecionamento .
   Nota: Copie o URL de redirecionamento gerado e cole-o junto com o sReturnURL enquanto atribui valores no arquivo Constants.asp .
   

8. Copie o conteúdo de  jwtRS256.key e cole-o na caixa do campo Chave pública do RSA .
   Nota: Certifique-se de omitir o conteúdo do cabeçalho e rodapé da  jwtRS256.key  antes de colá- lo no campo.

9. Digite a autorização UR L 
   Formato do URL:
   https: // <Domínio ou IP do Servidor AD>: <port> /ADScriptJWT.asp
   

10. (Opcional) Você também pode inserir o URL de logoff para o qual os usuários serão enviados quando efetuarem logout. 

11. Clique em Salvar para finalizar suas alterações.