通过CSR签发证书 - CreateCertificateByCsr

功能介绍

通过CSR签发证书。功能约束如下：

• 1、当前默认参数如下：

  • CA 默认参数：

    • keyUsage: digitalSignature, keyCertSign, cRLSign，优先采用CSR中的参数；

    • SignatureHashAlgorithm: SHA384；

    • PathLength：0 （可自定义）。

  • 私有证书：

    • keyUsage: digitalSignature keyAgreement，优先采用CSR中的参数；

    • SignatureHashAlgorithm: SHA384；

• 2、当传入的type为INTERMEDIATE_CA时，创建出的从属CA证书，有以下限制：

  • 不占用CA配额。在查询CA列表时，不会返回该证书；

  • 只支持通过以下两个接口获取其信息：

    • GET /v1/private-certificate-authorities/{ca_id} 获取证书详情

    • POST /v1/private-certificate-authorities/{ca_id}/export 导出证书

  • 本接口返回的certificate_id即代表从属CA的ca_id；

  • 无法用于签发证书，密钥在用户侧。

• 3、当type为ENTITY_CERT时，创建出的私有证书，有以下特点：

  • 占用私有证书配额。在查询私有证书列表时，会返回该证书；

  • 除了导出时不包含密钥信息（密钥在用户端），其余用法与其它私有证书一致。

注：需要使用“\r\n”或“\n”代替换行符，将CSR转换成一串字符，可参考示例请求。注：目前，证书的组织信息、公钥算法以及公钥内容等均来自CSR文件，暂不支持API传入。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

• 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
• 如果使用身份策略授权，需具备如下身份策略权限。

  授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
  pca:ca:issueCertByCsr	Write	ca *	-	pca:ca:issueCertThroughCSR	-
  		-	g:EnterpriseProjectId g:RequestTag/<tag-key> g:TagKeys pca:CommonName

URI

POST /v1/private-certificates/csr

请求参数

响应参数

状态码：200

状态码：400

状态码：401

状态码：403

状态码：404

状态码：500

请求示例

通过CSR签发证书，请求头中的X-Auth-Token字段需要填写token，且该token需要具有本API的访问权限。

POST https://ccm.cn-north-4.myhuaweicloud.com/v1/private-certificates/csr

{
  "csr" : "-----BEGIN CERTIFICATE REQUEST-----\\nMIICyTCCAbECAQAwXjELMAkGA1UEBhMCQ04xEDAOBgNVBAgTB3NpY2hhdW4xEDAO\\nBgNVBAcTB2NoZW5nZHUxCzAJBgNVBAoTAkhXMQswCQYDVQQLEwJJVDERMA8GA1UE\\nAxMIdGVzdC5jb20wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCZ4q5z\\nxqK/L/FC9x2jESeUW5GB6zS5rVxT0WLTCTv9d1LtWBLsRIinATYTYiP1pNo4/pBq\\nHlM3IiUDkc896CJerYlNzOIjTaV4GjCZvPrxSHU5toJvIDflBsY+gnzbT1ol/y0r\\n3yb9dx7eeF5rPR+U8RTw+Ov/ZNRb+0CY30hrXMdrWjp5dtLGTlr5EFYxlKNOPCkR\\n+6BGyJnC9PWSuqwsykFbgMRkcBaNAxa59dRhMF50pvx2Vs929vFrMi+ofDELUOqz\\n1vyjaEA3pn3AGJGXZgrGNbSfz12ixgGLes4cQD21GCIAWgnBQ7b1ru2V8ImUfyh0\\nyvTEyHJTuFbQ+257AgMBAAGgJjAkBgkqhkiG9w0BCQ4xFzAVMBMGA1UdEQQMMAqC\\nCHRlc3QuY29tMA0GCSqGSIb3DQEBCwUAA4IBAQBKfjZuYsz4s0wb1POIWn41eiAB\\np53qb63QKWILN9z8dLktcdSl3lPfcfPZpXv++QPtn3LR9rJKBawusk6SPXbvOGgS\\n5J+6eM8kVW2O3gHFgoaMcPYVtiO7ekG6o25qx6+Rj84wbFdmpOiCc8AwrLEBwzYV\\np1zaprWQu6PxBulkYPa3FLcntDdi7B67r0YTpxVvo1K7vHYFboDvPz7xG57QIFIM\\nwGd1OegariMT3N8gBOzLZc+jqLpxgo4xoNqBHMo6DEmKLdWdzU4ljpuGK9had99k\\nvQ5vft/Qra3v1uq2lOm/G92b0uA9Y1t2bMHobtAnuXL0HmY9XcLdzpC3f8h8\\n-----END CERTIFICATE REQUEST-----",
  "validity" : {
    "type" : "YEAR",
    "value" : 3
  },
  "issuer_id" : "2cb2878b-6cd1-460d-bd25-afe655159bdc"
}

响应示例

状态码：200

请求已成功

{
  "certificate_id" : "e3e10fc6-5dff-4a70-9cb5-320d258a6215"
}

状态码：400

请求参数有误。

{
  "error_code" : "PCA.XXX",
  "error_msg" : "XXX"
}

状态码：401

被请求的页面需要鉴权。

{
  "error_code" : "PCA.XXX",
  "error_msg" : "XXX"
}

状态码：403

认证失败。

{
  "error_code" : "PCA.XXX",
  "error_msg" : "XXX"
}

状态码：404

资源不存在或资源未找到。

{
  "error_code" : "PCA.XXX",
  "error_msg" : "XXX"
}

状态码：500

服务内部错误。

{
  "error_code" : "PCA.XXX",
  "error_msg" : "XXX"
}

状态码

错误码

请参见错误码。