Dois códigos ligam o dispositivo ao navegador
O código de dispositivo identifica uma tentativa de autorização no fluxo OAuth 2.0 Device Authorization Grant, definido pela RFC 8628. Esse fluxo atende aplicações com entrada limitada ou sem um navegador adequado, permitindo que você confirme o acesso pelo navegador de outro aparelho.
A aplicação inicia a tentativa no servidor de autorização e recebe dois códigos com funções distintas. O user_code é o código curto apresentado a você. O device_code fica com a aplicação, que o utiliza para consultar o resultado. A resposta também informa o endereço de verificação e o prazo de validade dos códigos.
A confirmação de uma ferramenta de terminal
Neste exemplo didático de autorização, uma ferramenta de terminal exibe um endereço de verificação e um código curto. Você abre esse endereço no celular, informa o código e confere qual aplicação solicita acesso ao serviço. O serviço conduz a autenticação e a autorização no navegador. A senha de acesso, quando exigida, é digitada nessa página do serviço.
Durante essa interação, a ferramenta consulta o servidor com o device_code. A resposta authorization_pending indica que a confirmação ainda não terminou, portanto a ferramenta deve aguardar o intervalo previsto antes de consultar novamente. Depois da autorização, ela recebe um token de acesso para utilizar o serviço dentro das permissões concedidas.
A resposta slow_down exige aumentar o intervalo entre consultas para continuar aguardando a confirmação. Já access_denied e expired_token encerram a tentativa por recusa ou expiração. Confira a aplicação e as permissões na página de autorização: digitar um código associa a tentativa ao navegador, mas a concessão de acesso ainda exige a sua confirmação.
Dúvidas frequentes
Perguntas frequentes sobre código de dispositivo
- O código da tela é o mesmo que a aplicação envia ao servidor?
- O fluxo usa dois valores. Você informa o user_code no navegador. A aplicação mantém o device_code para consultar o servidor e obter o token após a autorização.
- Qual intervalo a aplicação deve respeitar entre as consultas?
- A RFC 8628 usa o intervalo informado pelo servidor ou cinco segundos quando ele não vier na resposta. A resposta slow_down exige acrescentar cinco segundos às consultas seguintes.
- O que acontece se eu recusar ou deixar o código expirar?
- O servidor responde com access_denied na recusa ou expired_token na expiração. A aplicação deve encerrar as consultas dessa tentativa e informar o resultado.
Para continuar
Recursos relacionados
Documentação
RFC 8628: autorização OAuth para dispositivos
Define os campos da autorização por dispositivo, os intervalos entre consultas e o tratamento de recusa e expiração.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação ao vivo para revisar a integração OAuth de uma ferramenta de terminal e interpretar as respostas de autorização.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Na integração de uma ferramenta de terminal, você precisa acompanhar a confirmação no navegador e tratar as respostas do servidor de autorização.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.