SOAPSigner Module

Properties   Methods   Events   Config Settings   Errors  

The SOAPSigner module signs SOAP messages.

Syntax

SecureBlackbox.Soapsigner

Remarks

SOAPSigner creates electronic signatures for SOAP messages, and includes advanced security features such as support for timestamps and advanced electronic signatures (XAdES).

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.

AutoValidateSignatures Property (SOAPSigner Module)

Specifies whether module should validate any present signatures when the document is opened.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=autoValidateSignatures,setter=setAutoValidateSignatures:) BOOL autoValidateSignatures;

- (BOOL)autoValidateSignatures;
- (void)setAutoValidateSignatures :(BOOL)newAutoValidateSignatures;

Default Value

False

Remarks

This setting is switched off by default to speed up document processing. Even if the document is loaded with this property set to false, you can validate the signatures manually on a later stage using the Revalidate method.

BlockedCertificates Property (SOAPSigner Module)

The certificates that must be rejected as trust anchors.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=blockedCertCount,setter=setBlockedCertCount:) int blockedCertCount;

- (int)blockedCertCount;
- (void)setBlockedCertCount :(int)newBlockedCertCount;

- (NSData*)blockedCertBytes:(int)blockedCertIndex;

- (long long)blockedCertHandle:(int)blockedCertIndex;
- (void)setBlockedCertHandle:(int)blockedCertIndex :(long long)newBlockedCertHandle;

Default Value

""

Remarks

Use this property to provide a list of compromised or blocked certificates. Any chain containing a blocked certificate will fail validation.

Certificates Property (SOAPSigner 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;

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

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

- (NSData*)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;

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

- (int)certKeyUsage:(int)certIndex;

- (BOOL)certKeyValid:(int)certIndex;

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

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

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

- (BOOL)certSelfSigned:(int)certIndex;

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

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

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

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

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

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

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

Default Value

""

Remarks

Use this property to access all certificates included into the signature(s) by its creator.

CRLs Property (SOAPSigner Module)

A collection of certificate revocation lists embedded into the signature by the signer.

Syntax

• Swift
• Objective-C

public var crLs: Array<CRL> {
  get {...}
}

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

- (int)CRLCount;

- (NSData*)CRLBytes:(int)cRLIndex;

- (long long)CRLHandle:(int)cRLIndex;

- (NSString*)CRLIssuer:(int)cRLIndex;

- (NSString*)CRLIssuerRDN:(int)cRLIndex;

- (NSString*)CRLLocation:(int)cRLIndex;

- (NSString*)CRLNextUpdate:(int)cRLIndex;

- (NSString*)CRLThisUpdate:(int)cRLIndex;

Default Value

""

Remarks

Use this property to access the CRLs embedded into the signature by the signer.

EmbedCertificateMethod Property (SOAPSigner Module)

Controls the certificate disposition within the signature.

Syntax

• Swift
• Objective-C

public var embedCertificateMethod: SoapsignerEmbedCertificateMethods {
  get {...}
  set {...}
}

public enum SoapsignerEmbedCertificateMethods: Int32 {
  case cwecInSignature = 0
  case cwecInBinarySecurityToken = 1
  case cwecInSignedBinarySecurityToken = 2
  case cwecInBinarySecurityTokenAndSignature = 3
  case cwecNone = 4
}

@property (nonatomic,readwrite,assign,getter=embedCertificateMethod,setter=setEmbedCertificateMethod:) int embedCertificateMethod;

- (int)embedCertificateMethod;
- (void)setEmbedCertificateMethod :(int)newEmbedCertificateMethod;

Default Value

1

Remarks

This property controls the method of embedding the signing certificate(s) into the signature if WS-Security signature type is used.

Supported values:

Encoding Property (SOAPSigner Module)

Specifies XML encoding.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=encoding,setter=setEncoding:) NSString* encoding;

- (NSString*)encoding;
- (void)setEncoding :(NSString*)newEncoding;

Default Value

""

Remarks

Use this property to specify the encoding to apply to the XML documents.

ExternalCrypto Property (SOAPSigner Module)

Provides access to external signing and DC parameters.

Syntax

• Swift
• Objective-C

public var externalCrypto: ExternalCrypto {
  get {...}
}

@property (nonatomic,readwrite,assign,getter=externalCryptoAsyncDocumentID,setter=setExternalCryptoAsyncDocumentID:) NSString* externalCryptoAsyncDocumentID;

- (NSString*)externalCryptoAsyncDocumentID;
- (void)setExternalCryptoAsyncDocumentID :(NSString*)newExternalCryptoAsyncDocumentID;

@property (nonatomic,readwrite,assign,getter=externalCryptoCustomParams,setter=setExternalCryptoCustomParams:) NSString* externalCryptoCustomParams;

- (NSString*)externalCryptoCustomParams;
- (void)setExternalCryptoCustomParams :(NSString*)newExternalCryptoCustomParams;

@property (nonatomic,readwrite,assign,getter=externalCryptoData,setter=setExternalCryptoData:) NSString* externalCryptoData;

- (NSString*)externalCryptoData;
- (void)setExternalCryptoData :(NSString*)newExternalCryptoData;

@property (nonatomic,readwrite,assign,getter=externalCryptoExternalHashCalculation,setter=setExternalCryptoExternalHashCalculation:) BOOL externalCryptoExternalHashCalculation;

- (BOOL)externalCryptoExternalHashCalculation;
- (void)setExternalCryptoExternalHashCalculation :(BOOL)newExternalCryptoExternalHashCalculation;

@property (nonatomic,readwrite,assign,getter=externalCryptoHashAlgorithm,setter=setExternalCryptoHashAlgorithm:) NSString* externalCryptoHashAlgorithm;

- (NSString*)externalCryptoHashAlgorithm;
- (void)setExternalCryptoHashAlgorithm :(NSString*)newExternalCryptoHashAlgorithm;

@property (nonatomic,readwrite,assign,getter=externalCryptoKeyID,setter=setExternalCryptoKeyID:) NSString* externalCryptoKeyID;

- (NSString*)externalCryptoKeyID;
- (void)setExternalCryptoKeyID :(NSString*)newExternalCryptoKeyID;

@property (nonatomic,readwrite,assign,getter=externalCryptoKeySecret,setter=setExternalCryptoKeySecret:) NSString* externalCryptoKeySecret;

- (NSString*)externalCryptoKeySecret;
- (void)setExternalCryptoKeySecret :(NSString*)newExternalCryptoKeySecret;

@property (nonatomic,readwrite,assign,getter=externalCryptoMethod,setter=setExternalCryptoMethod:) int externalCryptoMethod;

- (int)externalCryptoMethod;
- (void)setExternalCryptoMethod :(int)newExternalCryptoMethod;

@property (nonatomic,readwrite,assign,getter=externalCryptoMode,setter=setExternalCryptoMode:) int externalCryptoMode;

- (int)externalCryptoMode;
- (void)setExternalCryptoMode :(int)newExternalCryptoMode;

@property (nonatomic,readwrite,assign,getter=externalCryptoPublicKeyAlgorithm,setter=setExternalCryptoPublicKeyAlgorithm:) NSString* externalCryptoPublicKeyAlgorithm;

- (NSString*)externalCryptoPublicKeyAlgorithm;
- (void)setExternalCryptoPublicKeyAlgorithm :(NSString*)newExternalCryptoPublicKeyAlgorithm;

 

Default Value

""

Remarks

Use this property to tune-up remote cryptography settings. SecureBlackbox supports two independent types of external cryptography: synchronous (based on OnExternalSign event) and asynchronous (based on DC protocol and DCAuth signing component).

FIPSMode Property (SOAPSigner 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.

IgnoreChainValidationErrors Property (SOAPSigner Module)

Makes the module tolerant to chain validation errors.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=ignoreChainValidationErrors,setter=setIgnoreChainValidationErrors:) BOOL ignoreChainValidationErrors;

- (BOOL)ignoreChainValidationErrors;
- (void)setIgnoreChainValidationErrors :(BOOL)newIgnoreChainValidationErrors;

Default Value

False

Remarks

If this property is set to True, any errors emerging during certificate chain validation will be ignored. This setting may be handy if the purpose of validation is the creation of an LTV signature, and the validation is performed in an environment that doesn't trust the signer's certificate chain.

InputBytes Property (SOAPSigner Module)

Use this property to pass the input to module in the 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 (SOAPSigner Module)

Specifies the SOAP message to be signed.

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

Provide a full path to the SOAP message to be signed.

