Configurando a autenticação remota

Configurando a autenticação remota

A autenticação remota permite que você incorpore seu sistema de gerenciamento de usuários ao Zoho Desk. Ele permite que os usuários finais façam login no seu help desk usando as credenciais de seu próprio aplicativo da Web sem precisar criar uma conta separada para o seu suporte técnico. 

Nota:

  • Você deve mapear seu subdomínio (por exemplo, support.bayandco.com) com o Zoho Desk para configurar a autenticação remota.

Ativando a Autenticação Remota
Você deve acessar sua central de suporte com credenciais de administrador para habilitar a autenticação remota em seu Zoho Desk. 
  1. Clique no   ícone Configuração (  )  na barra superior.
  2. Na página  Setup Landing  , clique em  Rebranding  em  General .
  3. No   menu Rebranding , clique em  Autenticação remota .
  4. Na   página Autenticação Remota , forneça os seguintes detalhes:
    • URL do domínio de suporte : o URL do domínio de suporte é pré-preenchido. 
      Nota: Certifique-se de apontar o registro CNAME do seu subdomínio paradesk.cs.zohohost.com .
    • URL de login remoto : insira o URL para o qual o Zoho Desk redirecionará os usuários quando eles fizerem login no seu help desk.
    • URL de logout remoto : insira o URL para o qual o Zoho Desk redireciona os usuários quando eles tentam sair da sua central de suporte.
  5. Clique em  Submit .
Ao receber os detalhes acima, geraremos e forneceremos uma chave de autenticação exclusiva que deverá ser colada no script de autenticação em seu servidor da web. Você receberá a chave via e - mail e no Zoho Desk em 2 a 3 dias úteis .

Gorjeta:
  • Digite os endereços IP para autenticar os usuários em relação ao seu sistema de gerenciamento de usuários. Solicitações recebidas de outros IPs serão direcionadas para a página de login padrão no Zoho Desk. Você pode inserir vários IPs separados por uma vírgula. Observe que você deve aguardar até receber a chave de autenticação para inserir os IPs permitidos.

Como funciona
Para autenticar usuários contra o Zoho Desk, você deve passar um hash criptografado unidirecional (cálculo de chave de API), que contém sua chave de autenticação exclusiva e as informações do usuário.Este hash será usado pelo Zoho Desk para determinar a autenticidade do usuário. Na validação bem-sucedida, o registro do usuário (do hash) será criado 
e terá acesso ao seu help desk.

Aqui está uma explicação mais detalhada:
  1. Um usuário final deseja efetuar login no Zoho Desk ativado para autenticação remota a partir de um IP permitido.
  2. O usuário será redirecionado para o "Login URL" remoto junto com um registro de data e hora.
  3. O usuário insere suas credenciais de login.
  4. Uma solicitação de validação é enviada ao script de autenticação em execução no seu servidor da Web, o que garante que o usuário esteja conectado.
  5. O script de autenticação recupera o nome do usuário e o endereço de email e cria um hash. O hash incluirá a chave de autenticação remota, o registro de data e hora e um conjunto de outros parâmetros.
  6. A solicitação de autenticação será redirecionada de volta para o Zoho Desk.
  7. Ao receber a solicitação de autenticação, o Zoho Desk examinará o hash e seu conteúdo usando a chave de autenticação remota.
  8. Se eles corresponderem, o Zoho Desk considerará que o usuário foi autorizado por você e concede acesso ao seu help desk.

Escrevendo um Script de Autenticação
É necessário que você escreva o script de autenticação para as operações de login e inscrição, o que ajudará o Zoho Desk a determinar a autenticidade dos usuários. Você pode precisar da ajuda de um desenvolvedor para escrever esses scripts. Por favor, certifique-se de passar os seguintes parâmetros para as operações conforme listado abaixo:

Script de Amostra de Operação de Login Anexado

Parâmetro
Propriedades
Operação
Forneça como "login"
o email
ID do email do usuário
ts
Horário atual em GMT 0: 0 / UTC em milissegundos no formato numérico Ex.1341224998301
Chave API
hexdigest (MD5 (operação + email + remoteauthkey * + ts))

Script de amostra de operação de inscrição anexado 

Parâmetro
Propriedades
Operação
Fornecer como "inscrição"
o email
ID do email do usuário
ts
Horário atual em GMT 0: 0 / UTC em milissegundos no formato numérico Ex.1341224998301
Nome de acesso
Nome de login do usuário. Deve ter entre 6 e 30 caracteres e deve conter letras e números. Você pode usar sublinhado [_] e ponto [.]. Ex: joão.b)
nome completo
Nome do usuário. (Primeiro Nome (Max-length: 50) + Sobrenome (Max-length: 50). Ex: Stephanie Shane Snyder)
tipo
Fornecer como "portal"
Chave API
hexdigest (MD5 (operação + email + loginName + fullName + utype + remoteauthkey * + ts))
redirecionar
Na inscrição bem-sucedida: "0" para obter a resposta JSON. Else: "1" para redirecionar o usuário para o Zoho Desk. Na inscrição bem-sucedida, a resposta do JSON será - {"result": "success", "info": "User Added"}

