# 认证管理

> Shoplazza CLI 的 auth 命令：通过 OAuth 2.0 登录登出、查看凭证状态、列出已授权作用域，以及切换当前店铺。

管理认证、凭证和店铺连接。选定的每个店铺都有自己的 [Profile](./profile)。

## login

通过浏览器 OAuth 流程登录 Shoplazza 账户。不带 `--store-domain` 时只登录账户；用 `--store-domain` 选定店铺时还需要 `--domain` 或 `--scope`（使用 `--uat` 时除外）。

```shell
shoplazza auth login [参数]
```

CLI 会打印一个授权 URL，在浏览器中打开即可授权。在交互式终端中，CLI 会询问你未传入的店铺和业务域；已登录时直接运行不带参数的 `auth login`，会先确认是否重新认证。

### 参数

| 参数 | 类型 | 说明 |
|------|------|------|
| `--store-domain, -s <域名>` | string | 登录时选定的店铺域名（如 `my-store.myshoplaza.com`） |
| `--domain <域>` | StringSlice | 逗号分隔的业务域，用于作用域扩展（如 `products,orders`）。可选值：`app`、`billing`、`checkout`、`customers`、`discounts`、`orders`、`products`、`shop`、`themes`、`webhook`、`all` |
| `--scope <作用域>` | StringSlice | 逗号分隔的 OAuth 作用域（如 `read_product,write_product`） |
| `--merge-scopes` | bool | 同时重新申请此前已授权的全部作用域。登录会替换账户已授权的作用域，不加此参数时，范围更窄的重新登录会丢掉其余作用域 |
| `--uat <令牌>` | string | 使用已有的账户 UAT 非交互式登录（CI/CD），跳过浏览器 |
| `--timeout <秒>` | int | Web 流程轮询超时时间，单位秒（默认：`300`） |
| `--poll-interval <秒>` | int | Web 流程轮询间隔，单位秒（默认：`2`） |

### 示例

```shell
# 仅登录账户（不选店铺、不申请作用域）
shoplazza auth login

# 指定业务域作用域登录
shoplazza auth login --store-domain my-store.myshoplaza.com --domain products,orders,customers

# 追加某个业务域的作用域，并保留已授权的作用域
shoplazza auth login --store-domain my-store.myshoplaza.com --domain discounts --merge-scopes

# CI/CD 非交互式登录
shoplazza auth login --uat $SHOPLAZZA_UAT --store-domain my-store.myshoplaza.com
```

## logout

登出并清除所有 Profile 和存储的凭证。在交互式终端中会先请你确认。

```shell
shoplazza auth logout
```

## status

显示当前认证状态：是否已登录、账户、已授权的作用域，以及每个已配置的 Profile 及其店铺和令牌状态。

```shell
shoplazza auth status
```

## scopes

显示支持的 OAuth 作用域，以及账户当前已授权的作用域。

```shell
shoplazza auth scopes
```

## store use

为 `--store-domain` 申请店铺令牌，创建或复用该店铺的 Profile 并设为当前 Profile，无需重新认证。

```shell
shoplazza auth store use [参数]
```

| 参数 | 类型 | 说明 |
|------|------|------|
| `--store-domain, -s <域名>` | string | 要切换到的店铺域名（必填） |
| `--scope <作用域>` | StringSlice | 该店铺 Profile 的作用域（须为账户已授权作用域的子集）；留空则保留或授予全部作用域 |

### 示例

```shell
shoplazza auth store use --store-domain another-store.myshoplaza.com

# 切换并收窄该 Profile 的作用域
shoplazza auth store use --store-domain another-store.myshoplaza.com --scope read_product,read_order
```