KnownCertificates Property (SOAPSigner 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 component manually.

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

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

KnownCRLs Property (SOAPSigner Module)

Additional CRLs for chain validation.

Syntax

• Swift
• Objective-C

public var knownCRLs: Array<CRL> {
  get {...}
}

@property (nonatomic,readwrite,assign,getter=knownCRLCount,setter=setKnownCRLCount:) int knownCRLCount;

- (int)knownCRLCount;
- (void)setKnownCRLCount :(int)newKnownCRLCount;

- (NSData*)knownCRLBytes:(int)knownCRLIndex;

- (long long)knownCRLHandle:(int)knownCRLIndex;
- (void)setKnownCRLHandle:(int)knownCRLIndex :(long long)newKnownCRLHandle;

Default Value

""

Remarks

Use this property to supply additional CRLs that might be needed for chain validation. This property may be helpful when a chain is validated in offline mode, and the associated CRLs are stored separately from the signed message or document.

KnownOCSPs Property (SOAPSigner Module)

Additional OCSP responses for chain validation.

Syntax

• Swift
• Objective-C

public var knownOCSPs: Array<OCSPResponse> {
  get {...}
}

@property (nonatomic,readwrite,assign,getter=knownOCSPCount,setter=setKnownOCSPCount:) int knownOCSPCount;

- (int)knownOCSPCount;
- (void)setKnownOCSPCount :(int)newKnownOCSPCount;

- (NSData*)knownOCSPBytes:(int)knownOCSPIndex;

- (long long)knownOCSPHandle:(int)knownOCSPIndex;
- (void)setKnownOCSPHandle:(int)knownOCSPIndex :(long long)newKnownOCSPHandle;

Default Value

""

Remarks

Use this property to supply additional OCSP responses that might be needed for chain validation. This property may be helpful when a chain is validated in offline mode, and the associated OCSP responses are stored separately from the signed message or document.

NewSignature Property (SOAPSigner Module)

Provides access to new signature properties.

Syntax

• Swift
• Objective-C

public var newSignature: SOAPSignature {
  get {...}
}

@property (nonatomic,readwrite,assign,getter=newSigCanonicalizationMethod,setter=setNewSigCanonicalizationMethod:) int newSigCanonicalizationMethod;

- (int)newSigCanonicalizationMethod;
- (void)setNewSigCanonicalizationMethod :(int)newNewSigCanonicalizationMethod;

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

- (int)newSigCertificateIndex;

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

- (int)newSigChainValidationDetails;

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

- (int)newSigChainValidationResult;

@property (nonatomic,readwrite,assign,getter=newSigClaimedSigningTime,setter=setNewSigClaimedSigningTime:) NSString* newSigClaimedSigningTime;

- (NSString*)newSigClaimedSigningTime;
- (void)setNewSigClaimedSigningTime :(NSString*)newNewSigClaimedSigningTime;

@property (nonatomic,readwrite,assign,getter=newSigHandle,setter=setNewSigHandle:) long long newSigHandle;

- (long long)newSigHandle;
- (void)setNewSigHandle :(long long)newNewSigHandle;

@property (nonatomic,readwrite,assign,getter=newSigHashAlgorithm,setter=setNewSigHashAlgorithm:) NSString* newSigHashAlgorithm;

- (NSString*)newSigHashAlgorithm;
- (void)setNewSigHashAlgorithm :(NSString*)newNewSigHashAlgorithm;

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

- (NSString*)newSigIssuerRDN;

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

- (NSString*)newSigLastArchivalTime;

@property (nonatomic,readwrite,assign,getter=newSigPolicyHash,setter=setNewSigPolicyHash:) NSString* newSigPolicyHash;

- (NSString*)newSigPolicyHash;
- (void)setNewSigPolicyHash :(NSString*)newNewSigPolicyHash;

@property (nonatomic,readwrite,assign,getter=newSigPolicyHashAlgorithm,setter=setNewSigPolicyHashAlgorithm:) NSString* newSigPolicyHashAlgorithm;

- (NSString*)newSigPolicyHashAlgorithm;
- (void)setNewSigPolicyHashAlgorithm :(NSString*)newNewSigPolicyHashAlgorithm;

@property (nonatomic,readwrite,assign,getter=newSigPolicyID,setter=setNewSigPolicyID:) NSString* newSigPolicyID;

- (NSString*)newSigPolicyID;
- (void)setNewSigPolicyID :(NSString*)newNewSigPolicyID;

@property (nonatomic,readwrite,assign,getter=newSigPolicyURI,setter=setNewSigPolicyURI:) NSString* newSigPolicyURI;

- (NSString*)newSigPolicyURI;
- (void)setNewSigPolicyURI :(NSString*)newNewSigPolicyURI;

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

- (NSData*)newSigSerialNumber;

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

- (NSData*)newSigSignatureBytes;

@property (nonatomic,readwrite,assign,getter=newSigSignatureType,setter=setNewSigSignatureType:) int newSigSignatureType;

- (int)newSigSignatureType;
- (void)setNewSigSignatureType :(int)newNewSigSignatureType;

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

- (int)newSigSignatureValidationResult;

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

- (NSData*)newSigSubjectKeyID;

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

- (NSString*)newSigSubjectRDN;

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

- (BOOL)newSigTimestamped;

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

- (NSString*)newSigValidatedSigningTime;

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

- (NSString*)newSigValidationLog;

@property (nonatomic,readwrite,assign,getter=newSigXAdES,setter=setNewSigXAdES:) BOOL newSigXAdES;

- (BOOL)newSigXAdES;
- (void)setNewSigXAdES :(BOOL)newNewSigXAdES;

@property (nonatomic,readwrite,assign,getter=newSigXAdESForm,setter=setNewSigXAdESForm:) int newSigXAdESForm;

- (int)newSigXAdESForm;
- (void)setNewSigXAdESForm :(int)newNewSigXAdESForm;

@property (nonatomic,readwrite,assign,getter=newSigXAdESVersion,setter=setNewSigXAdESVersion:) int newSigXAdESVersion;

- (int)newSigXAdESVersion;
- (void)setNewSigXAdESVersion :(int)newNewSigXAdESVersion;

@property (nonatomic,readwrite,assign,getter=newSigXMLElement,setter=setNewSigXMLElement:) NSString* newSigXMLElement;

- (NSString*)newSigXMLElement;
- (void)setNewSigXMLElement :(NSString*)newNewSigXMLElement;

 

Default Value

""

Remarks

Use this property to tune-up signature properties.

OCSPs Property (SOAPSigner Module)

A collection of OCSP responses embedded into the signature.

Syntax

• Swift
• Objective-C

public var ocsPs: Array<OCSPResponse> {
  get {...}
}

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

- (int)OCSPCount;

- (NSData*)OCSPBytes:(int)oCSPIndex;

- (long long)OCSPHandle:(int)oCSPIndex;

- (NSString*)OCSPIssuer:(int)oCSPIndex;

- (NSString*)OCSPIssuerRDN:(int)oCSPIndex;

- (NSString*)OCSPLocation:(int)oCSPIndex;

- (NSString*)OCSPProducedAt:(int)oCSPIndex;

Default Value

""

Remarks

Use this property to access the OCSP responses embedded into the signature by its creator.

OfflineMode Property (SOAPSigner Module)

Switches the module to the offline mode.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=offlineMode,setter=setOfflineMode:) BOOL offlineMode;

- (BOOL)offlineMode;
- (void)setOfflineMode :(BOOL)newOfflineMode;

Default Value

False

Remarks

When working in offline mode, the component restricts itself from using any online revocation information sources, such as CRL or OCSP responders.

Offline mode may be useful if there is a need to verify the completeness of validation information included within the signature or provided via KnownCertificates, KnownCRLs, and other related properties.

OutputBytes Property (SOAPSigner 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 is completed to read the produced output. This property will only be set if OutputFile and OutputStream properties had not been assigned.

This property is read-only.

OutputFile Property (SOAPSigner Module)

A file where the signed SOAP message will be saved.

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

Provide a full path to the file where the signed SOAP message should be saved.

Profile Property (SOAPSigner Module)

Specifies a pre-defined profile to apply when creating the signature.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=profile,setter=setProfile:) NSString* profile;

- (NSString*)profile;
- (void)setProfile :(NSString*)newProfile;

Default Value

""

Remarks

Advanced signatures come in many variants, which are often defined by parties that needs to process them or by local standards. SecureBlackbox profiles are sets of pre-defined configurations which correspond to particular signature variants. By specifying a profile, you are pre-configuring the component to make it produce the signature that matches the configuration corresponding to that profile.

Proxy Property (SOAPSigner Module)

The proxy server settings.

Syntax

• Swift
• Objective-C

