使用 OpenAPI 授权码 申请证书
通过授权码，使用 cmcli 进行证书自动化申请。
申请证书示例：
macOS|Linux:
# 申请 SSL 证书，结果在终端输出，私钥加密并上传保存
$ cmcli enroll -u https://api.certcloud.cn -t {secret_key} -a {account_id} --app-info "MyExampleCLI" --cn domain.com --san-dns www.domain.com --upload-key --key-password {password}
# 申请 SSL 证书, 设置有效期6个月, 结果存储为PFX格式
$ cmcli enroll -u https://api.certcloud.cn -t {secret_key} -a {account_id} --app-info "MyExampleCLI" --cn domain.com --san-dns www.domain.com --validity 180 --format PFX --key-passwor {password} --file "/path/to/exmaple.pfx"
参数详细介绍
| 名称 | 描述 | 示例 |
|---|---|---|
| a, account | 用于指定使用证书自动化的身份标识，在 CertCloud 管理平台上进行绑定，具体详情。 | -a vWEfco21 |
| app-info | 请为你的CLI客户端程序自定义名称 | --app-info “CLI for MyProject” |
| cert-file | 用于为申请成功的证书文件指定存储位置 | --cert-file ”/path/to/example.crt” |
| chain-file | 用于指定输出证书链的名称和位置，该文件将只包含与证书相关联的根证书和中间证书 | --chain-file “/path/to/chain.pem” |
| cn | 用于指定 SSL 证书的通用名称 | --cn “xx.domain.com” |
| csr | 用于指定CSR和私钥位置，支持本地，云端，文件，默认为"local”。 本地:私钥和CSR将在本地生成； 服务(TODO):私钥和CSR将在服务端； 文件:CSR将从文件中读取。 | --csr “local” 或 --csr “file:/path/to/csr.pem” |
| fields | 用于以 ‘key=value’ 格式指定自定义字段, 以 ‘;’ 分隔。如果同一个键需要多个值，以 ‘,’ 分隔。支持的自定义字段如下： ADR:地址 C:国家简称 L:市 O:组织名称 OU:部门名称 P:省、直辖市 PC:邮编 | --fields C=CN;L=上海市,北京市;ST=浦东区,海淀区;O=某某技术有限公司;OU=研发部; |
| file | 用于指定将包含私钥和证书的输出文件的名称和位置, 不能与 --key-file, --cert-file, --chain-file 共同使用 | --file /path/to/keycert.pem |
| format | 用于指定输出格式, PEM是默认格式。使用PKCS#12格式必须以’--file’选项来指定密钥存储库路径，选项: pem, jks, pfx | --format “pfx” --file “example.pfx” |
| key-file | 用于为仅包含私钥文件的存放位置指定名称和路径 | --key-file /path/to/domain.key |
| key-password | 用于指定加密私钥的密码。指定空密码，将产生不加密私钥。可以使用以下三种方法之一来指定密码:在命令行、在提示时(TODO:)或使用密码文件。 | --key-password ”file:/path-to/passwd.txt“， --key-password “1234” |
| key-size | 用于指定 RSA 或 ECDSA 密钥的密钥大小，默认值为2048 。RSA: 1024、2048、3072、4096；ECDSA: 224、256、384、521 | --key-size 2048 |
| key-type | 用于指定密钥算法, 默认是RSA。选项: RSA、ECDSA | --key-type “RSA” |
| san-dns | 用于指定DNS主题替代名称，如需指定多个，请参考示例 | --san-dns san1.example.com;san2.example.com |
| san-email | 用于指定邮件主题替代名称，如需要指定多个，请参考示例 | --san-email john@example.com;jane@example.com |
| san-ip | 用于指定IP地址主题替代名称，虚入指定多个，请参考示例 | --san-ip 10.20.30.1;10.20.30.2 |
| t， token | 用于指定使用证书自动化的个人口令, 需登录 CertCloud 管理平台上进行创建 | -t Ab01Cd23Ef45Uv67Wx89Yz== |
| upload-key | 上传加密后的私钥，云端备份使用，未加密无法上传 | --upload-key |
| u, url | 证书自动化 OpenAPI 服务 | -u https://api.certcloud.cn |
| validity | 用于指定证书有效期，单位：天，范围：1 ~ 365 | --validity 180 |
February 26, 2021