Nota:
  • O remoteauthkey * mencionado no parâmetro " apikey " é a chave de autenticação remota exclusiva específica da sua conta.
  • O cálculo " apikey " deve seguir estritamente a ordem mencionada acima.
  • Quando você adiciona um usuário existente ao portal Zoho Desk, o sistema não lança nenhuma exceção ou cria um usuário duplicado. Normalmente, os usuários existentes receberão acesso ao aplicativo ou receberão uma resposta JSON bem-sucedida, dependendo do parâmetro "redirect".

Evitando o redirecionamento
Seus usuários de help desk podem fazer login no Zoho Desk sem precisar ir à página de login e serem redirecionados de volta ao seu script de autenticação. Para evitar esse redirecionamento, calcule e envie o parâmetro "ts" com a hora atual em GMT 0: 0 / UTC (Ex. 1341224998301), juntamente com os outros parâmetros. Isso permite que o Zoho Desk autentique usuários e conceda a eles acesso diretamente.

Mensagens de erro
Existem casos em que o Zoho Desk nega acesso a usuários via autenticação remota. Por exemplo, você pode ter configurado um domínio incorreto ou o endereço de e-mail do usuário não existe. Aqui estão alguns dos erros mais comuns e as razões por trás deles:

Mensagem de erro
Razão
{"resultado": "falha", "causa": "Acesso não autorizado"}
Configurado um domínio incorreto ou o nome do domínio deve  ser verificado para um erro de digitação.
{"resultado": "falha", "causa": "Acesso não autorizado"}
Parece um problema com a sua licença do Zoho Desk ou a sua edição não suporta autenticação remota.
{"resultado": "falha", "causa": "Acesso não autorizado"}
Você deve ter fornecido um "apikey" inválido.
{"resultado": "falha", "causa": "Nome de usuário inválido"}
Você deve ter fornecido um nome de usuário incorreto.
{"result": "failure", "cause": "LoginName já existe"}
Parece que o "loginname" já existe. Por favor, forneça um nome de login diferente.
{"resultado": "falha", "causa": "Nenhum usuário ou usuário desativado"}
O ID de e-mail não existe ou o usuário associado ao endereço de e-mail foi desativado.
{"resultado": "falha", "causa": "Operação não suportada"}
O parâmetro de operação não é "signin" nem "signup". Além disso, verifique se o nome do domínio foi configurado.
{"resultado": "falha", "causa": "Pedido atrasado"}
O parâmetro "ts" está incorreto ou o valor não está nos últimos 3 minutos.

URL de acesso seguro
Se você deve ficar bloqueado do Zoho Desk enquanto trabalha com autenticação remota, você pode efetuar login no seu portal acessando este URL de Acesso Seguro:
https://desk.zoho.com/support/<myportalname>/RLConfig.do?actionName=showRL

Anexos :

amostra-inscrição-script.jsp.htm
7 KB
amostra-signin-script.jsp.htm
6 KB

    • Related Articles

    • Configurando o Zoho Desk para JIRA

      A integração do JIRA permite que sua equipe de suporte ao cliente e a equipe de produtos trabalhem juntas para obter maior produtividade. Seus agentes podem enviar tickets como problemas no Zoho Desk, enquanto os engenheiros podem gerenciar seu P & D ...

    • Configurando o Zoho Assist Add-on para Zoho Desk

      O Zoho Assist Add-on oferece a capacidade de iniciar sessões seguras de suporte remoto a partir dos tíquetes do Zoho Desk. Ele permite que você visualize e controle os computadores dos clientes de qualquer lugar - especialmente quando você está ...

    • Integração Twilio Com Zoho Desk

      O Twilio é uma plataforma de PBX habilitada na nuvem ou hospedada, o que torna incrivelmente fácil para você usar o canal de voz com seus aplicativos da web. Ao integrar o Twilio ao Zoho Desk, você pode organizar as chamadas de entrada e saída de sua ...

    • Configurando o Zoho Desk para G Suite

      Você está usando o G Suite (antigo Google Apps ) para negócios? Agora você pode facilitar a colaboração das equipes de negócios e o compartilhamento de informações, configurando o Zoho Desk for G Suite. Benefícios Importe facilmente seus contatos de ...

    • Integrando o Zoho Desk com o Slack

      Introdução Zoho Desk para suporte ao cliente e Slack para colaboração interfuncional. Se essas são as ferramentas que fortalecem sua organização, os membros de sua equipe - especialmente os agentes de suporte - podem obter grande valor por meio da ...