Atualize tokens de acesso com segurança

Utilize um token de atualização quando um token de acesso expirar e a concessão do cliente ainda for válida. A atualização não exibe um ecrã de consentimento. Preserva a conta original e o limite de autorização.

curl --fail-with-body "https://auth.shareai.now/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "grant_type=refresh_token" \
  --data-urlencode "client_id=$SHAREAI_CLIENT_ID" \
  --data-urlencode "client_secret=$SHAREAI_CLIENT_SECRET" \
  --data-urlencode "refresh_token=$SHAREAI_REFRESH_TOKEN"

Armazene ambas as substituições juntas#

1. Serialize operações de atualização para a mesma autorização do cliente. Um pedido de aplicação deve realizar a atualização enquanto os outros aguardam.
2. Troque o token de atualização atual uma vez usando o método de autenticação do cliente configurado.
3. Guarde o token de acesso retornado, o token de atualização substituto e a expiração de forma atómica.
4. Descarte o token de atualização antigo. Libere os pedidos em espera usando o novo token de acesso.

Lide com falhas#

Em invalid_grant, limpe a autorização inutilizável e peça ao cliente para se reconectar. Um erro temporário de serviço é diferente de um consentimento revogado: mostre uma falha temporária e mantenha um caminho de recuperação limitado. Nunca faça um loop indefinido de atualização.

Solicitar um âmbito mais restrito#

Um valor opcional scope pode reduzir permissões. Não pode adicionar surcharge a uma concessão apenas de identidade. Use o escopo e a validade retornados como autoridade para o novo token.

Próximo passo#

Envie pedidos de chat com um token de acesso OAuth