IX509CertificateRequest::get_AlternateSignatureAlgorithm-Methode (certenroll.h)

Artikel
08/22/2023

Die AlternateSignatureAlgorithm-Eigenschaft gibt einen booleschen Wert an und ruft diesen ab, der angibt, ob der Signaturalgorithmus-Objektbezeichner (OID) für eine PKCS #10-Anforderung oder Zertifikatsignatur diskret oder kombiniert ist. Ein PKCS #10-Objekt kann eine eigenständige Anforderung sein oder in einem CMC- oder PKCS #7-Anforderungsobjekt enthalten sein.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_AlternateSignatureAlgorithm(
  VARIANT_BOOL *pValue
);

Parameter

pValue

Rückgabewert

Keine

Bemerkungen

Diskrete Algorithmen werden durch separate Objektbezeichner (OIDs) für den Hashingalgorithmus und den Signaturalgorithmus dargestellt. Beispiele hierfür sind die folgenden Werte.

Diskrete Algorithmus-OID	BESCHREIBUNG
XCN_OID_NIST_sha256 (2.16.840.1.101.3.4.2.1)	256-Bit-SHA-Hashalgorithmus des National Institute of Standards and Technologies (NIST).
XCN_OID_OIWSEC_rsaSign (1.3.14.3.2.11)	NIST OSE Implementer Workshop Security (OIWSEC) RSA-Signaturalgorithmus.

Kombinierte Algorithmen werden durch eine einzelne OID dargestellt, die sowohl den Hashing- als auch den Signaturalgorithmus identifiziert. Beispiele hierfür sind die folgenden Werte.

Kombinierte Algorithmus-OID	BESCHREIBUNG
XCN_OID_RSA_MD2RSA (1.2.840.113549.1.1.2)	MD2-Hashalgorithmus kombiniert mit dem RSA-Verschlüsselungsalgorithmus von RSA Laboratories.
XCN_OID_OIWSEC_md5RSA (1.3.14.3.2.3)	OIWSEC MD5 Hashalgorithmus kombiniert mit dem RSA-Verschlüsselungsalgorithmus.

Wenn die Zertifikatanforderung geschachtelte Anforderungen enthält und Sie die AlternateSignatureAlgorithm-Eigenschaft für die Anforderung der obersten Ebene festlegen, wird sie automatisch an alle inneren Anforderungen weitergegeben. Sie können die -Eigenschaft jedoch manuell für jedes der inneren Objekte festlegen.

Bei einer PKCS #7- oder CMC-Anforderung ruft diese Eigenschaft einen booleschen Wert für die primäre Signatur in der inneren PKCS #10-Anforderung ab. Bei der Eingabe werden alle Signaturzertifikate mit dem angegebenen Eigenschaftswert aktualisiert.

Für eine PKCS #10-Anforderung oder Zertifikatsignatur mit dem RSA-Algorithmus mit öffentlichem Schlüssel impliziert der Eigenschaftswert False (der eine kombinierte OID angibt) eine Signatur der Version 1.5 und True (diskrete OID) eine Signatur der Version 2.1.

Sie müssen das Anforderungsobjekt initialisieren, bevor Sie diese Eigenschaft aufrufen. Sie können diese Eigenschaft aufrufen, bevor Sie die Encode-Methode aufrufen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h
DLL	CertEnroll.dll