Revogue e inspecione tokens OAuth

Revogar um token#

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

Quando um cliente desconectar o ShareAI da sua aplicação, revogue a credencial aplicável e remova os tokens armazenados. Considere uma resposta de revogação bem-sucedida como conclusão, mesmo que o token fornecido já estivesse inutilizável. Não exponha valores de tokens em logs ou mensagens de suporte.

Inspecionar atividade#

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

Inspecionar active antes de usar outros campos retornados. A introspeção descreve o estado do token no momento da verificação; a autorização da API ainda se aplica quando um pedido subsequente é admitido. Um token de outro cliente não deve ser tratado como autorização da sua aplicação.

Reconectar quando o consentimento for necessário#

Autorizações revogadas ou expiradas podem exigir uma nova autorização no navegador. Mantenha esse fluxo separado de um erro 503 de serviço temporário. Atualizar repetidamente um token inválido não restaura o consentimento do cliente.