MessageVerifier Module

Properties   Methods   Events   Config Settings   Errors  

The MessageVerifier module verifies digital signatures of data stored in the PKCS#7 format.

Syntax

SecureBlackbox.MessageVerifier

Remarks

PKCS#7 (Public Key Cryptography Standard #7) is a common format used to store encrypted and signed data. It is used by a variety of protocols, including S/MIME and CMS.

MessageVerifier can process signed data in PKCS#7 SignedData and AuthenticatedData subformats. RSA, ECDSA, and EdDSA algorithms are supported.

Setting up and using MessageVerifier is easy:

• Set up your source and destination via InputFile (InputBytes) and OutputFile (OutputBytes) properties. For detached signatures, provide the signed data separately via DataFile (DataBytes).
• For the SignedData-type signatures (most commonly used), add the public part of the signing certificate to the Certificates collection. This step may be unnecessary, as it is typical for signers to include their certificates in the signature.
• For the AuthenticatedData-type signature, add the recipient's (i.e. your) certificate, with its private key, to Certificates collection.
• Call Verify or VerifyDetached, as appropriate, to execute the validation operation.
• Post-validation, you can get access to signature properties, such as ClaimedSigningTime, SignedAttributes, and UnsignedAttributes.

Note that MessageVerifier can only work with binary PKCS#7-compliant and PKCS#1-compliant signatures. To process S/MIME-signed emails, see MailReader. To process PGP signatures, see PGPReader.

MessageVerifier is a simplified form of CAdESVerifier. Both classes work with PKCS#7 signed messages. CAdESVerifier, however, provides support for advanced (CAdES) signatures, including long-term validity, archival, and full chain validation capabilities. These advanced capabilities are absent from MessageVerifier, which is only capable of processing basic PKCS#7 signatures without any chain of trust validation. MessageVerifier verifier = new MessageVerifier(); // Select the file which contains the signed message verifier.setInputFile("signedMessage.bin"); if (verifier.checkSignatureType() == Constants.stPKCS7Detached) { // To verify a detached signature, we need // to provide both the signature and the original data verifier.setDataFile("message.txt"); verifier.verifyDetached(); } else { // To verify an enveloping signature, we need // to provide the location to extract the data verifier.setOutputFile("output.txt"); verifier.verify(); } System.out.println("Validation result: " + verifier.getSignatureValidationResult() + "\n" + "Signing time: " + verifier.getValidatedSigningTime() + "\n" + "TSA certificate: " + verifier.getSigningCertificate().getSubjectRDN()); // Output: // // Validation result: 0 // 0 == svtValid // Signing time: 2024-05-16 15:18:35 // TSA certificate: /CN=Test Certificate

Property List

The following is the full list of the properties of the module with short descriptions. Click on the links for further details.

Method List

The following is the full list of the methods of the module with short descriptions. Click on the links for further details.

Event List

The following is the full list of the events fired by the module with short descriptions. Click on the links for further details.

Config Settings

The following is a list of config settings for the module with short descriptions. Click on the links for further details.

Certificates Property (MessageVerifier Module)

A collection of certificates included in the electronic signature.

Syntax

• Swift
• Objective-C

public var certificates: Array<Certificate> {
  get {...}
}

@property (nonatomic,readonly,assign,getter=certCount) int certCount;

- (int)certCount;

- (NSData*)certBytes:(int)certIndex;

- (BOOL)certCA:(int)certIndex;

- (NSData*)certCAKeyID:(int)certIndex;

- (int)certCertType:(int)certIndex;

- (NSString*)certCRLDistributionPoints:(int)certIndex;

- (NSString*)certCurve:(int)certIndex;

- (NSString*)certFingerprint:(int)certIndex;

- (NSString*)certFriendlyName:(int)certIndex;

- (long long)certHandle:(int)certIndex;

- (NSString*)certHashAlgorithm:(int)certIndex;

- (NSString*)certIssuer:(int)certIndex;

- (NSString*)certIssuerRDN:(int)certIndex;

- (NSString*)certKeyAlgorithm:(int)certIndex;

- (int)certKeyBits:(int)certIndex;

- (NSString*)certKeyFingerprint:(int)certIndex;

- (int)certKeyUsage:(int)certIndex;

- (BOOL)certKeyValid:(int)certIndex;

- (NSString*)certOCSPLocations:(int)certIndex;

- (BOOL)certOCSPNoCheck:(int)certIndex;

- (int)certOrigin:(int)certIndex;

- (NSString*)certPolicyIDs:(int)certIndex;

- (NSData*)certPrivateKeyBytes:(int)certIndex;

- (BOOL)certPrivateKeyExists:(int)certIndex;

- (BOOL)certPrivateKeyExtractable:(int)certIndex;

- (NSData*)certPublicKeyBytes:(int)certIndex;

- (BOOL)certQualified:(int)certIndex;

