> ## 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

> Connectez-vous et déconnectez-vous avec Microsoft Entra ID, et vérifiez qui est connecté.

`xbox auth` gère le compte Microsoft Entra ID qu'utilisent les autres commandes. Consultez
[Authentification](https://docs.xbox.com/fr/tools/xbox-cli/authentication.md) pour savoir comment fonctionne la connexion, y compris en tant que principal de service.

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

| Commande | Description |
| - | - |
| `xbox auth login` | Se connecter via le navigateur système, en remplaçant tout compte déjà connecté. |
| `xbox auth logout` | Déconnecter tous les comptes mis en cache. |
| `xbox auth status` | Afficher le compte connecté. |

Aucune commande `auth` n'accepte `--output table`.

Lorsque `XBOX_AUTHENTICATION__MODE` sélectionne un mode principal de service, `auth login` et
`auth logout` se terminent avec le code `1`, et `auth status` décrit le principal de service.

## `auth login`

Connectez-vous avec Microsoft Entra ID, en remplaçant tout compte déjà connecté.

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

La commande ouvre le navigateur système et, en cas de réussite, affiche le compte et la date d'expiration de son
jeton. Toutes les commandes suivantes utilisent ce compte. Si plusieurs comptes sont mis en cache, par exemple
par une version antérieure de la CLI, les commandes échouent jusqu'à ce que vous exécutiez de nouveau `auth login`.

## `auth logout`

Déconnectez tous les comptes mis en cache.

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

La commande affiche les comptes qu'elle a déconnectés, ou indique qu'aucun compte n'était connecté. Les valeurs enregistrées
avec [`context set`](https://docs.xbox.com/fr/tools/xbox-cli/commands/context) sont conservées, et se reconnecter avec le même compte les
restaure.

## `auth status`

Affichez le compte connecté et son jeton. La commande peut actualiser le jeton auprès d'Entra ID, mais
ne l'utilise pas : elle ne confirme donc pas que les autres commandes l'accepteront.
Pour voir le vendeur et le titre PlayFab enregistrés, exécutez [`xbox context get`](https://docs.xbox.com/fr/tools/xbox-cli/commands/context).

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

La sortie est du texte, sauf si vous passez `--output`. Pour un script, demandez du JSON et vérifiez `signedIn` :

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

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

| Code de sortie | Signification |
| - | - |
| `0` | Le statut a été lu, qu'un compte soit connecté ou non. |
| `1` | La CLI n'a pas pu lire ses paramètres ou son cache de jetons, ou, dans un mode principal de service, n'a pas pu obtenir de jeton. L'erreur figure sur stderr, et stdout est vide. |

### Modes principal de service

Dans un mode principal de service, `auth status` obtient un jeton d'application uniquement et signale ses revendications. Elle
n'affiche jamais le jeton.

```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` vaut `app` pour un principal de service ou une identité managée. Consultez
[Confirmer l'identité](https://docs.xbox.com/fr/tools/xbox-cli/authentication.md#confirm-the-identity).


## Related topics

- [auth_token_validated](https://docs.xbox.com/fr/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)
- [Demander un User Store ID depuis votre service avec des X-tokens ou OAuth 2.0](https://docs.xbox.com/fr/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth.md)
- [Configuration de l'authentification PlayFab avec Facebook et Unity](https://docs.xbox.com/fr/services/playfab/identity/player-identity/platform-specific-authentication/facebook-unity.md)
