CertificateRevocationListBuilder.Build Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
Build(X509Certificate2, BigInteger, DateTimeOffset, HashAlgorithmName, RSASignaturePadding, Nullable<DateTimeOffset>) |
Cria uma CRL (Lista de Revogação de Certificados) assinada pelo certificado especificado. |
Build(X500DistinguishedName, X509SignatureGenerator, BigInteger, DateTimeOffset, HashAlgorithmName, X509AuthorityKeyIdentifierExtension, Nullable<DateTimeOffset>) |
Cria uma CRL (Lista de Revogação de Certificados). |
Build(X509Certificate2, BigInteger, DateTimeOffset, HashAlgorithmName, RSASignaturePadding, Nullable<DateTimeOffset>)
Cria uma CRL (Lista de Revogação de Certificados) assinada pelo certificado especificado.
public byte[] Build (System.Security.Cryptography.X509Certificates.X509Certificate2 issuerCertificate, System.Numerics.BigInteger crlNumber, DateTimeOffset nextUpdate, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, System.Security.Cryptography.RSASignaturePadding? rsaSignaturePadding = default, DateTimeOffset? thisUpdate = default);
member this.Build : System.Security.Cryptography.X509Certificates.X509Certificate2 * System.Numerics.BigInteger * DateTimeOffset * System.Security.Cryptography.HashAlgorithmName * System.Security.Cryptography.RSASignaturePadding * Nullable<DateTimeOffset> -> byte[]
Public Function Build (issuerCertificate As X509Certificate2, crlNumber As BigInteger, nextUpdate As DateTimeOffset, hashAlgorithm As HashAlgorithmName, Optional rsaSignaturePadding As RSASignaturePadding = Nothing, Optional thisUpdate As Nullable(Of DateTimeOffset) = Nothing) As Byte()
Parâmetros
- issuerCertificate
- X509Certificate2
O certificado que representa a AC (Autoridade de Certificação) que está criando esta Lista de Revogação de Certificados.
- crlNumber
- BigInteger
O número de sequência para essa CRL. Por RFC 5280 do IETF, esse valor sempre deve aumentar de uma CRL para a próxima para uma determinada AC.
- nextUpdate
- DateTimeOffset
A hora mais recente possível antes de a AC publicar uma CRL mais recente, geralmente tratada como uma data de validade para essa CRL.
- hashAlgorithm
- HashAlgorithmName
O algoritmo de hash a ser usado ao assinar a CRL.
- rsaSignaturePadding
- RSASignaturePadding
Para Autoridades de Certificado com chaves RSA, esse parâmetro é necessário e especifica o modo de preenchimento de assinatura RSA a ser usado ao assinar a CRL.
Para todos os outros algoritmos, esse parâmetro é ignorado.
O padrão é null
.
- thisUpdate
- Nullable<DateTimeOffset>
Um valor opcional que especifica quando essa CRL foi criada ou null
para usar a hora atual do sistema.
O padrão é null
.
Retornos
Uma matriz que contém os bytes da CRL assinada.
Exceções
issuerCertificate
não tem uma chave privada associada.
-ou-
issuerCertificate
usa um algoritmo de chave pública que é desconhecido ou não é compatível com essa implementação.
-ou-
issuerCertificate
não tem uma extensão restrições básicas.
-ou-
issuerCertificate
tem uma extensão de Restrições Básicas que indica que não é um certificado válido da Autoridade de Certificação.
-ou-
issuerCertificate
tem uma extensão uso de chave que não tem o CrlSign uso.
-ou-
issuerCertificate
tem uma chave privada RSA, mas rsaSignaturePadding
é null
.
-ou-
issuerCertificate
tem um algoritmo de chave desconhecido.
-ou-
nextUpdate
é mais antigo que thisUpdate
.
-ou-
hashAlgorithm
tem a cadeia de caracteres vazia como o valor de Name.
-ou-
rsaSignaturePadding
não foi reconhecido.
crlNumber
é negativo.
ocorreu um erro durante a assinatura.
Aplica-se a
Build(X500DistinguishedName, X509SignatureGenerator, BigInteger, DateTimeOffset, HashAlgorithmName, X509AuthorityKeyIdentifierExtension, Nullable<DateTimeOffset>)
Cria uma CRL (Lista de Revogação de Certificados).
public byte[] Build (System.Security.Cryptography.X509Certificates.X500DistinguishedName issuerName, System.Security.Cryptography.X509Certificates.X509SignatureGenerator generator, System.Numerics.BigInteger crlNumber, DateTimeOffset nextUpdate, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, System.Security.Cryptography.X509Certificates.X509AuthorityKeyIdentifierExtension authorityKeyIdentifier, DateTimeOffset? thisUpdate = default);
member this.Build : System.Security.Cryptography.X509Certificates.X500DistinguishedName * System.Security.Cryptography.X509Certificates.X509SignatureGenerator * System.Numerics.BigInteger * DateTimeOffset * System.Security.Cryptography.HashAlgorithmName * System.Security.Cryptography.X509Certificates.X509AuthorityKeyIdentifierExtension * Nullable<DateTimeOffset> -> byte[]
Public Function Build (issuerName As X500DistinguishedName, generator As X509SignatureGenerator, crlNumber As BigInteger, nextUpdate As DateTimeOffset, hashAlgorithm As HashAlgorithmName, authorityKeyIdentifier As X509AuthorityKeyIdentifierExtension, Optional thisUpdate As Nullable(Of DateTimeOffset) = Nothing) As Byte()
Parâmetros
- issuerName
- X500DistinguishedName
O nome da entidade do certificado para a AC (Autoridade de Certificação) que está emitindo essa CRL.
- generator
- X509SignatureGenerator
Um gerador de assinatura para produzir a assinatura de AC para essa CRL.
- crlNumber
- BigInteger
O número de sequência para essa CRL. Por RFC 5280 do IETF, esse valor sempre deve aumentar de uma CRL para a próxima para uma determinada AC.
- nextUpdate
- DateTimeOffset
A hora mais recente possível antes de a AC publicar uma CRL mais recente, geralmente tratada como uma data de validade para essa CRL.
- hashAlgorithm
- HashAlgorithmName
O algoritmo de hash a ser usado ao assinar a CRL.
- authorityKeyIdentifier
- X509AuthorityKeyIdentifierExtension
O Identificador de Chave de Autoridade a ser usado nesta CRL, identificando o certificado de autoridade de certificação.
- thisUpdate
- Nullable<DateTimeOffset>
Um valor opcional que especifica quando essa CRL foi criada ou null
para usar a hora atual do sistema.
O padrão é null
.
Retornos
Uma matriz que contém os bytes da CRL assinada.
Exceções
issuerName
, generator
ou authorityKeyIdentifier
é null
.
- ou -
hashAlgorithm
tem null
como o valor de Name.
nextUpdate
é mais antigo que thisUpdate
.
-ou-
hashAlgorithm
tem a cadeia de caracteres vazia como o valor de Name.
crlNumber
é negativo.
ocorreu um erro durante a assinatura.