- (int)certQualifiedStatements:(int)certIndex;

- (NSString*)certQualifiers:(int)certIndex;

- (BOOL)certSelfSigned:(int)certIndex;

- (NSData*)certSerialNumber:(int)certIndex;

- (NSString*)certSigAlgorithm:(int)certIndex;

- (int)certSource:(int)certIndex;

- (NSString*)certSubject:(int)certIndex;

- (NSString*)certSubjectAlternativeName:(int)certIndex;

- (NSData*)certSubjectKeyID:(int)certIndex;

- (NSString*)certSubjectRDN:(int)certIndex;

- (BOOL)certValid:(int)certIndex;

- (NSString*)certValidFrom:(int)certIndex;

- (NSString*)certValidTo:(int)certIndex;

Default Value

""

Remarks

This property includes a collection of certificates of the currently selected info.

This property is read-only.

ClaimedSigningTime Property (MessageVerifier Module)

Returns a signature's claimed signing time.

Syntax

• Swift
• Objective-C

public var claimedSigningTime: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=claimedSigningTime) NSString* claimedSigningTime;

- (NSString*)claimedSigningTime;

Default Value

""

Remarks

Use this property to get the signature creation time from the signer's computer. Note that the claimed time is not covered by the signature and may be forfeited or wrong. Use ValidatedSigningTime to obtain the signing time figure verified by a trusted timestamping authority. The time is in UTC.

This property is read-only.

ContentType Property (MessageVerifier Module)

A content type property of the signed message.

Syntax

• Swift
• Objective-C

public var contentType: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=contentType) NSString* contentType;

- (NSString*)contentType;

Default Value

""

Remarks

Use this property to check the content type property of the processed signed message.

This property is read-only.

DataBytes Property (MessageVerifier Module)

Use this property to pass the original signed data to module in the byte array form.

Syntax

• Swift
• Objective-C

public var dataBytes: Data {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=dataBytes,setter=setDataBytes:) NSData* dataBytes;

- (NSData*)dataBytes;
- (void)setDataBytes :(NSData*)newDataBytes;

Remarks

When validating detached signatures, assign a byte array containing the signed data to this property.

DataFile Property (MessageVerifier Module)

The name of the file containing the original signed data.

Syntax

• Swift
• Objective-C

public var dataFile: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=dataFile,setter=setDataFile:) NSString* dataFile;

- (NSString*)dataFile;
- (void)setDataFile :(NSString*)newDataFile;

Default Value

""

Remarks

Use this property to provide the original data when validating detached signatures with VerifyDetached.

FIPSMode Property (MessageVerifier Module)

Reserved.

Syntax

• Swift
• Objective-C

public var fipsMode: Bool {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=FIPSMode,setter=setFIPSMode:) BOOL FIPSMode;

- (BOOL)FIPSMode;
- (void)setFIPSMode :(BOOL)newFIPSMode;

Default Value

False

Remarks

This property is reserved for future use.

HashAlgorithm Property (MessageVerifier Module)

Hash algorithm which was used to calculate the signature.

Syntax

• Swift
• Objective-C

public var hashAlgorithm: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=hashAlgorithm,setter=setHashAlgorithm:) NSString* hashAlgorithm;

- (NSString*)hashAlgorithm;
- (void)setHashAlgorithm :(NSString*)newHashAlgorithm;

Default Value

""

Remarks

Check this property after calling Verify or VerifyDetached to get the hash algorithm that was used to calculate the signature message digest.

InputBytes Property (MessageVerifier Module)

Use this property to pass the input to module in byte array form.

Syntax

• Swift
• Objective-C

public var inputBytes: Data {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=inputBytes,setter=setInputBytes:) NSData* inputBytes;

- (NSData*)inputBytes;
- (void)setInputBytes :(NSData*)newInputBytes;

Remarks

Assign a byte array containing the data to be processed to this property.

InputFile Property (MessageVerifier Module)

Path to the file containing the signed message.

Syntax

• Swift
• Objective-C

public var inputFile: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=inputFile,setter=setInputFile:) NSString* inputFile;

- (NSString*)inputFile;
- (void)setInputFile :(NSString*)newInputFile;

Default Value

""

Remarks

Use this property to provide a file containing the signed data, either enveloping or detached.

InputIsHash Property (MessageVerifier Module)

Specifies whether the input source contains the hash of the data or the actual data.

Syntax

• Swift
• Objective-C

public var inputIsHash: Bool {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=inputIsHash,setter=setInputIsHash:) BOOL inputIsHash;

- (BOOL)inputIsHash;
- (void)setInputIsHash :(BOOL)newInputIsHash;

Default Value

False

Remarks

Use this property to tell the component whether the input source contains the actual data or its hash.

KnownCertificates Property (MessageVerifier Module)

Additional certificates for chain validation.

Syntax

• Swift
• Objective-C

