Todos os produtos
Search
Central de documentação

Certificate Management Service:CreateClientCertificateWithCsr

Última atualização: Aug 24, 2026

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

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

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:

  • 0: otherName (0): outro nome.

  • 1: rfc822Name (1): nome RFC 822, que normalmente é um endereço de e-mail.

  • 2: dNSName (2): nome DNS (nome de domínio).

  • 3: x400Address (3): endereço X.400, um padrão antigo de endereço de e-mail.

  • 4: directoryName (4): nome de diretório, que normalmente é um nome distinto (DN) X.500.

  • 5: ediPartyName (5): nome da parte de Electronic Data Interchange (EDI).

  • 6: uniformResourceIdentifier (6): Uniform Resource Identifier (URI).

  • 7: iPAddress (7): endereço IP.

  • 8: registeredID (8): ID registrado (Object Identifier, OID).

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 (,).

  1. otherName (0): outro nome

  • Exemplo: 1.3.6.1.4.1.311.20.2.3 (OID) + user@domain.com (UPN, User Principal Name)

  • Descrição: Um tipo de extensão personalizada que geralmente consiste em um OID (Object Identifier) específico e um valor correspondente. Em ambientes Windows, é comumente usado para armazenar UPN (User Principal Name), como zhangsan@company.com para logon com cartão inteligente.

  1. rfc822Name (1): nome RFC 822 (endereço de e-mail)

  • Exemplo: admin@example.com,support@company.cn

  • Descrição: Um endereço de e-mail da Internet que está em conformidade com o padrão RFC 822. É comumente usado em certificados de assinatura e criptografia de e-mail S/MIME para identificar o remetente ou destinatário de um e-mail.

  • dNSName (2): nome DNS (nome de domínio)

  • Exemplo: www.example.com,api.test.cn,*.mydomain.com (nome de domínio curinga)

  • Descrição: O tipo mais comumente usado em certificados SSL/TLS de sites HTTPS. Um certificado pode conter vários nomes DNS através da extensão SAN, permitindo que um único certificado proteja vários subdomínios ou nomes de domínio completamente diferentes.

  1. x400Address (3): endereço X.400

  • Exemplo: G=Zhang; S=San; O=Company; PRMD=IT; ADMD=Telecom; C=CN

  • Descrição: Um padrão antigo de endereço de sistema de e-mail com uma estrutura complexa que inclui atributos como país (C), domínio de administração (ADMD), organização (O), sobrenome (S) e nome próprio (G). É raramente usado em certificados HTTPS modernos da Internet e é encontrado principalmente em sistemas de comunicação tradicionais de governos europeus, empresas ou militares.

  1. directoryName (4): nome de diretório

  • Exemplo: CN=IT Department, OU=Tech, O=Company Ltd, L=Beijing, ST=Beijing, C=CN

  • Descrição: Um nome distinto (DN) X.500 padrão. É tipicamente usado para identificar explicitamente as informações hierárquicas completas de uma organização, departamento ou entidade em um certificado. É comumente encontrado em certificados raiz internos de empresas ou certificados digitais governamentais específicos.

  1. ediPartyName (5): nome da parte EDI

  • Exemplo: nameAssigner=GlobalTradeOrg, partyName=SupplierA

  • Descrição: Usado especificamente no domínio de Electronic Data Interchange (EDI). Identifica uma parte específica em trocas de mensagens comerciais (como transmissões de pedidos e faturas) e normalmente inclui a autoridade atribuidora de nomes (nameAssigner) e o nome da parte (partyName).

  1. uniformResourceIdentifier (6): Uniform Resource Identifier (URI)

  • Exemplo: http://www.example.com/verify,https://api.test.cn/status

  • Descrição: Um formato de URL padrão que deve incluir um prefixo de protocolo (como http:// ou https://). Pode apontar para um endereço de recurso de rede específico.

  1. iPAddress (7): endereço IP

  • Exemplo: 192.168.1.100 (IPv4), 2001:0db8:85a3::8a2e:0370:7334 (IPv6)

  • Descrição: Vincula-se diretamente a um endereço IP de servidor. É comumente usado para sistemas internos sem nomes de domínio, servidores de API ou serviços específicos que só podem ser acessados através de um endereço IP público. Nota: Certificados de IP público normalmente exigem Validação de Organização (OV) rigorosa.

  1. registeredID (8): ID registrado (Object Identifier, OID)

  • Exemplo: 1.2.3.4.55.6.5.99, 2.5.29.17

  • Descrição: Um identificador numérico único atribuído por organizações de padrões internacionais. É raramente usado diretamente como nome de assunto em certificados e é mais comumente usado como um código de identidade único ou identificador de política dentro de sistemas.

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 <algoritmo de criptografia>_<tamanho da chave>. Valores válidos:

  • RSA_1024: O algoritmo de assinatura é Sha256WithRSA.

  • RSA_2048: O algoritmo de assinatura é Sha256WithRSA.

  • RSA_4096: O algoritmo de assinatura é Sha256WithRSA.

  • ECC_256: O algoritmo de assinatura é Sha256WithECDSA.

  • ECC_384: O algoritmo de assinatura é Sha256WithECDSA.

  • ECC_512: O algoritmo de assinatura é Sha256WithECDSA.

  • SM2_256: O algoritmo de assinatura é SM3WithSM2.

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:

  • Se você definir o parâmetro Days, poderá optar por definir ou não os parâmetros BeforeTime e AfterTime.

  • Se você não definir o parâmetro Days, deverá definir os parâmetros BeforeTime e AfterTime.

Nota
  • Se você definir os parâmetros Days, BeforeTime e AfterTime ao mesmo tempo, o período de validade do certificado de cliente será determinado pelo valor do parâmetro Days.

  • O período de validade do certificado de cliente não pode exceder o período de validade do certificado de sub-CA. Você pode chamar DescribeCACertificate para visualizar o período de validade do certificado de sub-CA.

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:

  • 0: não retorna o certificado. Este é o valor padrão.

  • 1: retorna o certificado.

  • 2: retorna o certificado e sua cadeia de certificados.

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:

  • 0: não.

  • 1: sim.

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.