Emite um único certificado de cliente com base em uma solicitação de assinatura de certificado (CSR) personalizada.
Descrição da operação
Antes de chamar esta operação, você deve ter chamado CreateRootCACertificate para criar um certificado de CA raiz e chamado CreateSubCACertificate para criar um certificado de sub-CA. Apenas certificados de sub-CA podem emitir certificados de cliente.
Limite de QPS
O limite de QPS por usuário para esta operação é de 10 chamadas por segundo. Se o número de chamadas por segundo exceder o limite, o throttling será acionado. Isso pode afetar seus negócios. Chame esta operação conforme apropriado.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
yundun-cert:CreateClientCertificateWithCsr |
create |
*Todos os recursos.
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| Csr |
string |
Não |
O conteúdo da CSR. Você pode usar OpenSSL ou Keytool para gerar uma CSR. Para mais informações, consulte Como criar um arquivo CSR. |
-----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST----- |
| SanType |
integer |
Não |
O tipo da extensão Subject Alternative Name (SAN) do certificado de cliente. Valores válidos:
|
2 |
| SanValue |
string |
Não |
As informações específicas da extensão SAN do certificado de cliente. Você pode inserir vários valores separados por vírgulas (,).
|
somebody@example.com |
| Organization |
string |
Não |
O nome da organização. Valor padrão: Alibaba Inc. |
Alibaba Inc |
| OrganizationUnit |
string |
Não |
O nome da unidade organizacional. Valor padrão: Aliyun CDN. |
Security |
| Country |
string |
Não |
O código do país. Exemplo: CN ou US. |
CN |
| CommonName |
string |
Não |
O nome comum do certificado. Caracteres chineses, caracteres ingleses e outros caracteres são suportados. Nota
Se você definir o parâmetro CsrPemString, o valor do parâmetro CommonName será determinado pelas informações correspondentes no parâmetro CsrPemString. |
aliyundoc.com |
| State |
string |
Não |
O nome da província ou estado onde a organização do certificado está localizada. Caracteres chineses, caracteres ingleses e outros caracteres são suportados. O valor padrão é o nome da província ou estado onde a organização do certificado de sub-CA que emite este certificado está localizada. |
Zhejiang |
| Locality |
string |
Não |
O nome da cidade onde a organização do certificado está localizada. Caracteres chineses, caracteres ingleses e outros caracteres são suportados. O valor padrão é o nome da cidade onde a organização do certificado de sub-CA que emite este certificado está localizada. |
Hangzhou |
| Algorithm |
string |
Não |
O algoritmo de chave do certificado de cliente. O algoritmo de chave está no formato
O algoritmo de criptografia do certificado de cliente deve ser o mesmo do certificado de sub-CA, mas o tamanho da chave pode ser diferente. Por exemplo, se o algoritmo de chave do certificado de sub-CA for RSA_2048, o algoritmo de chave do certificado de cliente deve ser um entre RSA_1024, RSA_2048 ou RSA_4096. Nota
Você pode chamar DescribeCACertificate para consultar o algoritmo de chave do certificado de sub-CA. |
RSA_2048 |
| ParentIdentifier |
string |
Não |
O identificador único do certificado de sub-CA que emite este certificado. Nota
Você pode chamar DescribeCACertificateList para consultar o identificador único do certificado de sub-CA. |
270ae6bb538d538c70c01f81fg3**** |
| Years |
integer |
Não |
O período de validade do certificado. Unidade: anos. |
1 |
| Months |
integer |
Não |
O período de validade do certificado. Unidade: meses. |
12 |
| Days |
integer |
Não |
O período de validade do certificado de cliente. Unidade: dias. Os parâmetros Days, BeforeTime e AfterTime não podem estar todos vazios. Os parâmetros BeforeTime e AfterTime devem estar ambos vazios ou ambos especificados. As seguintes regras se aplicam:
Nota
|
365 |
| BeforeTime |
integer |
Não |
A hora de emissão do certificado de cliente no formato de timestamp UNIX. O valor padrão é a hora em que você chama esta operação. Unidade: segundos. Nota
Os parâmetros BeforeTime e AfterTime devem estar ambos vazios ou ambos especificados. |
1634283958 |
| AfterTime |
integer |
Não |
A hora de expiração do certificado de cliente no formato de timestamp UNIX. Unidade: segundos. Nota
Os parâmetros BeforeTime e AfterTime devem estar ambos vazios ou ambos especificados. |
1665819958 |
| Immediately |
integer |
Não |
Especifica se o certificado digital deve ser retornado imediatamente. Valores válidos:
|
1 |
| EnableCrl |
integer |
Não |
Especifica se o endereço da Lista de Revogação de Certificados (CRL) deve ser incluído. Valores válidos:
|
1 |
| Tags |
array<object> |
Não |
A lista de tags. |
|
|
object |
Não |
A lista de tags. |
||
| Key |
string |
Não |
A chave da tag. |
database |
| Value |
string |
Não |
O valor da tag. |
1 |
| ResourceGroupId |
string |
Não |
O ID do grupo de recursos ao qual o certificado pertence. |
rg-ae******4wia |
| CustomIdentifier |
string |
Não |
O identificador personalizado, que serve como uma chave única. |
***e6bb538d538c70c01f81fg3**** |
| AsynchronousFlag |
boolean |
Não |
O sinalizador de processamento assíncrono. Se o valor for "true", o serviço de backend emite o certificado de forma assíncrona. Após a solicitação ser enviada, você pode chamar a operação ListClientCertificate para obter o certificado mais recente. |
false |
Ao chamar esta operação, você deve incluir parâmetros de solicitação comuns das APIs da Alibaba Cloud, além dos parâmetros de solicitação descritos neste tópico.
Para o formato da solicitação, consulte os exemplos de solicitação na seção Exemplos deste tópico.
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
CreateCertificateResponse |
||
| X509Certificate |
string |
O conteúdo do certificado de cliente. |
-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE----- |
| CertificateChain |
string |
A cadeia de certificados da CA. |
-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n |
| Identifier |
string |
O identificador único do certificado de cliente. |
200ae6bb538d538c70c01f81dcf2**** |
| SerialNumber |
string |
O número de série do certificado. |
084bde9cd233f0ddae33adc438cfbbbd**** |
| RequestId |
string |
O ID da solicitação. A Alibaba Cloud gera um identificador único para cada solicitação de API. Você pode usar este ID para solucionar problemas. |
31C66C7B-671A-4297-9187-2C4477247A74 |
| CertSignBufKmc |
string |
O conteúdo do certificado criptografado. |
MIIDYDCCAwWgAwIBAgIU *** TmTk0CS3WNweqsjMEETyxd2pzU6DA |
| CertKmcRep1 |
string |
O texto cifrado do certificado criptografado. |
userSeal=MHkCIEu94PQAahFWuFk% *** EtFw%2FkMMBjw8i5bFfSkV%2FIUrcOJD |
Exemplos
Resposta de sucesso
JSON formato
{
"X509Certificate": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----",
"CertificateChain": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n",
"Identifier": "200ae6bb538d538c70c01f81dcf2****",
"SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
"RequestId": "31C66C7B-671A-4297-9187-2C4477247A74",
"CertSignBufKmc": "MIIDYDCCAwWgAwIBAgIU\n***\nTmTk0CS3WNweqsjMEETyxd2pzU6DA",
"CertKmcRep1": "userSeal=MHkCIEu94PQAahFWuFk%\n***\nEtFw%2FkMMBjw8i5bFfSkV%2FIUrcOJD"
}
Códigos de erro
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.