public var knownCertificates: Array<Certificate> {
  get {...}
}

@property (nonatomic,readwrite,assign,getter=knownCertCount,setter=setKnownCertCount:) int knownCertCount;

- (int)knownCertCount;
- (void)setKnownCertCount :(int)newKnownCertCount;

- (NSData*)knownCertBytes:(int)knownCertIndex;

- (long long)knownCertHandle:(int)knownCertIndex;
- (void)setKnownCertHandle:(int)knownCertIndex :(long long)newKnownCertHandle;

Default Value

""

Remarks

Use this property to supply a list of additional certificates that might be needed for chain validation. An example of a scenario where you might want to do that is when intermediary CA certificates are absent from the standard system locations (or when there are no standard system locations), and therefore should be supplied to the class manually.

The purpose of the certificates to be added to this collection is roughly equivalent to that of the Intermediate Certification Authorities system store in Windows.

Do not add trust anchors or root certificates to this collection: add them to TrustedCertificates instead.

This property is read-only.

MACAlgorithm Property (MessageVerifier Module)

Specifies the hash algorithm to be used.

Syntax

• Swift
• Objective-C

public var macAlgorithm: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=MACAlgorithm) NSString* MACAlgorithm;

- (NSString*)MACAlgorithm;

Default Value

"SHA256"

Remarks

This property specifies the MAC algorithm that was used to calculate an authenticated signature.

This property is read-only.

OutputBytes Property (MessageVerifier Module)

Use this property to read the output the module object has produced.

Syntax

• Swift
• Objective-C

public var outputBytes: Data {
  get {...}
}

@property (nonatomic,readonly,assign,getter=outputBytes) NSData* outputBytes;

- (NSData*)outputBytes;

Remarks

Read the contents of this property after the operation has completed to read the produced output. This property will only be set if the OutputFile and OutputStream properties had not been assigned.

This property is read-only.

OutputFile Property (MessageVerifier Module)

Path to the file to save the extracted data to.

Syntax

• Swift
• Objective-C

public var outputFile: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=outputFile,setter=setOutputFile:) NSString* outputFile;

- (NSString*)outputFile;
- (void)setOutputFile :(NSString*)newOutputFile;

Default Value

""

Remarks

Use this property when validating enveloping signatures to specify the output file where the extracted message should be saved.

SignatureType Property (MessageVerifier Module)

The type of the processed signature.

Syntax

• Swift
• Objective-C

public var signatureType: MessageVerifierSignatureTypes {
  get {...}
}

public enum MessageVerifierSignatureTypes: Int32 {
  case stUnknown = 0
  case stPKCS1Detached = 1
  case stPKCS7Detached = 2
  case stPKCS7Enveloping = 3
  case stPKCS7MACDetached = 4
  case stPKCS7MACEnveloping = 5
}

@property (nonatomic,readonly,assign,getter=signatureType) int signatureType;

- (int)signatureType;

Default Value

0

Remarks

Use this property to check the result of the most recent signature validation.

This property is read-only.

SignatureValidationResult Property (MessageVerifier Module)

The signature validation result.

Syntax

• Swift
• Objective-C

public var signatureValidationResult: MessageVerifierSignatureValidationResults {
  get {...}
}

public enum MessageVerifierSignatureValidationResults: Int32 {
  case svtValid = 0
  case svtUnknown = 1
  case svtCorrupted = 2
  case svtSignerNotFound = 3
  case svtFailure = 4
  case svtReferenceCorrupted = 5
}

@property (nonatomic,readonly,assign,getter=signatureValidationResult) int signatureValidationResult;

- (int)signatureValidationResult;

Default Value

0

Remarks

Use this property to check the result of the most recent signature validation.

This property is read-only.

SignedAttributes Property (MessageVerifier Module)

Custom signature attributes that are covered by the electronic signature.

Syntax

• Swift
• Objective-C

public var signedAttributes: Array<SignatureAttribute> {
  get {...}
}

@property (nonatomic,readonly,assign,getter=signedAttributeCount) int signedAttributeCount;

- (int)signedAttributeCount;

- (NSString*)signedAttributeOID:(int)signedAttributeIndex;

- (NSData*)signedAttributeValue:(int)signedAttributeIndex;

Default Value

""

Remarks

Signature attributes are used to store auxiliary information in the signature. Values included as signed attributes are covered by the signature.

This property is read-only.

SigningCertificate Property (MessageVerifier Module)

The certificate that was used to create the signature.

Syntax

• Swift
• Objective-C

public var signingCertificate: Certificate {
  get {...}
}

@property (nonatomic,readonly,assign,getter=signingCertBytes) NSData* signingCertBytes;

- (NSData*)signingCertBytes;

@property (nonatomic,readonly,assign,getter=signingCertCA) BOOL signingCertCA;

- (BOOL)signingCertCA;

