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

# Autenticación

> Inicia y cierra sesión con Microsoft Entra ID, y comprueba quién ha iniciado sesión.

`xbox auth` administra la cuenta de Microsoft Entra ID que usan los demás comandos. Consulta
[Autenticación](https://docs.xbox.com/es/tools/xbox-cli/authentication.md) para saber cómo funciona el inicio de sesión, incluso como entidad de servicio.

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

| Comando | Descripción |
| - | - |
| `xbox auth login` | Inicia sesión a través del explorador del sistema y reemplaza cualquier cuenta que ya haya iniciado sesión. |
| `xbox auth logout` | Cierra la sesión de todas las cuentas almacenadas en caché. |
| `xbox auth status` | Muestra la cuenta que ha iniciado sesión. |

Ningún comando `auth` acepta `--output table`.

Cuando `XBOX_AUTHENTICATION__MODE` selecciona un modo de entidad de servicio, `auth login` y
`auth logout` salen con `1`, y `auth status` describe la entidad de servicio.

## `auth login`

Inicia sesión con Microsoft Entra ID y reemplaza cualquier cuenta que ya haya iniciado sesión.

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

El comando abre el explorador del sistema y, si se completa correctamente, imprime la cuenta y cuándo expira
su token. Todos los comandos posteriores usan esa cuenta. Si hay más de una cuenta en caché, por ejemplo
por una versión anterior de la CLI, los comandos fallan hasta que vuelvas a ejecutar `auth login`.

## `auth logout`

Cierra la sesión de todas las cuentas almacenadas en caché.

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

El comando imprime las cuentas cuya sesión cerró, o que ninguna cuenta había iniciado sesión. Los valores guardados
con [`context set`](https://docs.xbox.com/es/tools/xbox-cli/commands/context) se conservan, y volver a iniciar sesión con la misma cuenta los
restaura.

## `auth status`

Muestra la cuenta que ha iniciado sesión y su token. El comando puede actualizar el token con Entra ID, pero
no lo usa, por lo que no confirma que los demás comandos vayan a aceptarlo.
Para ver el vendedor y el título de PlayFab guardados, ejecuta [`xbox context get`](https://docs.xbox.com/es/tools/xbox-cli/commands/context).

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

La salida es texto a menos que pases `--output`. Para un script, solicita JSON y comprueba `signedIn`:

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

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

| Código de salida | Significado |
| - | - |
| `0` | Se leyó el estado, tanto si hay una cuenta con la sesión iniciada como si no. |
| `1` | La CLI no pudo leer su configuración o su caché de tokens o, en un modo de entidad de servicio, no pudo obtener un token. El error está en stderr y stdout está vacío. |

### Modos de entidad de servicio

En un modo de entidad de servicio, `auth status` obtiene un token solo de aplicación e informa de sus notificaciones.
Nunca imprime el 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` es `app` para una entidad de servicio o una identidad administrada. Consulta
[Confirmar la identidad](https://docs.xbox.com/es/tools/xbox-cli/authentication.md#confirm-the-identity).


## Related topics

- [Autenticación](https://docs.xbox.com/es/services/xbox-services/fundamentals/identity/auth/index.md)
- [Autenticación de servicios](https://docs.xbox.com/es/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/index.md)
- [Autenticación y S2S](https://docs.xbox.com/es/services/xbox-services/fundamentals/s2s-auth-calls/live-s2s-auth-calls-nav.md)
- [Autenticación en dos fases](https://docs.xbox.com/es/services/playfab/identity/dev-identity/authentication/two-factor-authentication.md)
- [Autenticación de usuarios y propiedad](https://docs.xbox.com/es/build/steam-porting-guide/features/user-authentication-and-ownership.md)
