文档首页/ Web应用防火墙 WAF/ API参考 (巴黎) / API说明/ 云模式/ 证书管理/ 上传证书
更新时间：2022-02-22 GMT+08:00
查看PDF
分享

上传证书

功能介绍

上传新证书。

URI

  • URI格式

    POST /v1/{project_id}/waf/certificate

  • 参数说明
    表1 Path参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    是

    String

    用户操作的项目ID。

请求消息

请求参数

表2 请求参数说明

名称

是否必选

参数类型

说明

name

是

String

证书的名称。最大长度为256字符。只支持以数字、字母、下划线或中划线命名。

content

是

String

证书的内容。

说明：
  • 获得的证书文件参考样例为： 
    -----BEGIN CERTIFICATE-----
MIIDezCCAmOgAwIBAgIJAMJcdOLsrN3iMA0GCSqGSIb3DQEBCwUAMFQxCzAJBgNV
...
8qh1Vpk2FXoadOVze2fQFLBkkB7LPExj8Nrf76CJEA==
-----END CERTIFICATE-----
  • 上传证书时，默认用“\n”将每行的内容连在一起，再上传，例如：

    -----BEGIN CERTIFICATE-----“\n”MIIDezCCAmOgAwIBAgIJAMJcdOLsrN3iMA0GCSqGSIb3DQEBCwUAMFQxCzAJBgNV“\n”...“\n”8qh1Vpk2FXoadOVze2fQFLBkkB7LPExj8Nrf76CJEA==“\n”-----END CERTIFICATE-----

key

是

String

证书的私钥。

说明：
  • 获得的证书秘钥参考样例为： 
    -----BEGIN RSA PRIVATE KEY-----
MIIEowIBAAKCAQEAsj2QPAwXYcPDH0mvf6Jbej6RGgYlb4EFMS85BjKrKNPOTqZf
...
4j0RY9DeUgSLdy625BBmew2it9l/NynIScG4Ow6w8Bu4iBANGv94
-----END RSA PRIVATE KEY-----
  • 上传证书秘钥时，默认用“\n”将每行的内容连在一起，再上传，例如：

    ----BEGIN RSA PRIVATE KEY----“\n”MIIEowIBAAKCAQEAsj2QPAwXYcPDH0mvf6Jbej6RGgYlb4EFMS85BjKrKNPOTqZf“\n”...“\n”4j0RY9DeUgSLdy625BBmew2it9l/NynIScG4Ow6w8Bu4iBANGv94“\n”-----END RSA PRIVATE KEY-----

响应消息

响应参数
表3 响应参数说明

名称

参数类型

说明

id

String

证书的ID。

name

String

证书的名称。

expireTime

Long

证书的到期时间。

timestamp

Long

创建证书的时间。

示例

如下以上传证书名为“cert_a”的证书为例。

  • 请求样例 
    {
 "name": "cert_a",
 "content": "-----BEGIN CERTIFICATE-----\nMIIDezCCAmOgAwIBAgIJAMJcdOLsrN3iMA0GCSqGSIb3DQEBCwUAMFQxCzAJBgNV\n...\n8qh1Vpk2FXoadOVze2fQFLBkkB7LPExj8Nrf76CJEA==\n-----END CERTIFICATE-----",
 "key": "----BEGIN RSA PRIVATE KEY----\nMIIEowIBAAKCAQEAsj2QPAwXYcPDH0mvf6Jbej6RGgYlb4EFMS85BjKrKNPOTqZf\n...\n4j0RY9DeUgSLdy625BBmew2it9l/NynIScG4Ow6w8Bu4iBANGv94\n-----END RSA PRIVATE KEY-----"
}
  • 响应样例 
    {
    "id": "388a7789d55b41d1918b3088a8f1e7f3",
    "name": "cert_b",
    "expireTime": 1565467166765,
    "timestamp": 1545467166765
}

状态码

表4描述的是API返回的正常状态码。
表4 状态码

状态码

编码

状态说明

200

OK

客户端请求已处理成功。

异常状态码，请参见状态码。

父主题： 证书管理