@property (nonatomic,readonly,assign,getter=signingCertCAKeyID) NSData* signingCertCAKeyID;

- (NSData*)signingCertCAKeyID;

@property (nonatomic,readonly,assign,getter=signingCertCertType) int signingCertCertType;

- (int)signingCertCertType;

@property (nonatomic,readonly,assign,getter=signingCertCRLDistributionPoints) NSString* signingCertCRLDistributionPoints;

- (NSString*)signingCertCRLDistributionPoints;

@property (nonatomic,readonly,assign,getter=signingCertCurve) NSString* signingCertCurve;

- (NSString*)signingCertCurve;

@property (nonatomic,readonly,assign,getter=signingCertFingerprint) NSString* signingCertFingerprint;

- (NSString*)signingCertFingerprint;

@property (nonatomic,readonly,assign,getter=signingCertFriendlyName) NSString* signingCertFriendlyName;

- (NSString*)signingCertFriendlyName;

@property (nonatomic,readonly,assign,getter=signingCertHandle) long long signingCertHandle;

- (long long)signingCertHandle;

@property (nonatomic,readonly,assign,getter=signingCertHashAlgorithm) NSString* signingCertHashAlgorithm;

- (NSString*)signingCertHashAlgorithm;

@property (nonatomic,readonly,assign,getter=signingCertIssuer) NSString* signingCertIssuer;

- (NSString*)signingCertIssuer;

@property (nonatomic,readonly,assign,getter=signingCertIssuerRDN) NSString* signingCertIssuerRDN;

- (NSString*)signingCertIssuerRDN;

@property (nonatomic,readonly,assign,getter=signingCertKeyAlgorithm) NSString* signingCertKeyAlgorithm;

- (NSString*)signingCertKeyAlgorithm;

@property (nonatomic,readonly,assign,getter=signingCertKeyBits) int signingCertKeyBits;

- (int)signingCertKeyBits;

@property (nonatomic,readonly,assign,getter=signingCertKeyFingerprint) NSString* signingCertKeyFingerprint;

- (NSString*)signingCertKeyFingerprint;

@property (nonatomic,readonly,assign,getter=signingCertKeyUsage) int signingCertKeyUsage;

- (int)signingCertKeyUsage;

@property (nonatomic,readonly,assign,getter=signingCertKeyValid) BOOL signingCertKeyValid;

- (BOOL)signingCertKeyValid;

@property (nonatomic,readonly,assign,getter=signingCertOCSPLocations) NSString* signingCertOCSPLocations;

- (NSString*)signingCertOCSPLocations;

@property (nonatomic,readonly,assign,getter=signingCertOCSPNoCheck) BOOL signingCertOCSPNoCheck;

- (BOOL)signingCertOCSPNoCheck;

@property (nonatomic,readonly,assign,getter=signingCertOrigin) int signingCertOrigin;

- (int)signingCertOrigin;

@property (nonatomic,readonly,assign,getter=signingCertPolicyIDs) NSString* signingCertPolicyIDs;

- (NSString*)signingCertPolicyIDs;

@property (nonatomic,readonly,assign,getter=signingCertPrivateKeyBytes) NSData* signingCertPrivateKeyBytes;

- (NSData*)signingCertPrivateKeyBytes;

@property (nonatomic,readonly,assign,getter=signingCertPrivateKeyExists) BOOL signingCertPrivateKeyExists;

- (BOOL)signingCertPrivateKeyExists;

@property (nonatomic,readonly,assign,getter=signingCertPrivateKeyExtractable) BOOL signingCertPrivateKeyExtractable;

- (BOOL)signingCertPrivateKeyExtractable;

@property (nonatomic,readonly,assign,getter=signingCertPublicKeyBytes) NSData* signingCertPublicKeyBytes;

- (NSData*)signingCertPublicKeyBytes;

@property (nonatomic,readonly,assign,getter=signingCertQualified) BOOL signingCertQualified;

- (BOOL)signingCertQualified;

@property (nonatomic,readonly,assign,getter=signingCertQualifiedStatements) int signingCertQualifiedStatements;

- (int)signingCertQualifiedStatements;

@property (nonatomic,readonly,assign,getter=signingCertQualifiers) NSString* signingCertQualifiers;

- (NSString*)signingCertQualifiers;

@property (nonatomic,readonly,assign,getter=signingCertSelfSigned) BOOL signingCertSelfSigned;

- (BOOL)signingCertSelfSigned;

@property (nonatomic,readonly,assign,getter=signingCertSerialNumber) NSData* signingCertSerialNumber;

- (NSData*)signingCertSerialNumber;

@property (nonatomic,readonly,assign,getter=signingCertSigAlgorithm) NSString* signingCertSigAlgorithm;

- (NSString*)signingCertSigAlgorithm;

@property (nonatomic,readonly,assign,getter=signingCertSource) int signingCertSource;

- (int)signingCertSource;