public var proxy: ProxySettings {
  get {...}
}

@property (nonatomic,readwrite,assign,getter=proxyAddress,setter=setProxyAddress:) NSString* proxyAddress;

- (NSString*)proxyAddress;
- (void)setProxyAddress :(NSString*)newProxyAddress;

@property (nonatomic,readwrite,assign,getter=proxyAuthentication,setter=setProxyAuthentication:) int proxyAuthentication;

- (int)proxyAuthentication;
- (void)setProxyAuthentication :(int)newProxyAuthentication;

@property (nonatomic,readwrite,assign,getter=proxyPassword,setter=setProxyPassword:) NSString* proxyPassword;

- (NSString*)proxyPassword;
- (void)setProxyPassword :(NSString*)newProxyPassword;

@property (nonatomic,readwrite,assign,getter=proxyPort,setter=setProxyPort:) int proxyPort;

- (int)proxyPort;
- (void)setProxyPort :(int)newProxyPort;

@property (nonatomic,readwrite,assign,getter=proxyProxyType,setter=setProxyProxyType:) int proxyProxyType;

- (int)proxyProxyType;
- (void)setProxyProxyType :(int)newProxyProxyType;

@property (nonatomic,readwrite,assign,getter=proxyRequestHeaders,setter=setProxyRequestHeaders:) NSString* proxyRequestHeaders;

- (NSString*)proxyRequestHeaders;
- (void)setProxyRequestHeaders :(NSString*)newProxyRequestHeaders;

@property (nonatomic,readwrite,assign,getter=proxyResponseBody,setter=setProxyResponseBody:) NSString* proxyResponseBody;

- (NSString*)proxyResponseBody;
- (void)setProxyResponseBody :(NSString*)newProxyResponseBody;

@property (nonatomic,readwrite,assign,getter=proxyResponseHeaders,setter=setProxyResponseHeaders:) NSString* proxyResponseHeaders;

- (NSString*)proxyResponseHeaders;
- (void)setProxyResponseHeaders :(NSString*)newProxyResponseHeaders;

@property (nonatomic,readwrite,assign,getter=proxyUseIPv6,setter=setProxyUseIPv6:) BOOL proxyUseIPv6;

- (BOOL)proxyUseIPv6;
- (void)setProxyUseIPv6 :(BOOL)newProxyUseIPv6;

@property (nonatomic,readwrite,assign,getter=proxyUseProxy,setter=setProxyUseProxy:) BOOL proxyUseProxy;

- (BOOL)proxyUseProxy;
- (void)setProxyUseProxy :(BOOL)newProxyUseProxy;

@property (nonatomic,readwrite,assign,getter=proxyUsername,setter=setProxyUsername:) NSString* proxyUsername;

- (NSString*)proxyUsername;
- (void)setProxyUsername :(NSString*)newProxyUsername;

 

Default Value

""

Remarks

Use this property to tune up the proxy server settings.

References Property (SOAPSigner Module)

A list of references to the data to be signed.

Syntax

• Swift
• Objective-C

public var references: Array<XMLReference> {
  get {...}
}

@property (nonatomic,readwrite,assign,getter=referenceCount,setter=setReferenceCount:) int referenceCount;

- (int)referenceCount;
- (void)setReferenceCount :(int)newReferenceCount;

- (BOOL)referenceAutoGenerateElementId:(int)referenceIndex;
- (void)setReferenceAutoGenerateElementId:(int)referenceIndex :(BOOL)newReferenceAutoGenerateElementId;

- (int)referenceCanonicalizationMethod:(int)referenceIndex;
- (void)setReferenceCanonicalizationMethod:(int)referenceIndex :(int)newReferenceCanonicalizationMethod;

- (NSString*)referenceCustomElementId:(int)referenceIndex;
- (void)setReferenceCustomElementId:(int)referenceIndex :(NSString*)newReferenceCustomElementId;

- (NSData*)referenceDigestValue:(int)referenceIndex;
- (void)setReferenceDigestValue:(int)referenceIndex :(NSData*)newReferenceDigestValue;

- (long long)referenceHandle:(int)referenceIndex;
- (void)setReferenceHandle:(int)referenceIndex :(long long)newReferenceHandle;

- (NSString*)referenceHashAlgorithm:(int)referenceIndex;
- (void)setReferenceHashAlgorithm:(int)referenceIndex :(NSString*)newReferenceHashAlgorithm;

- (BOOL)referenceHasURI:(int)referenceIndex;
- (void)setReferenceHasURI:(int)referenceIndex :(BOOL)newReferenceHasURI;

- (NSString*)referenceID:(int)referenceIndex;
- (void)setReferenceID:(int)referenceIndex :(NSString*)newReferenceID;

- (NSString*)referenceInclusiveNamespacesPrefixList:(int)referenceIndex;
- (void)setReferenceInclusiveNamespacesPrefixList:(int)referenceIndex :(NSString*)newReferenceInclusiveNamespacesPrefixList;

- (NSString*)referenceReferenceType:(int)referenceIndex;
- (void)setReferenceReferenceType:(int)referenceIndex :(NSString*)newReferenceReferenceType;

- (int)referenceSignatureIndex:(int)referenceIndex;

- (NSData*)referenceTargetData:(int)referenceIndex;
- (void)setReferenceTargetData:(int)referenceIndex :(NSData*)newReferenceTargetData;

- (int)referenceTargetType:(int)referenceIndex;
- (void)setReferenceTargetType:(int)referenceIndex :(int)newReferenceTargetType;

- (NSString*)referenceTargetXMLElement:(int)referenceIndex;
- (void)setReferenceTargetXMLElement:(int)referenceIndex :(NSString*)newReferenceTargetXMLElement;

- (NSString*)referenceURI:(int)referenceIndex;
- (void)setReferenceURI:(int)referenceIndex :(NSString*)newReferenceURI;

- (BOOL)referenceUseBase64Transform:(int)referenceIndex;
- (void)setReferenceUseBase64Transform:(int)referenceIndex :(BOOL)newReferenceUseBase64Transform;

- (BOOL)referenceUseEnvelopedSignatureTransform:(int)referenceIndex;
- (void)setReferenceUseEnvelopedSignatureTransform:(int)referenceIndex :(BOOL)newReferenceUseEnvelopedSignatureTransform;

- (BOOL)referenceUseXPathFilter2Transform:(int)referenceIndex;
- (void)setReferenceUseXPathFilter2Transform:(int)referenceIndex :(BOOL)newReferenceUseXPathFilter2Transform;

- (BOOL)referenceUseXPathTransform:(int)referenceIndex;
- (void)setReferenceUseXPathTransform:(int)referenceIndex :(BOOL)newReferenceUseXPathTransform;

- (NSString*)referenceXPathExpression:(int)referenceIndex;
- (void)setReferenceXPathExpression:(int)referenceIndex :(NSString*)newReferenceXPathExpression;

- (NSString*)referenceXPathFilter2Expressions:(int)referenceIndex;
- (void)setReferenceXPathFilter2Expressions:(int)referenceIndex :(NSString*)newReferenceXPathFilter2Expressions;

- (NSString*)referenceXPathFilter2Filters:(int)referenceIndex;
- (void)setReferenceXPathFilter2Filters:(int)referenceIndex :(NSString*)newReferenceXPathFilter2Filters;

- (NSString*)referenceXPathFilter2PrefixList:(int)referenceIndex;
- (void)setReferenceXPathFilter2PrefixList:(int)referenceIndex :(NSString*)newReferenceXPathFilter2PrefixList;

- (NSString*)referenceXPathPrefixList:(int)referenceIndex;
- (void)setReferenceXPathPrefixList:(int)referenceIndex :(NSString*)newReferenceXPathPrefixList;

Default Value

""

Remarks

Electronic signature is computed over a set of data pieces. Each piece of data to be signed is specified by a reference.

RevocationCheck Property (SOAPSigner Module)

Specifies the kind(s) of revocation check to perform.

Syntax

• Swift
• Objective-C

public var revocationCheck: SoapsignerRevocationChecks {
  get {...}
  set {...}
}

public enum SoapsignerRevocationChecks: Int32 {
  case crcNone = 0
  case crcAuto = 1
  case crcAllCRL = 2
  case crcAllOCSP = 3
  case crcAllCRLAndOCSP = 4
  case crcAnyCRL = 5
  case crcAnyOCSP = 6
  case crcAnyCRLOrOCSP = 7
  case crcAnyOCSPOrCRL = 8
}

@property (nonatomic,readwrite,assign,getter=revocationCheck,setter=setRevocationCheck:) int revocationCheck;

