> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Auth

> Entre e saia com o Microsoft Entra ID e verifique quem está conectado.

`xbox auth` gerencia a conta do Microsoft Entra ID que os outros comandos usam. Consulte
[Autenticação](https://docs.xbox.com/pt-BR/tools/xbox-cli/authentication.md) para saber como a entrada funciona, inclusive como entidade de serviço.

```text theme={null}
xbox auth <command>
```

| Comando | Descrição |
| - | - |
| `xbox auth login` | Entra pelo navegador do sistema, substituindo qualquer conta já conectada. |
| `xbox auth logout` | Desconecta todas as contas em cache. |
| `xbox auth status` | Mostra a conta conectada. |

Nenhum comando `auth` aceita `--output table`.

Quando `XBOX_AUTHENTICATION__MODE` seleciona um modo de entidade de serviço, `auth login` e
`auth logout` saem com `1`, e `auth status` descreve a entidade de serviço.

## `auth login`

Entra com o Microsoft Entra ID, substituindo qualquer conta já conectada.

```bash theme={null}
xbox auth login
```

O comando abre o navegador do sistema e, se for bem-sucedido, imprime a conta e quando o token dela
expira. Todos os comandos posteriores usam essa conta. Se houver mais de uma conta em cache, por exemplo,
de uma versão anterior da CLI, os comandos falharão até que você execute `auth login` novamente.

## `auth logout`

Desconecta todas as contas em cache.

```bash theme={null}
xbox auth logout
```

O comando imprime as contas que desconectou ou informa que nenhuma conta estava conectada. Os valores salvos
com [`context set`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/context) são mantidos, e entrar novamente com a mesma conta os
restaura.

## `auth status`

Mostra a conta conectada e o token dela. O comando pode atualizar o token com o Entra ID, mas
não o usa; portanto, não confirma que os outros comandos o aceitarão.
Para ver o vendedor e o título do PlayFab salvos, execute [`xbox context get`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/context).

```bash theme={null}
xbox auth status
```

A saída é texto, a menos que você passe `--output`. Em um script, solicite JSON e verifique `signedIn`:

```bash theme={null}
xbox auth status --output json-compact
```

```json theme={null}
{"signedIn":false}
```

| Código de saída | Significado |
| - | - |
| `0` | O status foi lido, haja ou não uma conta conectada. |
| `1` | A CLI não conseguiu ler suas configurações ou seu cache de tokens ou, em um modo de entidade de serviço, não conseguiu obter um token. O erro está em stderr, e stdout fica vazio. |

### Modos de entidade de serviço

Em um modo de entidade de serviço, `auth status` obtém um token somente de aplicativo e informa as declarações dele. Ele
nunca imprime o token.

```bash theme={null}
XBOX_AUTHENTICATION__MODE=azurecli xbox auth status --output json
```

```json theme={null}
{
  "signedIn": true,
  "authenticationMode": "azurecli",
  "principalType": "app",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "appId": "11111111-1111-1111-1111-111111111111",
  "objectId": "22222222-2222-2222-2222-222222222222",
  "audience": "api://example",
  "roles": [],
  "tokenType": "Bearer",
  "tokenExpiresAt": "2030-01-01T00:00:00+00:00",
  "scopes": ["<scope>/.default"]
}
```

`principalType` é `app` para uma entidade de serviço ou identidade gerenciada. Consulte
[Confirmar a identidade](https://docs.xbox.com/pt-BR/tools/xbox-cli/authentication.md#confirm-the-identity).


## Related topics

- [auth_token_validated](https://docs.xbox.com/pt-BR/services/playfab/api-references/events/PlayerIdentity/auth-token-validated.md)
- [Refresh PSN Auth Token](https://docs.xbox.com/api-reference/platform-specific-methods/refresh-psn-auth-token.md)
- [Get Player Id From Auth Token](https://docs.xbox.com/api-reference/account-management/get-player-id-from-auth-token.md)
- [Solicitar uma ID da Store do Usuário a partir do seu serviço com X-tokens ou OAuth 2.0](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth.md)
- [AuthenticationProvider](https://docs.xbox.com/pt-BR/services/playfab/api-references/events/data-types/authenticationprovider.md)
