user: invalidateAllRefreshTokens

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Invalida todos os tokens de atualização do usuário emitidos para aplicativos e cookies de sessão no navegador de um usuário, redefinindo a propriedade de usuário refreshTokensValidFromDateTime para a data/hora atual. Normalmente, essa operação é executada (pelo usuário ou por um administrador) se o usuário tiver um dispositivo perdido ou roubado. Essa operação impediria o acesso a qualquer um dos dados da organização acessados por meio de aplicativos no dispositivo sem que o usuário precise primeiro entrar novamente. Na verdade, essa operação forçaria o usuário a entrar novamente para todos os aplicativos com os quais ele consentiu anteriormente, independentemente do dispositivo.

Para desenvolvedores, se o aplicativo tentar resgatar um token de acesso delegado para esse usuário usando um token de atualização invalidado, o aplicativo receberá um erro. Se isso acontecer, o aplicativo precisará adquirir um novo token de atualização fazendo uma solicitação ao ponto de extremidade OAuth 2.0 /authorize , o que força o usuário a entrar.

Importante

Essa API não será promovida para o status de disponibilidade geral. Recomendamos que você use a API user: revokeSignInSessions em vez disso.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ✅

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) User.RevokeSessions.All Directory.ReadWrite.All, User.ReadWrite
Delegado (conta pessoal da Microsoft) User.ReadWrite Indisponível.
Application User.RevokeSessions.All Indisponível.

Importante

Em cenários delegados com contas corporativas ou de estudante, o usuário conectado deve receber uma função do Microsoft Entra com suporte ou uma função personalizada com uma permissão de função com suporte. As seguintes funções menos privilegiadas têm suporte para essa operação:

  • Escritores de diretório
  • Administrador da Assistência Técnica
  • Administrador de Autenticação
  • Administrador de Autenticação Privilegiada
  • Administrador do usuário

Solicitação HTTP

POST /me/invalidateAllRefreshTokens
POST /users/{id | userPrincipalName}/invalidateAllRefreshTokens

Observação

Chamar o ponto de extremidade /me exige um usuário conectado e, portanto, uma permissão delegada. Não há suporte para permissões de aplicativo ao usar o /me ponto de extremidade.

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Corpo da solicitação

Esta operação não tem conteúdo de solicitação.

Resposta

Se for bem-sucedido, esse método retornará um código de resposta da série 2xx.

Exemplo

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/me/invalidateAllRefreshTokens

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content
  • Última atualização a