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

# 驗證

> 使用 Microsoft Entra ID 登入及登出，並檢查目前登入的身分。

`xbox auth` 管理其他命令所使用的 Microsoft Entra ID 帳戶。如需登入運作方式的相關資訊 (包括以服務主體身分登入)，請參閱[驗證](https://docs.xbox.com/zh-TW/tools/xbox-cli/authentication.md)。

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

| 命令 | 描述 |
| - | - |
| `xbox auth login` | 透過系統瀏覽器登入，取代任何已登入的帳戶。 |
| `xbox auth logout` | 登出所有快取的帳戶。 |
| `xbox auth status` | 顯示已登入的帳戶。 |

沒有任何 `auth` 命令接受 `--output table`。

當 `XBOX_AUTHENTICATION__MODE` 選取服務主體模式時，`auth login` 和 `auth logout` 會以 `1` 結束，而 `auth status` 會描述服務主體。

## `auth login`

使用 Microsoft Entra ID 登入，取代任何已登入的帳戶。

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

命令會開啟系統瀏覽器，並在成功時列印帳戶及其權杖的到期時間。之後的每個命令都會使用該帳戶。如果快取了多個帳戶 (例如由較早的 CLI 版本所快取)，命令會失敗，直到您再次執行 `auth login` 為止。

## `auth logout`

登出所有快取的帳戶。

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

命令會列印它所登出的帳戶，或指出沒有任何帳戶已登入。以 [`context set`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/context) 儲存的值會保留，以相同帳戶重新登入即可還原這些值。

## `auth status`

顯示已登入的帳戶及其權杖。命令可以透過 Entra ID 重新整理權杖，但不會使用它，因此無法確認其他命令是否會接受該權杖。若要查看已儲存的賣方和 PlayFab 遊戲，請執行 [`xbox context get`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/context)。

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

除非您傳遞 `--output`，否則輸出為文字。若是指令碼，請要求 JSON 並檢查 `signedIn`：

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

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

| 結束代碼 | 意義 |
| - | - |
| `0` | 已讀取狀態，無論是否有帳戶登入。 |
| `1` | CLI 無法讀取其設定或權杖快取，或在服務主體模式中無法取得權杖。錯誤會顯示在 stderr 上，而 stdout 為空白。 |

### 服務主體模式

在服務主體模式中，`auth status` 會取得僅限應用程式的權杖並回報其宣告。它絕不會列印權杖。

```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`。請參閱[確認身分識別](https://docs.xbox.com/zh-TW/tools/xbox-cli/authentication.md#confirm-the-identity)。


## Related topics

- [驗證](https://docs.xbox.com/zh-TW/services/playfab/identity/player-identity/authentication/index.md)
- [服務驗證](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/index.md)
- [驗證 API 原則](https://docs.xbox.com/zh-TW/services/playfab/api-references/rest/admin/authentication/validate-api-policy.md)
- [驗證 iOS 收據](https://docs.xbox.com/zh-TW/services/playfab/api-references/rest/client/platform-specific-methods/validate-ios-receipt.md)
- [驗證和 S2S](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/s2s-auth-calls/live-s2s-auth-calls-nav.md)