@property (nonatomic,readonly,assign,getter=signingCertSubject) NSString* signingCertSubject;

- (NSString*)signingCertSubject;

@property (nonatomic,readonly,assign,getter=signingCertSubjectAlternativeName) NSString* signingCertSubjectAlternativeName;

- (NSString*)signingCertSubjectAlternativeName;

@property (nonatomic,readonly,assign,getter=signingCertSubjectKeyID) NSData* signingCertSubjectKeyID;

- (NSData*)signingCertSubjectKeyID;

@property (nonatomic,readonly,assign,getter=signingCertSubjectRDN) NSString* signingCertSubjectRDN;

- (NSString*)signingCertSubjectRDN;

@property (nonatomic,readonly,assign,getter=signingCertValid) BOOL signingCertValid;

- (BOOL)signingCertValid;

@property (nonatomic,readonly,assign,getter=signingCertValidFrom) NSString* signingCertValidFrom;

- (NSString*)signingCertValidFrom;

@property (nonatomic,readonly,assign,getter=signingCertValidTo) NSString* signingCertValidTo;

- (NSString*)signingCertValidTo;

 

Default Value

""

Remarks

Use this property to access the certificate that was used to create the signature. This property might not be available if the signer chose not to include the certificate into the signature.

This property is read-only.

Timestamp Property (MessageVerifier Module)

Contains the timestamp which is being validated.

Syntax

• Swift
• Objective-C

public var timestamp: TimestampInfo {
  get {...}
}

@property (nonatomic,readonly,assign,getter=timestampAccuracy) long long timestampAccuracy;

- (long long)timestampAccuracy;

@property (nonatomic,readonly,assign,getter=timestampBytes) NSData* timestampBytes;

- (NSData*)timestampBytes;

@property (nonatomic,readonly,assign,getter=timestampCertificateIndex) int timestampCertificateIndex;

- (int)timestampCertificateIndex;

@property (nonatomic,readonly,assign,getter=timestampChainValidationDetails) int timestampChainValidationDetails;

- (int)timestampChainValidationDetails;

@property (nonatomic,readonly,assign,getter=timestampChainValidationResult) int timestampChainValidationResult;

- (int)timestampChainValidationResult;

@property (nonatomic,readonly,assign,getter=timestampContainsLongTermInfo) BOOL timestampContainsLongTermInfo;

- (BOOL)timestampContainsLongTermInfo;

@property (nonatomic,readonly,assign,getter=timestampEntityLabel) NSString* timestampEntityLabel;

- (NSString*)timestampEntityLabel;

@property (nonatomic,readonly,assign,getter=timestampHashAlgorithm) NSString* timestampHashAlgorithm;

- (NSString*)timestampHashAlgorithm;

@property (nonatomic,readonly,assign,getter=timestampParentEntity) NSString* timestampParentEntity;

- (NSString*)timestampParentEntity;

@property (nonatomic,readonly,assign,getter=timestampSerialNumber) NSData* timestampSerialNumber;

- (NSData*)timestampSerialNumber;

@property (nonatomic,readonly,assign,getter=timestampTime) NSString* timestampTime;

- (NSString*)timestampTime;

@property (nonatomic,readonly,assign,getter=timestampTimestampType) int timestampTimestampType;

- (int)timestampTimestampType;

@property (nonatomic,readonly,assign,getter=timestampTSAName) NSString* timestampTSAName;

- (NSString*)timestampTSAName;

@property (nonatomic,readonly,assign,getter=timestampValidationLog) NSString* timestampValidationLog;

- (NSString*)timestampValidationLog;

@property (nonatomic,readonly,assign,getter=timestampValidationResult) int timestampValidationResult;

- (int)timestampValidationResult;

 

Default Value

""

Remarks

Use this property to access the timestamp which is currently being validated.

This property is read-only.

Timestamped Property (MessageVerifier Module)

Indicates whether or not the signature is timestamped.

Syntax

• Swift
• Objective-C

public var timestamped: Bool {
  get {...}
}

@property (nonatomic,readonly,assign,getter=timestamped) BOOL timestamped;

- (BOOL)timestamped;

Default Value

False

Remarks

This property returns True if the signature is timestamped, and False otherwise.

This property is read-only.

TSACertificate Property (MessageVerifier Module)

The certificate of the Time Stamping Authority.

Syntax

• Swift
• Objective-C

public var tsaCertificate: Certificate {
  get {...}
}

@property (nonatomic,readonly,assign,getter=TSACertBytes) NSData* TSACertBytes;

- (NSData*)TSACertBytes;

@property (nonatomic,readonly,assign,getter=TSACertCA) BOOL TSACertCA;

- (BOOL)TSACertCA;

@property (nonatomic,readonly,assign,getter=TSACertCAKeyID) NSData* TSACertCAKeyID;

- (NSData*)TSACertCAKeyID;