- (int)revocationCheck;
- (void)setRevocationCheck :(int)newRevocationCheck;

Default Value

1

Remarks

Revocation checking is necessary to ensure the integrity of the chain and obtain up-to-date certificate validity and trustworthiness information.

Certificate Revocation Lists (CRL) and Online Certificate Status Protocol (OCSP) responses serve the same purpose of ensuring that the certificate had not been revoked by the Certificate Authority (CA) at the time of use. Depending on your circumstances and security policy requirements, you may want to use either one or both of the revocation information source types.

This setting controls the way the revocation checks are performed. Typically certificates come with two types of revocation information sources: CRL (certificate revocation lists) and OCSP responders. CRLs are static objects periodically published by the CA at some online location. OCSP responders are active online services maintained by the CA that can provide up-to-date information on certificate statuses in near real time.

There are some conceptual differences between the two. CRLs are normally larger in size. Their use involves some latency because there is normally some delay between the time when a certificate was revoked and the time the subsequent CRL mentioning that is published. The benefits of CRL is that the same object can provide statuses for all certificates issued by a particular CA, and that the whole technology is much simpler than OCSP (and thus is supported by more CAs).

This setting lets you adjust the validation course by including or excluding certain types of revocation sources from the validation process. The crcAnyOCSPOrCRL setting (give preference to faster OCSP route and only demand one source to succeed) is a good choice for most of typical validation environments. The "crcAll*" modes are much stricter, and may be used in scenarios where bulletproof validity information is essential.

SecurityHeaderIndex Property (SOAPSigner Module)

Specifies the SecurityHeader index.

Syntax

• Swift
• Objective-C

public var securityHeaderIndex: Int32 {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=securityHeaderIndex,setter=setSecurityHeaderIndex:) int securityHeaderIndex;

- (int)securityHeaderIndex;
- (void)setSecurityHeaderIndex :(int)newSecurityHeaderIndex;

Default Value

-1

Remarks

Use this property to specify the index of SecurityHeader element where to put the signature. If the specified SecurityHeader element doesn't exist then a new SecurityHeader element will be created. The default value is "-1", in this case a new SecurityHeader element will be always created.

Signatures Property (SOAPSigner Module)

Provides details of all signatures found in the SOAP message.

Syntax

• Swift
• Objective-C

public var signatures: Array<SOAPSignature> {
  get {...}
}

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

- (int)signatureCount;

- (int)signatureCanonicalizationMethod:(int)signatureIndex;

- (int)signatureCertificateIndex:(int)signatureIndex;

- (int)signatureChainValidationDetails:(int)signatureIndex;

- (int)signatureChainValidationResult:(int)signatureIndex;

- (NSString*)signatureClaimedSigningTime:(int)signatureIndex;

- (long long)signatureHandle:(int)signatureIndex;

- (NSString*)signatureHashAlgorithm:(int)signatureIndex;

- (NSString*)signatureIssuerRDN:(int)signatureIndex;

- (NSString*)signatureLastArchivalTime:(int)signatureIndex;

- (NSString*)signaturePolicyHash:(int)signatureIndex;

- (NSString*)signaturePolicyHashAlgorithm:(int)signatureIndex;

- (NSString*)signaturePolicyID:(int)signatureIndex;

- (NSString*)signaturePolicyURI:(int)signatureIndex;

- (NSData*)signatureSerialNumber:(int)signatureIndex;

- (NSData*)signatureSignatureBytes:(int)signatureIndex;

- (int)signatureSignatureType:(int)signatureIndex;

- (int)signatureSignatureValidationResult:(int)signatureIndex;

- (NSData*)signatureSubjectKeyID:(int)signatureIndex;

- (NSString*)signatureSubjectRDN:(int)signatureIndex;

- (BOOL)signatureTimestamped:(int)signatureIndex;

- (NSString*)signatureValidatedSigningTime:(int)signatureIndex;

- (NSString*)signatureValidationLog:(int)signatureIndex;

- (BOOL)signatureXAdES:(int)signatureIndex;

- (int)signatureXAdESForm:(int)signatureIndex;

- (int)signatureXAdESVersion:(int)signatureIndex;

- (NSString*)signatureXMLElement:(int)signatureIndex;

Default Value

""

Remarks

Use this property to get the details of all the signatures identified in the message.

SigningCertificate Property (SOAPSigner Module)

The certificate to be used for signing.

Syntax

• Swift
• Objective-C

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

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

- (NSData*)signingCertBytes;

@property (nonatomic,readwrite,assign,getter=signingCertHandle,setter=setSigningCertHandle:) long long signingCertHandle;

- (long long)signingCertHandle;
- (void)setSigningCertHandle :(long long)newSigningCertHandle;

 

Default Value

""

Remarks

Use this property to specify the certificate that shall be used for signing the data. Note that this certificate should have a private key associated with it. Use SigningChain to supply the rest of the certificate chain for inclusion into the signature.

SigningChain Property (SOAPSigner Module)

The signing certificate chain.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=signingChainCount,setter=setSigningChainCount:) int signingChainCount;

- (int)signingChainCount;
- (void)setSigningChainCount :(int)newSigningChainCount;

- (NSData*)signingChainBytes:(int)signingChainIndex;

- (long long)signingChainHandle:(int)signingChainIndex;
- (void)setSigningChainHandle:(int)signingChainIndex :(long long)newSigningChainHandle;

Default Value

""

Remarks

Use this property to provide the chain for the signing certificate. Use SigningCertificate property, if it is available, to provide the signing certificate itself.

SocketSettings Property (SOAPSigner Module)

Manages network connection settings.

Syntax

• Swift
• Objective-C

public var socketSettings: SocketSettings {
  get {...}
}

@property (nonatomic,readwrite,assign,getter=socketDNSMode,setter=setSocketDNSMode:) int socketDNSMode;

- (int)socketDNSMode;
- (void)setSocketDNSMode :(int)newSocketDNSMode;

@property (nonatomic,readwrite,assign,getter=socketDNSPort,setter=setSocketDNSPort:) int socketDNSPort;

- (int)socketDNSPort;
- (void)setSocketDNSPort :(int)newSocketDNSPort;

@property (nonatomic,readwrite,assign,getter=socketDNSQueryTimeout,setter=setSocketDNSQueryTimeout:) int socketDNSQueryTimeout;

- (int)socketDNSQueryTimeout;
- (void)setSocketDNSQueryTimeout :(int)newSocketDNSQueryTimeout;

@property (nonatomic,readwrite,assign,getter=socketDNSServers,setter=setSocketDNSServers:) NSString* socketDNSServers;

- (NSString*)socketDNSServers;
- (void)setSocketDNSServers :(NSString*)newSocketDNSServers;

@property (nonatomic,readwrite,assign,getter=socketDNSTotalTimeout,setter=setSocketDNSTotalTimeout:) int socketDNSTotalTimeout;

- (int)socketDNSTotalTimeout;
- (void)setSocketDNSTotalTimeout :(int)newSocketDNSTotalTimeout;

@property (nonatomic,readwrite,assign,getter=socketIncomingSpeedLimit,setter=setSocketIncomingSpeedLimit:) int socketIncomingSpeedLimit;

- (int)socketIncomingSpeedLimit;
- (void)setSocketIncomingSpeedLimit :(int)newSocketIncomingSpeedLimit;

@property (nonatomic,readwrite,assign,getter=socketLocalAddress,setter=setSocketLocalAddress:) NSString* socketLocalAddress;

- (NSString*)socketLocalAddress;
- (void)setSocketLocalAddress :(NSString*)newSocketLocalAddress;

@property (nonatomic,readwrite,assign,getter=socketLocalPort,setter=setSocketLocalPort:) int socketLocalPort;

- (int)socketLocalPort;
- (void)setSocketLocalPort :(int)newSocketLocalPort;

@property (nonatomic,readwrite,assign,getter=socketOutgoingSpeedLimit,setter=setSocketOutgoingSpeedLimit:) int socketOutgoingSpeedLimit;

- (int)socketOutgoingSpeedLimit;
- (void)setSocketOutgoingSpeedLimit :(int)newSocketOutgoingSpeedLimit;

@property (nonatomic,readwrite,assign,getter=socketTimeout,setter=setSocketTimeout:) int socketTimeout;

- (int)socketTimeout;
- (void)setSocketTimeout :(int)newSocketTimeout;

@property (nonatomic,readwrite,assign,getter=socketUseIPv6,setter=setSocketUseIPv6:) BOOL socketUseIPv6;

- (BOOL)socketUseIPv6;
- (void)setSocketUseIPv6 :(BOOL)newSocketUseIPv6;

 

Default Value

