Resumo: ◀▼
É possível ativar o acesso à API aceitando os termos e habilitando o acesso por token ou senha. Os tokens de API protegem as senhas dos agentes e precisam ser ativados antes do uso. Os usuários finais podem ativar ou desativar o acesso por senha para solicitações de API autenticadas ou anônimas. Desativar o acesso por token ou senha desabilita os métodos de autenticação, sendo necessário a reativação para usar novamente. O acesso OAuth é gerenciado separadamente.
- Podem usar a senha gerada automaticamente, chamada de token da API.
- Podem usar um token de acesso OAuth, que é diferente de um token da API.
- Os usuários finais podem usar o acesso por senha da API para fazer solicitações autenticadas ou anônimas à API.
Use a página de configuração da API para ativar o acesso por senha e token da API à API do Zendesk. Para acesso OAuth, consulte Uso de autenticação OAuth com seu aplicativo. Para obter mais informações sobre a API do Zendesk, consulte a documentação para desenvolvedores da Zendesk.
Este artigo inclui estas seções:
- Ativação do acesso à API
- Ativação e desativação do acesso por token da API
- Ativação e desativação do acesso por senha da API para usuários finais
Artigos relacionados:
- Gerenciamento do acesso à API do Zendesk
- Documentação do desenvolvedor: Segurança e autenticação
Ativação do acesso à API
Se esta é a primeira vez que você acessa a API do Zendesk, é necessário aceitar os Termos de serviço do Zendesk e o Application Developer and API Agreement (Contrato de desenvolvedor de aplicativos e API).
Como ativar o acesso à API
- Na Central de administração, clique em
Aplicativos e integrações na barra lateral e selecione APIs > Configuração da API. - Clique na caixa de seleção para aceitar os termos e contratos.
- Clique em Começar agora.
Ativação e desativação do acesso por token da API
Use tokens da API para manter as senhas de agentes seguras. Ao autenticar com tokens, adicione /token ao fim de seu endereço de e-mail. Por padrão, o acesso por token da API está desativado. É preciso ativar o acesso por token da API para que os usuários possam usar tokens da API.
Como ativar o acesso por token à API
- Na Central de administração, clique em Aplicativos e integrações na barra lateral e selecione APIs > Configuração da API.
- Selecione Permitir acesso por token da API.
- Clique em Salvar.
Depois de ativar o acesso por token da API, você pode gerar tokens de acesso à API. Consulte Geração de tokens da API.
Como desativar o acesso por token à API
- Na Central de administração, clique em Aplicativos e integrações na barra lateral e selecione APIs > Configuração da API.
- Desmarque a opção Permitir acesso por token da API.
- Clique em Salvar.
Quando você desativa o acesso por token, seus tokens param de funcionar. É necessário reativar o acesso por token para que funcionem novamente.
Ativação e desativação do acesso por senha da API para usuários finais
Por padrão, o acesso por senha da API para usuários finais está desativado. Portanto, o acesso do usuário final é considerado anônimo.
A ativação da autenticação de dois fatores, seja ela obrigatória ou opcional para os usuários finais, não afeta a capacidade de fazer solicitações à API usando e-mail e senha.
Como ativar o acesso por senha da API para usuários finais
- Na Central de administração, clique em Aplicativos e integrações na barra lateral e selecione APIs > Configuração da API.
- Selecione Permitir acesso por senha para usuários finais.
- Clique em Salvar.
Depois de ativar o acesso por senha da API, os usuários finais podem fazer solicitações autenticadas ou anônimas à API.
Como desativar o acesso por senha da API para usuários finais
- Na Central de administração, clique em Aplicativos e integrações na barra lateral e selecione APIs > Configuração da API.
- Desmarque Permitir acesso por senha para usuários finais.
- Clique em Salvar.
Depois de desativar o acesso por senha da API, o acesso dos usuários finais é considerado anônimo.