@property (nonatomic,readonly,assign,getter=TSACertCRLDistributionPoints) NSString* TSACertCRLDistributionPoints;

- (NSString*)TSACertCRLDistributionPoints;

@property (nonatomic,readonly,assign,getter=TSACertCurve) NSString* TSACertCurve;

- (NSString*)TSACertCurve;

@property (nonatomic,readonly,assign,getter=TSACertFingerprint) NSString* TSACertFingerprint;

- (NSString*)TSACertFingerprint;

@property (nonatomic,readonly,assign,getter=TSACertFriendlyName) NSString* TSACertFriendlyName;

- (NSString*)TSACertFriendlyName;

@property (nonatomic,readonly,assign,getter=TSACertHandle) long long TSACertHandle;

- (long long)TSACertHandle;

@property (nonatomic,readonly,assign,getter=TSACertHashAlgorithm) NSString* TSACertHashAlgorithm;

- (NSString*)TSACertHashAlgorithm;

@property (nonatomic,readonly,assign,getter=TSACertIssuer) NSString* TSACertIssuer;

- (NSString*)TSACertIssuer;

@property (nonatomic,readonly,assign,getter=TSACertIssuerRDN) NSString* TSACertIssuerRDN;

- (NSString*)TSACertIssuerRDN;

@property (nonatomic,readonly,assign,getter=TSACertKeyAlgorithm) NSString* TSACertKeyAlgorithm;

- (NSString*)TSACertKeyAlgorithm;

@property (nonatomic,readonly,assign,getter=TSACertKeyBits) int TSACertKeyBits;

- (int)TSACertKeyBits;

@property (nonatomic,readonly,assign,getter=TSACertKeyFingerprint) NSString* TSACertKeyFingerprint;

- (NSString*)TSACertKeyFingerprint;

@property (nonatomic,readonly,assign,getter=TSACertKeyUsage) int TSACertKeyUsage;

- (int)TSACertKeyUsage;

@property (nonatomic,readonly,assign,getter=TSACertKeyValid) BOOL TSACertKeyValid;

- (BOOL)TSACertKeyValid;

@property (nonatomic,readonly,assign,getter=TSACertOCSPLocations) NSString* TSACertOCSPLocations;

- (NSString*)TSACertOCSPLocations;

@property (nonatomic,readonly,assign,getter=TSACertPolicyIDs) NSString* TSACertPolicyIDs;

- (NSString*)TSACertPolicyIDs;

@property (nonatomic,readonly,assign,getter=TSACertPublicKeyBytes) NSData* TSACertPublicKeyBytes;

- (NSData*)TSACertPublicKeyBytes;

@property (nonatomic,readonly,assign,getter=TSACertSelfSigned) BOOL TSACertSelfSigned;

- (BOOL)TSACertSelfSigned;

@property (nonatomic,readonly,assign,getter=TSACertSerialNumber) NSData* TSACertSerialNumber;

- (NSData*)TSACertSerialNumber;

@property (nonatomic,readonly,assign,getter=TSACertSigAlgorithm) NSString* TSACertSigAlgorithm;

- (NSString*)TSACertSigAlgorithm;

@property (nonatomic,readonly,assign,getter=TSACertSubject) NSString* TSACertSubject;

- (NSString*)TSACertSubject;

@property (nonatomic,readonly,assign,getter=TSACertSubjectKeyID) NSData* TSACertSubjectKeyID;

- (NSData*)TSACertSubjectKeyID;

@property (nonatomic,readonly,assign,getter=TSACertSubjectRDN) NSString* TSACertSubjectRDN;

- (NSString*)TSACertSubjectRDN;

@property (nonatomic,readonly,assign,getter=TSACertValidFrom) NSString* TSACertValidFrom;

- (NSString*)TSACertValidFrom;

@property (nonatomic,readonly,assign,getter=TSACertValidTo) NSString* TSACertValidTo;

- (NSString*)TSACertValidTo;

 

Default Value

""

Remarks

Use this property to access the certificate of the TSA that produced the timestamp.

Note that in some instances the TSA certificate might be unavailable, even for timestamped documents and signatures.

This property is read-only.

UnsignedAttributes Property (MessageVerifier Module)

Custom unsigned attributes included in the electronic signature.

Syntax

• Swift
• Objective-C

public var unsignedAttributes: Array<SignatureAttribute> {
  get {...}
}

@property (nonatomic,readonly,assign,getter=unsignedAttributeCount) int unsignedAttributeCount;

- (int)unsignedAttributeCount;

- (NSString*)unsignedAttributeOID:(int)unsignedAttributeIndex;

- (NSData*)unsignedAttributeValue:(int)unsignedAttributeIndex;

Default Value

""

Remarks

Signature attributes are used to store auxiliary information in the signature. Values included as unsigned attributes are not covered by the signature and can be changed or removed without affecting the signature.

This property is read-only.

ValidatedSigningTime Property (MessageVerifier Module)

Contains the certified signing time.

Syntax

• Swift
• Objective-C

public var validatedSigningTime: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=validatedSigningTime) NSString* validatedSigningTime;

- (NSString*)validatedSigningTime;

Default Value

""

Remarks

Use this property to obtain the signing time as certified by an external timestamp. The time is in UTC.

This property is read-only.

CheckSignatureType Method (MessageVerifier Module)

Determines the signature kind.

Syntax

• Swift
• Objective-C

public func checkSignatureType() throws -> Int32

- (int)checkSignatureType;

Remarks

Use this method to determine the kind of the signature stored in InputFile (InputStream).

Config Method (MessageVerifier Module)

Sets or retrieves a configuration setting.

Syntax

• Swift
• Objective-C

public func config(configurationString: String) throws -> String

- (NSString*)config:(NSString*)configurationString;

Remarks

Config is a generic method available in every class. It is used to set and retrieve configuration settings for the class.

These settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the class, access to these internal properties is provided through the Config method.

To set a configuration setting named PROPERTY, you must call Config("PROPERTY=VALUE"), where VALUE is the value of the setting expressed as a string. For boolean values, use the strings "True", "False", "0", "1", "Yes", or "No" (case does not matter).

To read (query) the value of a configuration setting, you must call Config("PROPERTY"). The value will be returned as a string.

DoAction Method (MessageVerifier Module)

Performs an additional action.

Syntax

• Swift
• Objective-C

public func doAction(actionID: String, actionParams: String) throws -> String

- (NSString*)doAction:(NSString*)actionID :(NSString*)actionParams;

Remarks

DoAction is a generic method available in every class. It is used to perform an additional action introduced after the product major release. The list of actions is not fixed, and may be flexibly extended over time.

The unique identifier (case insensitive) of the action is provided in the ActionID parameter.

ActionParams contains the value of a single parameter, or a list of multiple parameters for the action in the form of PARAM1=VALUE1;PARAM2=VALUE2;....

Common ActionIDs:

Reset Method (MessageVerifier Module)

Resets the component settings.

Syntax

• Swift
• Objective-C

public func reset() throws -> Void

- (void)reset;

Remarks

Reset is a generic method available in every class.

Verify Method (MessageVerifier Module)

Verifies digitally signed data.

Syntax

• Swift
• Objective-C

public func verify() throws -> Void

- (void)verify;

Remarks

PKCS#7 and its successor, CMS, support two types of signatures: (1) enveloping signatures, where the signed data and its signature are combined in the same message, and (2) detached signatures, where the signature is stored as a separate entity. This method verifies enveloped signatures and extracts data contained in them. Use VerifyDetached to verify detached signatures.

This method expects the enveloping signature to be provided via InputFile or InputStream properties.

Note that this method only checks the integrity of the signature, i.e., that it is signed with the claimed certificate and has not been altered. It does not validate the signing certificate chain. To validate the certificate chain, either use CertificateValidator component together with MessageVerifier, or consider using CAdESVerifier component instead.

VerifyDetached Method (MessageVerifier Module)

Verifies a detached signature.

Syntax

• Swift
• Objective-C

public func verifyDetached() throws -> Void

- (void)verifyDetached;

Remarks

Use this method to verify detached signatures. Pass the signature via InputFile (or InputStream) property, and the original data via DataFile (DataStream).

Error Event (MessageVerifier Module)

Information about errors during PKCS#7 message verification.

Syntax

• Swift
• Objective-C

func onError(errorCode: Int32, description: String)

- (void)onError:(int)errorCode :(NSString*)description;

Remarks

The event is fired in case of exceptional conditions during message processing.

ErrorCode contains an error code and Description contains a textual description of the error. For a list of valid error codes and their descriptions, please refer to the Messages section.

Notification Event (MessageVerifier Module)

This event notifies the application about an underlying control flow event.

Syntax

• Swift
• Objective-C

func onNotification(eventID: String, eventParam: String)

- (void)onNotification:(NSString*)eventID :(NSString*)eventParam;

Remarks

The class fires this event to let the application know about some event, occurrence, or milestone in the class. For example, it may fire to report completion of the document processing. The list of events being reported is not fixed, and may be flexibly extended over time.

The unique identifier of the event is provided in the EventID parameter. EventParam contains any parameters accompanying the occurrence. Depending on the type of the class, the exact action it is performing, or the document being processed, one or both may be omitted.

RecipientFound Event (MessageVerifier Module)

Fires to report a message addressee parameters.

Syntax

• Swift
• Objective-C

func onRecipientFound(issuerRDN: String, serialNumber: Data, subjectKeyID: Data, certFound: Bool)

- (void)onRecipientFound:(NSString*)issuerRDN :(NSData*)serialNumber :(NSData*)subjectKeyID :(BOOL)certFound;