""

Remarks

Use this property to tune up network connection parameters.

Timestamps Property (SOAPSigner Module)

Contains a collection of timestamps for the processed document.

Syntax

• Swift
• Objective-C

public var timestamps: Array<TimestampInfo> {
  get {...}
}

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

- (int)timestampCount;

- (long long)timestampAccuracy:(int)timestampIndex;

- (NSData*)timestampBytes:(int)timestampIndex;

- (int)timestampCertificateIndex:(int)timestampIndex;

- (int)timestampChainValidationDetails:(int)timestampIndex;

- (int)timestampChainValidationResult:(int)timestampIndex;

- (NSString*)timestampHashAlgorithm:(int)timestampIndex;

- (NSData*)timestampSerialNumber:(int)timestampIndex;

- (int)timestampSignatureIndex:(int)timestampIndex;

- (NSString*)timestampTime:(int)timestampIndex;

- (int)timestampTimestampType:(int)timestampIndex;

- (NSString*)timestampTSAName:(int)timestampIndex;

- (NSString*)timestampValidationLog:(int)timestampIndex;

- (int)timestampValidationResult:(int)timestampIndex;

Default Value

""

Remarks

Use this property to access the timestamps included in the processed document.

TimestampServer Property (SOAPSigner Module)

The address of the timestamping server.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=timestampServer,setter=setTimestampServer:) NSString* timestampServer;

- (NSString*)timestampServer;
- (void)setTimestampServer :(NSString*)newTimestampServer;

Default Value

""

Remarks

Use this property to set the address of the TSA (Time Stamping Authority) server which should be used for timestamping the signature.

TLSClientChain Property (SOAPSigner Module)

The TLS client certificate chain.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=TLSClientCertCount,setter=setTLSClientCertCount:) int TLSClientCertCount;

- (int)TLSClientCertCount;
- (void)setTLSClientCertCount :(int)newTLSClientCertCount;

- (NSData*)TLSClientCertBytes:(int)tLSClientCertIndex;

- (long long)TLSClientCertHandle:(int)tLSClientCertIndex;
- (void)setTLSClientCertHandle:(int)tLSClientCertIndex :(long long)newTLSClientCertHandle;

Default Value

""

Remarks

Assign a certificate chain to this property to enable TLS client authentication in the class. Note that the client's end-entity certificate should have a private key associated with it.

TLSServerChain Property (SOAPSigner Module)

The TLS server's certificate chain.

Syntax

• Swift
• Objective-C

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

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

- (int)TLSServerCertCount;

- (NSData*)TLSServerCertBytes:(int)tLSServerCertIndex;

- (long long)TLSServerCertHandle:(int)tLSServerCertIndex;

Default Value

""

Remarks

Use this property to access the certificate chain sent by the TLS server.

TLSSettings Property (SOAPSigner Module)

Manages TLS layer settings.

Syntax

• Swift
• Objective-C

public var tlsSettings: TLSSettings {
  get {...}
}

@property (nonatomic,readwrite,assign,getter=TLSAutoValidateCertificates,setter=setTLSAutoValidateCertificates:) BOOL TLSAutoValidateCertificates;

- (BOOL)TLSAutoValidateCertificates;
- (void)setTLSAutoValidateCertificates :(BOOL)newTLSAutoValidateCertificates;

@property (nonatomic,readwrite,assign,getter=TLSBaseConfiguration,setter=setTLSBaseConfiguration:) int TLSBaseConfiguration;

- (int)TLSBaseConfiguration;
- (void)setTLSBaseConfiguration :(int)newTLSBaseConfiguration;

@property (nonatomic,readwrite,assign,getter=TLSCiphersuites,setter=setTLSCiphersuites:) NSString* TLSCiphersuites;

- (NSString*)TLSCiphersuites;
- (void)setTLSCiphersuites :(NSString*)newTLSCiphersuites;

@property (nonatomic,readwrite,assign,getter=TLSECCurves,setter=setTLSECCurves:) NSString* TLSECCurves;

- (NSString*)TLSECCurves;
- (void)setTLSECCurves :(NSString*)newTLSECCurves;

@property (nonatomic,readwrite,assign,getter=TLSExtensions,setter=setTLSExtensions:) NSString* TLSExtensions;

- (NSString*)TLSExtensions;
- (void)setTLSExtensions :(NSString*)newTLSExtensions;

@property (nonatomic,readwrite,assign,getter=TLSForceResumeIfDestinationChanges,setter=setTLSForceResumeIfDestinationChanges:) BOOL TLSForceResumeIfDestinationChanges;

- (BOOL)TLSForceResumeIfDestinationChanges;
- (void)setTLSForceResumeIfDestinationChanges :(BOOL)newTLSForceResumeIfDestinationChanges;

@property (nonatomic,readwrite,assign,getter=TLSPreSharedIdentity,setter=setTLSPreSharedIdentity:) NSString* TLSPreSharedIdentity;

- (NSString*)TLSPreSharedIdentity;
- (void)setTLSPreSharedIdentity :(NSString*)newTLSPreSharedIdentity;

@property (nonatomic,readwrite,assign,getter=TLSPreSharedKey,setter=setTLSPreSharedKey:) NSString* TLSPreSharedKey;

- (NSString*)TLSPreSharedKey;
- (void)setTLSPreSharedKey :(NSString*)newTLSPreSharedKey;

@property (nonatomic,readwrite,assign,getter=TLSPreSharedKeyCiphersuite,setter=setTLSPreSharedKeyCiphersuite:) NSString* TLSPreSharedKeyCiphersuite;

- (NSString*)TLSPreSharedKeyCiphersuite;
- (void)setTLSPreSharedKeyCiphersuite :(NSString*)newTLSPreSharedKeyCiphersuite;

@property (nonatomic,readwrite,assign,getter=TLSRenegotiationAttackPreventionMode,setter=setTLSRenegotiationAttackPreventionMode:) int TLSRenegotiationAttackPreventionMode;

- (int)TLSRenegotiationAttackPreventionMode;
- (void)setTLSRenegotiationAttackPreventionMode :(int)newTLSRenegotiationAttackPreventionMode;

@property (nonatomic,readwrite,assign,getter=TLSRevocationCheck,setter=setTLSRevocationCheck:) int TLSRevocationCheck;

- (int)TLSRevocationCheck;
- (void)setTLSRevocationCheck :(int)newTLSRevocationCheck;

@property (nonatomic,readwrite,assign,getter=TLSSSLOptions,setter=setTLSSSLOptions:) int TLSSSLOptions;

- (int)TLSSSLOptions;
- (void)setTLSSSLOptions :(int)newTLSSSLOptions;

@property (nonatomic,readwrite,assign,getter=TLSTLSMode,setter=setTLSTLSMode:) int TLSTLSMode;

- (int)TLSTLSMode;
- (void)setTLSTLSMode :(int)newTLSTLSMode;

@property (nonatomic,readwrite,assign,getter=TLSUseExtendedMasterSecret,setter=setTLSUseExtendedMasterSecret:) BOOL TLSUseExtendedMasterSecret;

- (BOOL)TLSUseExtendedMasterSecret;
- (void)setTLSUseExtendedMasterSecret :(BOOL)newTLSUseExtendedMasterSecret;

@property (nonatomic,readwrite,assign,getter=TLSUseSessionResumption,setter=setTLSUseSessionResumption:) BOOL TLSUseSessionResumption;

- (BOOL)TLSUseSessionResumption;
- (void)setTLSUseSessionResumption :(BOOL)newTLSUseSessionResumption;

@property (nonatomic,readwrite,assign,getter=TLSVersions,setter=setTLSVersions:) int TLSVersions;

- (int)TLSVersions;
- (void)setTLSVersions :(int)newTLSVersions;

 

Default Value

""

Remarks

Use this property to tune up the TLS layer parameters.

TrustedCertificates Property (SOAPSigner Module)

A list of trusted certificates for chain validation.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=trustedCertCount,setter=setTrustedCertCount:) int trustedCertCount;

- (int)trustedCertCount;
- (void)setTrustedCertCount :(int)newTrustedCertCount;

- (NSData*)trustedCertBytes:(int)trustedCertIndex;

- (long long)trustedCertHandle:(int)trustedCertIndex;
- (void)setTrustedCertHandle:(int)trustedCertIndex :(long long)newTrustedCertHandle;

Default Value

""

Remarks

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

The purpose of this certificate collection is largely the same than that of Windows Trusted Root Certification Authorities system store.

Use this property with extreme care as it directly affects chain verifiability; a wrong certificate added to the trusted list may result in bad chains being accepted, and forfeited signatures being recognized as genuine. Only add certificates that originate from the parties that you know and trust.

