Digite para filtrar os verbetes do Glossário.

    Redes e segurança · Vibe Coding: Do Zero ao MVP

    O que é código de dispositivo?

    O fluxo por código de dispositivo autoriza uma aplicação a partir do navegador de outro aparelho. Dois códigos ligam a confirmação à consulta do cliente.

    Também chamado de: OAuth Device Authorization Grant, device authorization flow

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano