Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion crates/ov_cli/Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ path = "src/main.rs"

[dependencies]
clap = { version = "4.5", features = ["derive", "env"] }
reqwest = { version = "0.12", features = ["json", "multipart", "rustls-tls", "gzip"], default-features = false }
reqwest = { version = "0.12", features = ["json", "multipart", "rustls-tls", "rustls-tls-native-roots", "gzip"], default-features = false }
serde = { version = "1.0", features = ["derive"] }
serde_json = { version = "1.0", features = ["preserve_order"] }
serde_yaml = "0.9"
Expand Down
10 changes: 10 additions & 0 deletions crates/ov_cli/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,6 +90,16 @@ Manual editing is still supported. A minimal custom-server config looks like:

`account` and `user` are usually optional when using a regular user API key because the server can derive identity from the key. They are recommended for `trusted` auth mode and tenant-scoped operations. They are required for root-key-only configs because a root key has no built-in tenant identity.

### Private CA certificates

`ov` trusts both the bundled public CA roots and certificates in the operating system's native trust store. Install your organization's private CA in the system trust store, or point `SSL_CERT_FILE` at a PEM bundle for a single command:

```bash
SSL_CERT_FILE=/path/to/company-ca.pem ov health
```

On Unix, `SSL_CERT_DIR` can instead name a colon-separated list of certificate directories. TLS certificate verification remains enabled.

For more setup details, see [docs/en/getting-started/05-cli-setup.md](../../docs/en/getting-started/05-cli-setup.md).

## Quick Start
Expand Down
10 changes: 10 additions & 0 deletions crates/ov_cli/README_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,6 +90,16 @@ ov status

使用普通 user API key 时,`account` 和 `user` 通常可以省略,因为服务端可以从 key 推导身份。使用 `trusted` 鉴权或租户级操作时,建议显式配置它们。仅 root key 的配置必须显式配置 `account` 和 `user`,因为 root key 本身不包含租户身份。

### 私有 CA 证书

`ov` 同时信任内置的公共 CA 根证书和操作系统原生信任库中的证书。可以把组织的私有 CA 安装到系统信任库,也可以为单次命令通过 `SSL_CERT_FILE` 指定 PEM 证书包:

```bash
SSL_CERT_FILE=/path/to/company-ca.pem ov health
```

在 Unix 上,也可以通过 `SSL_CERT_DIR` 指定以冒号分隔的证书目录列表。TLS 证书校验仍然保持启用。

更完整的配置说明见 [docs/zh/getting-started/05-cli-setup.md](../../docs/zh/getting-started/05-cli-setup.md)。

## 快速开始
Expand Down
Loading