ValidationMoment Property (SOAPSigner Module)

The time point at which signature validity is to be established.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=validationMoment,setter=setValidationMoment:) NSString* validationMoment;

- (NSString*)validationMoment;
- (void)setValidationMoment :(NSString*)newValidationMoment;

Default Value

""

Remarks

Use this property to specify the moment in time at which signature validity should be established. The time is in UTC. Leave the setting empty to stick to the default moment (either signature creation time, or current time).

The validity of the same signature may differ depending on the time point chosen due to temporal changes in chain validities, revocation statuses, and timestamp times.

XPathNamespaces Property (SOAPSigner Module)

Specifies namespaces for XPath expression.

Syntax

• Swift
• Objective-C

public var xPathNamespaces: Array<XMLNamespace> {
  get {...}
}

@property (nonatomic,readwrite,assign,getter=namespaceCount,setter=setNamespaceCount:) int namespaceCount;

- (int)namespaceCount;
- (void)setNamespaceCount :(int)newNamespaceCount;

- (NSString*)namespacePrefix:(int)namespaceIndex;
- (void)setNamespacePrefix:(int)namespaceIndex :(NSString*)newNamespacePrefix;

- (NSString*)namespaceURI:(int)namespaceIndex;
- (void)setNamespaceURI:(int)namespaceIndex :(NSString*)newNamespaceURI;

Default Value

""

Remarks

Use this property to provide a list of prefixes and namespaceURIs to use in XPath expressions with TargetXMLElement and XPathPrefixList properties of the references.

AddBodyReference Method (SOAPSigner Module)

Creates a new XML reference to the Body element of the SOAP message.

Syntax

• Swift
• Objective-C

public func addBodyReference(customId: String, autoGenerateId: Bool) throws -> Int32

- (int)addBodyReference:(NSString*)customId :(BOOL)autoGenerateId;

Remarks

Use this method to add a reference to the Body element of the SOAP message.

The reference's URI is set basing on the ID of the XML element. If the XML element doesn't have an ID then a CustomId value will be used. If CustomId is empty and AutoGenerateId is set, the ID will be generated automatically. An exception will be thrown otherwise.

Use CanonicalizationMethod and HashAlgorithm properties to specify the canonicalization method and hash algorithm to use.

The method returns the index of the new reference entry in the References collection.

AddDataReference Method (SOAPSigner Module)

Creates a new XML reference to the specified data.

Syntax

• Swift
• Objective-C

public func addDataReference(dataURI: String, data: Data) throws -> Int32

- (int)addDataReference:(NSString*)dataURI :(NSData*)data;

Remarks

Use this method to add a reference to the custom data. Pass the reference's URI via DataURI parameter.

Use HashAlgorithm property to specify the hash algorithm to use.

The method returns the index of the new reference entry in the References collection.

AddReference Method (SOAPSigner Module)

Creates a new XML reference to the specified XML element.

Syntax

• Swift
• Objective-C

public func addReference(targetXmlElement: String, customId: String, autoGenerateId: Bool) throws -> Int32

- (int)addReference:(NSString*)targetXmlElement :(NSString*)customId :(BOOL)autoGenerateId;

Remarks

Use this method to add a reference to a particular XML element.

The reference's URI is set basing on the ID of the XML element. If the XML element doesn't have an ID then a CustomId value will be used. If CustomId is empty and AutoGenerateId is set, the ID will be generated automatically. An exception will be thrown otherwise.

Use CanonicalizationMethod and HashAlgorithm properties to specify the canonicalization method and hash algorithm to use.

The method returns the index of the new reference entry in the References collection.

AddTimestampValidationData Method (SOAPSigner Module)

Use this method to add timestamp validation data to the signature.

Syntax

• Swift
• Objective-C

public func addTimestampValidationData(sigIndex: Int32) throws -> Void

- (void)addTimestampValidationData:(int)sigIndex;

Remarks

Call this method to add certificates and revocation information used to validate timestamp's signer certificates at a particular time. This method could be called separately or in SignatureValidated event handler after successful signature validation.

AddValidationDataRefs Method (SOAPSigner Module)

Use this method to add signature validation references to the signature.

Syntax

• Swift
• Objective-C

public func addValidationDataRefs(sigIndex: Int32) throws -> Void

- (void)addValidationDataRefs:(int)sigIndex;

Remarks

Call this method to add references to certificates and revocation information used to validate a signature at a particular time. This method could be called separately or in SignatureValidated event handler after successful signature validation.

AddValidationDataValues Method (SOAPSigner Module)

Use this method to add signature validation values to the signature.

Syntax

• Swift
• Objective-C

public func addValidationDataValues(sigIndex: Int32) throws -> Void

- (void)addValidationDataValues:(int)sigIndex;

Remarks

Call this method to add certificates and revocation information used to validate a signature at a particular time. This method could be called separately or in SignatureValidated event handler after successful signature validation.

Close Method (SOAPSigner Module)

Closes an opened SOAP message.

Syntax

• Swift
• Objective-C

public func close(saveChanges: Bool) throws -> Void

- (void)close:(BOOL)saveChanges;

Remarks

Use this method to close a previously opened SOAP message. Set SaveChanges to true to apply any changes made.

