Funções de atributo
Os atributos podem ser adicionados a uma solicitação de certificado para fornecer a uma AC (autoridade de certificação ) informações adicionais que podem ser usadas ao criar e emitir um certificado.
CertEnroll.dll implementa as seguintes interfaces para definir atributos e coleções de atributos:
- ICryptAttribute
- ICryptAttributes
- IX509Attribute
- IX509Attributes
- IX509AttributeClientId
- IX509AttributeExtensions
- IX509AttributeArchiveKey
- IX509AttributeArchiveKeyHash
- IX509AttributeCspProvider
- IX509AttributeOSVersion
- IX509AttributeRenewalCertificate
As seções a seguir identificam as funções exportadas por Xenroll.dll associar atributos criptográficos a solicitações de certificado e discutir como usar CertEnroll.dll para substituir a função ou indicar que não existe nenhum mapeamento entre as duas bibliotecas:
- addAttributeToRequestWStr
- AddAuthenticatedAttributesToPKCS7Request
- addNameValuePairToRequestWStr
- AddNameValuePairToSignatureWStr
- Clientid
- RenewalCertificate
- resetAttributes
- Tópicos relacionados
addAttributeToRequestWStr
A função addAttributeToRequestWStr em Xenroll.dll adiciona um atributo a uma solicitação de certificado.
Em geral, para adicionar um atributo a uma solicitação usando os objetos implementados no CertEnroll.dll, você pode executar as seguintes ações:
- Crie um objeto de coleção IX509Attributes .
- Crie um objeto IX509Attribute e chame o método Initialize para criar um atributo de um identificador de objeto e um valor de atributo ou use qualquer uma das interfaces listadas anteriormente para definir um dos atributos mais comuns.
- Adicione cada novo atributo criado na etapa anterior à coleção IX509Attributes usando o método Add .
- Crie um objeto ICryptAttribute e inicialize-o chamando o método InitializeFromValues e especificando a coleção IX509Attributes na entrada.
- Recupere um objeto de coleção ICryptAttributes chamando a propriedade CryptAttributes em um objeto de solicitação IX509CertificateRequestPkcs10 ou IX509CertificateRequestCmc existente.
- Adicione o objeto ICryptAttribute à coleção ICryptAttributes .
AddAuthenticatedAttributesToPKCS7Request
Os atributos autenticados são pares nome-valor assinados e adicionados a uma assinatura. A função AddAuthenticatedAttributesToPKCS7Request em Xenroll.dll adiciona uma matriz de atributos autenticados a uma solicitação PKCS nº 7 .
Conforme discutido acima para a função addAttributeToRequestWStr , você pode usar CertEnroll.dll para definir e adicionar facilmente uma coleção de atributos a uma solicitação de certificado. No entanto, não é possível escolher se o atributo está autenticado. O processo de registro toma essa decisão automaticamente.
addNameValuePairToRequestWStr
A função addNameValuePairToRequestWStr em Xenroll.dll adiciona um par nome-valor não autenticado a uma solicitação.
Você pode usar a interface IX509NameValuePair em CertEnroll.dll para definir um par nome-valor e pode adicionar uma coleção de pares nome-valor a um objeto de solicitação CMC executando as seguintes ações:
- Crie e inicialize um objeto IX509CertificateRequestCmc . O processo de inicialização cria uma coleção IX509NameValuePairs vazia.
- Chame a propriedade NameValuePairs em um objeto de solicitação CMC existente para recuperar a coleção.
- Crie e inicialize um objeto IX509NameValuePair .
- Adicione cada novo par nome-valor à coleção IX509NameValuePairs chamando o método Add .
O processo de registro coloca a coleção de pares nome-valor na estrutura TaggedAttribute da solicitação CMC.
AddNameValuePairToSignatureWStr
A função AddNameValuePairToSignatureWStr em Xenroll.dll adiciona um par nome-valor autenticado a uma solicitação. Normalmente, isso é usado para especificar o nome do solicitante em uma solicitação de registro em nome do (EOBO).
Em CertEnroll.dll, use a propriedade RequesterName para especificar o nome em uma solicitação EOBO.
ClientId
A função ClientId em Xenroll.dll especifica ou recupera um atributo ClientId .
Use a propriedade ClientId em CertEnroll.dll para adicionar esse atributo a uma solicitação CMC ou PKCS #10.
RenewalCertificate
A função RenewalCertificate em Xenroll.dll especifica ou recupera um atributo RenewalCertificate .
Em CertEnroll.dll, quando você chama InitializeFromCertificate em um objeto PKCS #7 ou PKCS ) é criado automaticamente.
resetAttributes
A função resetAttributes em Xenroll.dll remove a coleção de atributos de uma solicitação.
Para remover um atributo de uma solicitação por índice usando CertEnroll.dll, chame o método Remove na coleção IX509Attributes . Para remover todos os atributos de uma solicitação, chame o método Clear .
Tópicos relacionados