Remarks

This event is fired for each addressee the message is encrypted for. It may fire several times in a row if the message is encrypted for more than one recipient.

The IssuerRDN, SerialNumber, and SubjectKeyID parameters to identify the recipient's certificate. CertFound indicates if the specified certificate has been located in Certificates collection. If it wasn't, you might want to look up the certificate manually, and add it to the collection inside the event handler.

SignatureFound Event (MessageVerifier Module)

Signifies the start of signature validation.

Syntax

• Swift
• Objective-C

func onSignatureFound(issuerRDN: String, serialNumber: Data, subjectKeyID: Data, certFound: Bool, validateSignature: inout Bool, validateChain: inout Bool)

- (void)onSignatureFound:(NSString*)issuerRDN :(NSData*)serialNumber :(NSData*)subjectKeyID :(BOOL)certFound :(int*)validateSignature :(int*)validateChain;

Remarks

This event tells the application that signature validation is about to start, and provides the details about the signer's certificate via its IssuerRDN, SerialNumber, and SubjectKeyID parameters. It fires for every signature located in the verified document or message.

The CertFound parameter is set to True if the class has found the needed certificate in one of the known locations, and to False otherwise, in which case you must provide it manually via the KnownCertificates property.

Signature validation consists of two independent stages: cryptographic signature validation and chain validation. Separate validation results are reported for each, with the and properties respectively.

Use the ValidateSignature and ValidateChain parameters to tell the verifier which stages to include in the validation.

SignatureValidated Event (MessageVerifier Module)

Marks the completion of the signature validation routine.

Syntax

• Swift
• Objective-C

func onSignatureValidated(issuerRDN: String, serialNumber: Data, subjectKeyID: Data, validationResult: Int32)

- (void)onSignatureValidated:(NSString*)issuerRDN :(NSData*)serialNumber :(NSData*)subjectKeyID :(int)validationResult;

Remarks

This event is fired upon the completion of the signature validation routine, and reports the respective validation result.

Use the IssuerRDN, SerialNumber, and/or SubjectKeyID parameters to identify the signing certificate.

ValidationResult is set to 0 if the validation has been successful, or to a non-zero value in case of a validation failure.

TimestampFound Event (MessageVerifier Module)

Signifies the start of a timestamp validation routine.

Syntax

• Swift
• Objective-C

func onTimestampFound(issuerRDN: String, serialNumber: Data, subjectKeyID: Data, certFound: Bool, validateTimestamp: inout Bool, validateChain: inout Bool)

- (void)onTimestampFound:(NSString*)issuerRDN :(NSData*)serialNumber :(NSData*)subjectKeyID :(BOOL)certFound :(int*)validateTimestamp :(int*)validateChain;

Remarks

This event fires for every timestamp identified during signature processing, and reports the details about the signer's certificate via its IssuerRDN, SerialNumber, and SubjectKeyID parameters.

The CertFound parameter is set to True if the class has found the needed certificate in one of the known locations, and to False otherwise, in which case you must provide it manually via the KnownCertificates property.

Just like with signature validation, timestamp validation consists of two independent stages: cryptographic signature validation and chain validation. Separate validation results are reported for each, with the and properties respectively.

Use the ValidateSignature and ValidateChain parameters to tell the verifier which stages to include in the validation.

TimestampValidated Event (MessageVerifier Module)

Reports the completion of the timestamp validation routine.

Syntax

• Swift
• Objective-C

func onTimestampValidated(issuerRDN: String, serialNumber: Data, subjectKeyID: Data, time: String, validationResult: Int32, chainValidationResult: Int32, chainValidationDetails: Int32)

- (void)onTimestampValidated:(NSString*)issuerRDN :(NSData*)serialNumber :(NSData*)subjectKeyID :(NSString*)time :(int)validationResult :(int)chainValidationResult :(int)chainValidationDetails;

Remarks

This event is fired upon the completion of the timestamp validation routine, and reports the respective validation result.

ValidationResult is set to 0 if the validation has been successful, or to a non-zero value in case of a failure.

Certificate Type

Encapsulates an individual X.509 certificate.

Remarks

This type keeps and provides access to X.509 certificate details.

Fields

Constructors

public init(stream: )

public init()

SignatureAttribute Type

Represents an attribute of a digital PKCS#7/CMS signature.

Remarks

Attributes store auxiliary information about the signed message, the signature, or the owner. Each attribute is a = pair.

Common attributes are signing time, a content type, a policy identifier, and a signature timestamp.

Fields

Constructors

public init()

TimestampInfo Type

A container for timestamp information.

Remarks

The TimestampInfo object contains details of a third-party timestamp and the outcome of its validation.

Fields

Constructors

public init()

Config Settings (MessageVerifier Module)

MessageVerifier Config Settings

Base Config Settings

Trappable Errors (MessageVerifier Module)

MessageVerifier Errors