Config Method (SOAPSigner 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 (SOAPSigner 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 insencitive) 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;....

ExtractAsyncData Method (SOAPSigner Module)

Extracts user data from the DC signing service response.

Syntax

• Swift
• Objective-C

public func extractAsyncData(asyncReply: String) throws -> String

- (NSString*)extractAsyncData:(NSString*)asyncReply;

Remarks

Call this method before finalizing the asynchronous signing process to extract the data passed to the ExternalCrypto.Data property on the pre-signing stage.

The Data parameter can be used to pass some state or document identifier along with the signing request from the pre-signing to completion async stage.

GetInnerXML Method (SOAPSigner Module)

Get the inner XML content of the selected XML element.

Syntax

• Swift
• Objective-C

public func getInnerXML(xPath: String) throws -> String

- (NSString*)getInnerXML:(NSString*)XPath;

Remarks

Call this method to get the inner XML content of the selected XML element.

GetOuterXML Method (SOAPSigner Module)

Get the outer XML content of the selected XML element.

Syntax

• Swift
• Objective-C

public func getOuterXML(xPath: String) throws -> String

- (NSString*)getOuterXML:(NSString*)XPath;

Remarks

Call this method to get the outer XML content of the selected XML element.

GetTextContent Method (SOAPSigner Module)

Get the text content of the selected XML element.

Syntax

• Swift
• Objective-C

public func getTextContent(xPath: String) throws -> String

- (NSString*)getTextContent:(NSString*)XPath;

Remarks

Call this method to get the text content of the selected XML element.

Open Method (SOAPSigner Module)

Opens a document for signing or updating.

Syntax

• Swift
• Objective-C

public func open() throws -> Void

- (void)open;

Remarks

Use this method to open a document for signing or updating. When finished, call Close to complete or discard the operation.

Revalidate Method (SOAPSigner Module)

Revalidates a signature in accordance with current settings.

Syntax

• Swift
• Objective-C

public func revalidate(sigIndex: Int32) throws -> Void

- (void)revalidate:(int)sigIndex;

Remarks

Use this method to re-validate a signature in the opened SOAP message.

SetInnerXML Method (SOAPSigner Module)

Set the inner XML content of the selected XML element.

Syntax

• Swift
• Objective-C

public func setInnerXML(xPath: String, value: String) throws -> Void

- (void)setInnerXML:(NSString*)XPath :(NSString*)value;

Remarks

Call this method to set the inner XML content of the selected XML element.

SetTextContent Method (SOAPSigner Module)

Set the text content of the selected XML element.

Syntax

• Swift
• Objective-C

public func setTextContent(xPath: String, value: String) throws -> Void

- (void)setTextContent:(NSString*)XPath :(NSString*)value;

Remarks

Call this method to set the text content of the selected XML element.

Sign Method (SOAPSigner Module)

Signs the SOAP message.

Syntax

• Swift
• Objective-C

public func sign() throws -> Void

- (void)sign;

Remarks

Call this method to generate a signed SOAP message.

SignAsyncBegin Method (SOAPSigner Module)

Initiates the asynchronous signing operation.

Syntax

• Swift
• Objective-C

public func signAsyncBegin() throws -> String

- (NSString*)signAsyncBegin;

Remarks

When using the DC framework, call this method to initiate the asynchronous signing process. Upon completion, a pre-signed copy of the document will be saved in OutputFile (or OutputStream). Keep the pre-signed copy somewhere local, and pass the returned string ('the request state') to the DC processor for handling.

Upon receiving the response state from the DC processor, assign the path to the pre-signed copy to InputFile (or InputStream), and call SignAsyncEnd to finalize the signing.

Note that depending on the signing method and DC configuration used, you may still need to provide the public part of the signing certificate via the SigningCertificate property.

Use the ExternalCrypto.AsyncDocumentID property to supply a unique document ID to include in the request. This is helpful when creating batches of multiple async requests, as it allows you to pass the whole response batch to SignAsyncEnd and expect it to recover the correct response from the batch automatically.

AsyncState is a message of the distributed cryptography (DC) protocol. DC protocol is based on exchange of async states between a DC client (an application that wants to sign a PDF, XML, or Office document) and a DC server (an application that controls access to the private key). An async state can carry one or more signing requests, comprised of document hashes, or one or more signatures produced over those hashes.

In a typical scenario you get a client-side async state from the SignAsyncBegin method. This state contains document hashes to be signed on the DC server side. You then send the async state to the DC server (often represented by the DCAuth control), which processes it and produces a matching signatures state. The async state produced by the server is then passed to the SignAsyncEnd method.

SignAsyncEnd Method (SOAPSigner Module)

Completes the asynchronous signing operation.

Syntax

• Swift
• Objective-C

public func signAsyncEnd(asyncReply: String) throws -> Void

- (void)signAsyncEnd:(NSString*)asyncReply;

Remarks

When using the DC framework, call this method upon receiving the response state from the DC processor to complete the asynchronous signing process.

Before calling this method, assign the path to the pre-signed copy of the document obtained from prior SignAsyncBegin call to InputFile (or InputStream). The method will embed the signature into the pre-signed document, and save the complete signed document to OutputFile (or OutputStream).

Note that depending on the signing method and DC configuration used, you may still need to provide the public part of the signing certificate via the SigningCertificate property.

Use the ExternalCrypto.AsyncDocumentID parameter to pass a specific document ID if using batched AsyncReply. If used, it should match the value provided on the pre-signing (SignAsyncBegin) stage.

AsyncState is a message of the distributed cryptography (DC) protocol. DC protocol is based on exchange of async states between a DC client (an application that wants to sign a PDF, XML, or Office document) and a DC server (an application that controls access to the private key). An async state can carry one or more signing requests, comprised of document hashes, or one or more signatures produced over those hashes.

In a typical scenario you get a client-side async state from the SignAsyncBegin method. This state contains document hashes to be signed on the DC server side. You then send the async state to the DC server (often represented by the DCAuth control), which processes it and produces a matching signatures state. The async state produced by the server is then passed to the SignAsyncEnd method.

SignExternal Method (SOAPSigner Module)

Signs the document using an external signing facility.

Syntax

• Swift
• Objective-C

public func signExternal() throws -> Void

- (void)signExternal;

Remarks

Call this method to delegate the low-level signing operation to an external, remote, or custom signing engine. This method is useful if the signature has to be made by a device accessible through a custom or non-standard signing interface.

When all preparations are done and hash is computed, the class fires ExternalSign event which allows to pass the hash value for signing.

Timestamp Method (SOAPSigner Module)

Use this method to add an timestamp.

Syntax

• Swift
• Objective-C

public func timestamp(sigIndex: Int32, timestampType: Int32) throws -> Void

- (void)timestamp:(int)sigIndex :(int)timestampType;

Remarks

Call this method to timestamp the signature. Use the TimestampServer property to provide the address of the TSA (Time Stamping Authority) server which should be used for timestamping. This method could be called separately or in SignatureValidated event handler after successful signature validation. Use the TimestampType parameter to specify the type of timestamp to create

Supported timestamp types:

Upgrade Method (SOAPSigner Module)

Upgrades existing XAdES signature to a new form.

Syntax

• Swift
• Objective-C

public func upgrade(sigIndex: Int32, toForm: Int32) throws -> Void

- (void)upgrade:(int)sigIndex :(int)toForm;

Remarks

XAdES standard defines a number of different 'forms' of signatures which can be used for different purposes. Use this method to upgrade XAdES signature to a new form specified by ToForm. Signatures can normally be upgraded from less sophisticated levels (BES, EPES) to more sophisticated (T, C, X, X-L, A).

Supported forms:

ChainElementDownload Event (SOAPSigner Module)

Fires when there is a need to download a chain element from an online source.

Syntax

• Swift
• Objective-C

func onChainElementDownload(kind: Int32, certRDN: String, caCertRDN: String, location: String, action: inout Int32)

- (void)onChainElementDownload:(int)kind :(NSString*)certRDN :(NSString*)CACertRDN :(NSString*)location :(int*)action;

Remarks

Subscribe to this event to be notified about validation element retrievals. Use Action parameter to suppress the download if required.

ChainElementNeeded Event (SOAPSigner Module)

Fires when an element required to validate the chain was not located.

Syntax

• Swift
• Objective-C

func onChainElementNeeded(kind: Int32, certRDN: String, caCertRDN: String)

- (void)onChainElementNeeded:(int)kind :(NSString*)certRDN :(NSString*)CACertRDN;

Remarks

Subscribe to this event to be notified about missing validation elements. Use the KnownCRLs, KnownCertificates, and KnownOCSPs properties in the event handler to provide the missing piece.

ChainElementStore Event (SOAPSigner Module)

This event is fired when a chain element (certificate, CRL, or OCSP response) should be stored along with a signature.

Syntax

• Swift
• Objective-C

func onChainElementStore(kind: Int32, body: Data, uri: inout String)

- (void)onChainElementStore:(int)kind :(NSData*)body :(NSString**)URI;

Remarks

This event could occur if you are verifying XAdES-C form or higher. The Body parameter contains the element in binary form that should be stored along with a signature. Use the URI parameter to provide an URI of the stored element.

ChainValidated Event (SOAPSigner Module)

Reports the completion of a certificate chain validation.

Syntax

• Swift
• Objective-C

func onChainValidated(index: Int32, subjectRDN: String, validationResult: Int32, validationDetails: Int32)

- (void)onChainValidated:(int)index :(NSString*)subjectRDN :(int)validationResult :(int)validationDetails;

Remarks

This event is fired when a certificate chain validation routine completes. SubjectRDN identifies the owner of the validated certificate.

ValidationResult set to 0 (zero) indicates successful chain validation.

ChainValidationProgress Event (SOAPSigner Module)

This event is fired multiple times during chain validation to report various stages of the validation procedure.

Syntax

• Swift
• Objective-C

func onChainValidationProgress(eventKind: String, certRDN: String, caCertRDN: String, action: inout Int32)

- (void)onChainValidationProgress:(NSString*)eventKind :(NSString*)certRDN :(NSString*)CACertRDN :(int*)action;

Remarks

Subscribe to this event to be notified about chain validation progress. Use Action parameter to alter the validation flow.

The EventKind parameter reports the nature of the event being reported. The CertRDN and CACertRDN report the distinguished names of the certificates that are relevant for the event invocation (one or both can be empty, depending on EventKind. Use Action parameter to adjust the validation flow.

Error Event (SOAPSigner Module)

Information about errors during signing.

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 signing.

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 SOAP.

ExternalSign Event (SOAPSigner Module)

Handles remote or external signing initiated by the SignExternal method or other source.

Syntax

• Swift
• Objective-C

func onExternalSign(operationId: String, hashAlgorithm: String, pars: String, data: String, signedData: inout String)

- (void)onExternalSign:(NSString*)operationId :(NSString*)hashAlgorithm :(NSString*)pars :(NSString*)data :(NSString**)signedData;

Remarks

Assign a handler to this event if you need to delegate a low-level signing operation to an external, remote, or custom signing engine. Depending on the settings, the handler will receive a hashed or unhashed value to be signed.

The event handler must pass the value of Data to the signer, obtain the signature, and pass it back to the component via SignedData parameter.

OperationId provides a comment about the operation and its origin. It depends on the exact component being used, and may be empty. HashAlgorithm specifies the hash algorithm being used for the operation, and Pars contain algorithm-dependent parameters.

The component uses base16 (hex) encoding for Data, SignedData, and Pars parameters. If your signing engine uses a different input and output encoding, you may need to decode and/or encode the data before and/or after the signing.

A sample MD5 hash encoded in base16: a0dee2a0382afbb09120ffa7ccd8a152 - lower case base16 A0DEE2A0382AFBB09120FFA7CCD8A152 - upper case base16

A sample event handler that uses a .NET RSACryptoServiceProvider class may look like the following: signer.OnExternalSign += (s, e) => { var cert = new X509Certificate2("cert.pfx", "", X509KeyStorageFlags.Exportable); var key = (RSACryptoServiceProvider)cert.PrivateKey; var dataToSign = e.Data.FromBase16String(); var signedData = key.SignHash(dataToSign, "2.16.840.1.101.3.4.2.1"); e.SignedData = signedData.ToBase16String(); };

FormatElement Event (SOAPSigner Module)

Reports the XML element that is currently being processed.

Syntax

• Swift
• Objective-C

func onFormatElement(startTagWhitespace: inout String, endTagWhitespace: inout String, level: Int32, path: String, hasChildElements: Bool)

- (void)onFormatElement:(NSString**)startTagWhitespace :(NSString**)endTagWhitespace :(int)level :(NSString*)path :(BOOL)hasChildElements;

Remarks

Path and Level specify the path to the XML element being processed and its nesting level, respectively.

HasChildElements specify if processed XML element has child elements.

Among other purposes, this event may be used to add whitespace formatting before or after a particular element in the signature.

FormatText Event (SOAPSigner Module)

Reports XML text that is currently being processed.

Syntax

• Swift
• Objective-C

func onFormatText(text: inout String, textType: Int32, level: Int32, path: String)

- (void)onFormatText:(NSString**)text :(int)textType :(int)level :(NSString*)path;

Remarks

TextType parameter specifies the type of the XML text (normal or Base64-encoded) that is stored in the element; Path and Level specify the path to the XML element and its nesting level.

Among other purposes, this event may be used to add whitespace formatting before or after a particular element in the signature.

MessageLoaded Event (SOAPSigner Module)

This event is fired when the message has been loaded into memory.

Syntax

• Swift
• Objective-C

func onMessageLoaded(cancel: inout Bool)

- (void)onMessageLoaded:(int*)cancel;

Remarks

The handler for this event is a good place to check message properties, which may be useful when preparing the signature.

Set Cancel to true to terminate message processing on this stage.

Notification Event (SOAPSigner 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 component. 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 EventID parameter. EventParam contains any parameters accompanying the occurrence. Depending on the type of the component, the exact action it is performing, or the document being processed, one or both may be omitted.

This class can fire this event with the following EventID values:

ReferenceValidated Event (SOAPSigner Module)

Marks the end of a reference validation.

Syntax

• Swift
• Objective-C

func onReferenceValidated(referenceIndex: Int32, id: String, uri: String, refType: String, digestValid: Bool)

- (void)onReferenceValidated:(int)referenceIndex :(NSString*)ID :(NSString*)URI :(NSString*)refType :(BOOL)digestValid;

Remarks

The class fires this event to report completion of a reference validation. A reference is a building block of a signature as it binds signature coverage to a particular piece of the document.

ResolveReference Event (SOAPSigner Module)

Asks the application to resolve a reference.

Syntax

• Swift
• Objective-C

func onResolveReference(referenceIndex: Int32, uri: String)

- (void)onResolveReference:(int)referenceIndex :(NSString*)URI;

Remarks

This event is fired when the control could not automatically resolve a reference and requires custom treatment.

URI contains a reference to the data.

ReferenceIndex specifies the index of the reference to process.

Based on the reference's URI the event handler should set either TargetXMLElement or TargetData property of the reference.

SignatureFound Event (SOAPSigner Module)

Signifies the start of signature validation.

Syntax

• Swift
• Objective-C

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

- (void)onSignatureFound:(int)index :(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 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 KnownCertificates property.

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

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

SignatureValidated Event (SOAPSigner Module)

Marks the completion of the signature validation routine.

Syntax

• Swift
• Objective-C

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

- (void)onSignatureValidated:(int)index :(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 (SOAPSigner Module)

Signifies the start of a timestamp validation routine.

Syntax

• Swift
• Objective-C

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

- (void)onTimestampFound:(int)index :(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 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 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 SignatureValidationResult and ChainValidationResult properties respectively.

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

TimestampRequest Event (SOAPSigner Module)

Fires when the component is ready to request a timestamp from an external TSA.

Syntax

• Swift
• Objective-C

func onTimestampRequest(tsa: String, timestampRequest: String, timestampResponse: inout String, suppressDefault: inout Bool)

- (void)onTimestampRequest:(NSString*)TSA :(NSString*)timestampRequest :(NSString**)timestampResponse :(int*)suppressDefault;

Remarks

Subscribe to this event to be intercept timestamp requests. You can use it to override timestamping requests and perform them in your code.

The TSA parameter indicates the timestamping service being used. It matches the value passed to TimestampServer property. Set SuppressDefault parameter to false if you would like to stop the built-in TSA request from going ahead. The built-in TSA request is also not performed if the returned TimestampResponse parameter is not empty.

TimestampValidated Event (SOAPSigner Module)

Reports the completion of the timestamp validation routine.

Syntax

• Swift
• Objective-C

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

- (void)onTimestampValidated:(int)index :(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.

TLSCertNeeded Event (SOAPSigner Module)

Fires when a remote TLS party requests a client certificate.

Syntax

• Swift
• Objective-C

func onTLSCertNeeded(host: String, caNames: String)

- (void)onTLSCertNeeded:(NSString*)host :(NSString*)CANames;

Remarks

This event fires to notify the implementation that a remote TLS server has requested a client certificate. The Host parameter identifies the host that makes a request, and the CANames (optional, according to the TLS spec) advises on the accepted issuing CAs.

Use the TLSClientChain property in response to this event to provide the requested certificate. Please make sure the client certificate includes the associated private key. Note that you may set the certificates before the connection without waiting for this event to fire.

This event is preceded by the TLSHandshake event for the given host and, if the certificate was accepted, succeeded by the TLSEstablished event.

TLSCertValidate Event (SOAPSigner Module)

This event is fired upon receipt of the TLS server's certificate, allowing the user to control its acceptance.

Syntax

• Swift
• Objective-C

func onTLSCertValidate(serverHost: String, serverIP: String, accept: inout Bool)

- (void)onTLSCertValidate:(NSString*)serverHost :(NSString*)serverIP :(int*)accept;

Remarks

This event is fired during a TLS handshake. Use TLSServerChain property to access the certificate chain. In general case, components may contact a number of TLS endpoints during their work, depending on their configuration.

Accept is assigned in accordance with the outcome of the internal validation check performed by the component, and can be adjusted if needed.

TLSEstablished Event (SOAPSigner Module)

Fires when a TLS handshake with Host successfully completes.

Syntax

• Swift
• Objective-C

func onTLSEstablished(host: String, version: String, ciphersuite: String, connectionId: Data, abort: inout Bool)

- (void)onTLSEstablished:(NSString*)host :(NSString*)version :(NSString*)ciphersuite :(NSData*)connectionId :(int*)abort;

Remarks

The class uses this event to notify the application about successful completion of a TLS handshake.

The Version, Ciphersuite, and ConnectionId parameters indicate security parameters of the new connection. Use the Abort parameter if you need to terminate the connection at this stage.

TLSHandshake Event (SOAPSigner Module)

Fires when a new TLS handshake is initiated, before the handshake commences.

Syntax

• Swift
• Objective-C

func onTLSHandshake(host: String, abort: inout Bool)

- (void)onTLSHandshake:(NSString*)host :(int*)abort;

Remarks

The class uses this event to notify the application about the start of a new TLS handshake to Host. If the handshake is successful, this event will be followed with TLSEstablished event. If the server chooses to request a client certificate, TLSCertNeeded event will also be fired.

TLSShutdown Event (SOAPSigner Module)

Reports the graceful closure of a TLS connection.

Syntax

• Swift
• Objective-C

func onTLSShutdown(host: String)

- (void)onTLSShutdown:(NSString*)host;

Remarks

This event notifies the application about the closure of an earlier established TLS connection. Note that only graceful connection closures are reported.

Certificate Type

Provides details of an individual X.509 certificate.

Remarks

This type provides access to X.509 certificate details.

Fields

public init(stream: )

Loads the X.509 certificate from a stream. Stream is a stream containing the certificate data.

public init()

Creates a new object with default field values.

CRL Type

Represents a Certificate Revocation List.

Remarks

CRLs store information about revoked certificates, i.e., certificates that have been identified as invalid by their issuing certificate authority (CA) for any number of reasons.

Each CRL object lists certificates from a single CA and identifies them by their serial numbers. A CA may or may not publish a CRL, may publish several CRLs, or may publish the same CRL in multiple locations.

Unlike OCSP responses, CRLs only list certificates that have been revoked. They do not list certificates that are still valid.

Fields

public init()

public init()

public init()

public init()

public init()

public init()