Como posso corrigir erros de autenticação e autorização OAuth ao conectar uma integração?
Erros de autorização OAuth ocorrem quando um provedor externo não consegue completar ou aceitar a solicitação de autorização de um aplicativo.
Esses erros podem ocorrer durante a conexão inicial, ao renovar o acesso ou ao realizar uma operação que requer permissões adicionais.
Erros comuns relacionados ao OAuth
Acesso negado
A solicitação de autorização foi rejeitada, cancelada ou bloqueada pelas políticas do provedor.
Escopo inválido
O aplicativo solicitou uma permissão que é inválida, não suportada ou não está disponível para a conta externa.
Escopo insuficiente
A autorização existente não inclui a permissão necessária para a operação solicitada.
Concessão inválida
Um código de autorização ou token pode ter expirado, sido revogado, ser inválido ou inaceitável para o provedor.
Cliente inválido
O provedor não conseguiu validar as credenciais ou a configuração do cliente do aplicativo.
Desvio de URI de redirecionamento
O endereço de callback de autorização não corresponde ao endereço registrado com o provedor externo.
Aprovação do administrador necessária
O provedor exige que um administrador autorize o acesso solicitado.
Como solucionar erros de OAuth
Passo 1: Identifique o erro.
Registre a mensagem exata ou o código de erro exibido durante a autorização.
Passo 2: Confirme a conta externa correta.
Verifique se você está fazendo login na conta ou organização pretendida.
Passo 3: Revise as permissões solicitadas.
Determine se a conta está autorizada a conceder o acesso necessário.
Passo 4: Verifique as restrições do administrador.
Algumas organizações restringem o acesso a aplicativos de terceiros ou exigem consentimento administrativo.
Passo 5: Reinicie o fluxo de autorização.
Se a sessão de autorização expirou ou foi interrompida, inicie o processo de conexão novamente.
Passo 6: Verifique as restrições do navegador.
Certifique-se de que a página de autenticação do provedor e o fluxo de redirecionamento possam ser concluídos.
Passo 7: Verifique a disponibilidade do serviço externo.
Uma interrupção ou incidente de autenticação pode interromper a autorização.
Passo 8: Reautorização quando apropriado.
Se as credenciais existentes expiraram ou foram revogadas, use o procedimento de conexão suportado para estabelecer uma nova autorização.
Passo 9: Teste a operação pretendida.
Após a autorização ser bem-sucedida, confirme que a funcionalidade necessária funciona.
Posso corrigir um erro de cliente inválido ou de URI de redirecionamento eu mesmo?
Esses erros geralmente envolvem configuração em nível de aplicativo, em vez de permissões individuais do usuário.
Se a conexão for gerenciada pela Polyosync e o problema persistir, entre em contato com o Suporte.
Se você estiver configurando uma integração personalizada, verifique as configurações do aplicativo registrado do provedor.
Devo compartilhar um código de autorização OAuth com o Suporte?
Não.
Códigos de autorização, tokens de acesso, tokens de atualização, segredos do cliente e outras credenciais devem ser mantidos em sigilo.
Quais informações são úteis para solução de problemas?
Forneça o nome da integração, o código de erro, o timestamp aproximado e o ponto em que a autorização falhou.
Abordagem recomendada
Identifique se o problema diz respeito ao consentimento do usuário, permissões do provedor, autorização expirada ou configuração do aplicativo antes de tentar alterações.