SecureBlackbox 2020 iOS Edition

Questions / Feedback?

KMIPClient Class

Properties   Methods   Events   Configuration Settings   Errors  

The KMIPClient class provides client-side functionality for KMIP.

Syntax

SecureBlackboxKMIPClient
SecureBlackboxKMIPClientSwift

Remarks

The Key Management Interoperability Protocol (KMIP) is an OASIS standard for communication between different key management servers and clients.

Property List


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

- dataFileA path to the file containing the unsigned data.
- encoderTypeSpecifies the KMIP encoder type.
- externalCryptoCustomParamsCustom parameters to be passed to the signing service (uninterpreted).
- externalCryptoDataAdditional data to be included in the async state and mirrored back by the requestor.
- externalCryptoExternalHashCalculationSpecifies whether the message hash is to be calculated at the external endpoint.
- externalCryptoHashAlgorithmSpecifies the request's signature hash algorithm.
- externalCryptoKeyIDThe ID of the pre-shared key used for DC request authentication.
- externalCryptoKeySecretThe pre-shared key used for DC request authentication.
- externalCryptoMethodSpecifies the asynchronous signing method.
- externalCryptoModeSpecifies the external cryptography mode.
- externalCryptoPublicKeyAlgorithmProvide public key algorithm here if the certificate is not available on the pre-signing stage.
- hostSpecifies the host name of the KMIP server.
- inputFilePath to the file containing data to be signed, verified, encrypted or decrypted.
- objectCountThe number of records in the Object arrays.
- objectID:(int)objectIndexContains the value currently stored in the ID Placeholder.
- objectKeyAlgorithm:(int)objectIndexThe cryptographic algorithm for this object.
- objectKeyLength:(int)objectIndexThe length of the cryptographic key.
- objectObjectType:(int)objectIndexThe type of this object.
- objectSigAlgorithm:(int)objectIndexDigital signature algorithm for this object (only for certificates).
- objectUniqueIdentifier:(int)objectIndexThe unique identifier of the object generated by the key management system.
- outputFileSpecifies the file where the signed, encrypted, or decrypted data should be saved.
- passwordSpecifies a password to authenticate to the KMIP server.
- pinnedCertBytesReturns raw certificate data in DER format.
- pinnedCertHandleAllows to get or set a 'handle', a unique identifier of the underlying property object.
- pinnedCertRequestBytesProvides access to raw certificate request data in DER format.
- pinnedCertRequestHandleAllows to get or set a 'handle', a unique identifier of the underlying property object.
- portSpecifies the port on the KMIP server to connect to.
- proxyAddressThe IP address of the proxy server.
- proxyAuthenticationThe authentication type used by the proxy server.
- proxyPasswordThe password to authenticate to the proxy server.
- proxyPortThe port on the proxy server to connect to.
- proxyProxyTypeThe type of the proxy server.
- proxyRequestHeadersContains HTTP request headers for WebTunnel and HTTP proxy.
- proxyResponseBodyContains the HTTP or HTTPS (WebTunnel) proxy response body.
- proxyResponseHeadersContains response headers received from an HTTP or HTTPS (WebTunnel) proxy server.
- proxyUseIPv6Specifies whether IPv6 should be used when connecting through the proxy.
- proxyUseProxyEnables or disables proxy-driven connection.
- proxyUsernameSpecifies the username credential for proxy authentication.
- signatureValidationResultThe signature validation result.
- socketDNSModeSelects the DNS resolver to use: the class's (secure) built-in one, or the one provided by the system.
- socketDNSPortSpecifies the port number to be used for sending queries to the DNS server.
- socketDNSQueryTimeoutThe timeout (in milliseconds) for each DNS query.
- socketDNSServersThe addresses of DNS servers to use for address resolution, separated by commas or semicolons.
- socketDNSTotalTimeoutThe timeout (in milliseconds) for the whole resolution process.
- socketIncomingSpeedLimitThe maximum number of bytes to read from the socket, per second.
- socketLocalAddressThe local network interface to bind the socket to.
- socketLocalPortThe local port number to bind the socket to.
- socketOutgoingSpeedLimitThe maximum number of bytes to write to the socket, per second.
- socketTimeoutThe maximum period of waiting, in milliseconds, after which the socket operation is considered unsuccessful.
- socketUseIPv6Enables or disables IP protocol version 6.
- TLSClientCertCountThe number of records in the TLSClientCert arrays.
- TLSClientCertBytes:(int)tLSClientCertIndexReturns raw certificate data in DER format.
- TLSClientCertHandle:(int)tLSClientCertIndexAllows to get or set a 'handle', a unique identifier of the underlying property object.
- TLSServerCertCountThe number of records in the TLSServerCert arrays.
- TLSServerCertBytes:(int)tLSServerCertIndexReturns raw certificate data in DER format.
- TLSServerCertHandle:(int)tLSServerCertIndexAllows to get or set a 'handle', a unique identifier of the underlying property object.
- TLSAutoValidateCertificatesSpecifies whether server-side TLS certificates should be validated automatically using internal validation rules.
- TLSBaseConfigurationSelects the base configuration for the TLS settings.
- TLSCiphersuitesA list of ciphersuites separated with commas or semicolons.
- TLSECCurvesDefines the elliptic curves to enable.
- TLSForceResumeIfDestinationChangesWhether to force TLS session resumption when the destination address changes.
- TLSPreSharedIdentityDefines the identity used when the PSK (Pre-Shared Key) key-exchange mechanism is negotiated.
- TLSPreSharedKeyContains the pre-shared for the PSK (Pre-Shared Key) key-exchange mechanism, encoded with base16.
- TLSPreSharedKeyCiphersuiteDefines the ciphersuite used for PSK (Pre-Shared Key) negotiation.
- TLSRenegotiationAttackPreventionModeSelects renegotiation attack prevention mechanism.
- TLSRevocationCheckSpecifies the kind(s) of revocation check to perform.
- TLSSSLOptionsVarious SSL (TLS) protocol options, set of cssloExpectShutdownMessage 0x001 Wait for the close-notify message when shutting down the connection cssloOpenSSLDTLSWorkaround 0x002 (DEPRECATED) Use a DTLS version workaround when talking to very old OpenSSL versions cssloDisableKexLengthAlignment 0x004 Do not align the client-side PMS by the RSA modulus size.
- TLSTLSModeSpecifies the TLS mode to use.
- TLSUseExtendedMasterSecretEnables Extended Master Secret Extension, as defined in RFC 7627.
- TLSUseSessionResumptionEnables or disables TLS session resumption capability.
- TLSVersionsTh SSL/TLS versions to enable by default.
- usernameThe username to authenticate to the KMIP server.

Method List


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

- addCertificateImports a certificate to the KMIP server.
- addKeyImports a key to the KMIP server.
- addPinnedImports a certificate to the KMIP server.
- configSets or retrieves a configuration setting.
- decryptDecrypts the provided data using a key stored on the KMIP server.
- encryptEncrypts the provided data using a key stored on the KMIP server.
- generateCertGenerates a new certificate on the KMIP server.
- generateCertFromPinnedGenerates a new certificate on the KMIP server from the pinned certificate.
- generateCertFromRequestGenerates a new certificate on the KMIP server from the certificate request.
- generateKeyGenerates a symmetric key or an asymmetric key pair on the KMIP server.
- getListRetrieves the list of objects of a given type.
- removeRemoves the specified object from the server.
- signSigns the data using a key on the KMIP server.
- verifyVerifies digitally signed data.

Event List


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

- onErrorProvides information about errors during KMIP operations.
- onExternalSignHandles remote or external signing initiated by the SignExternal method or other source.
- onNotificationThis event notifies the application about an underlying control flow event.
- onTLSCertValidateThis event is fired upon receipt of the TLS server's certificate, allowing the user to control its acceptance.

Configuration Settings


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

BlockCipherModeBlock cipher mode to use for encrypting or decrypting.
BlockSizeBlock size of data for encrypting, decrypting or signing.
CurveName of the curve of the newly added elliptic cryptography (EC) key.
HashAlgorithmHash algorithm to use for signing or verifying.
IVCounterNonceInitialization vector, counter or nonce for encrypting or decrypting.
MajorProtocolVersionMajor protocol version of the KMIP server.
MaximumItemsThe maximum number of items to be returned on getting the object list.
MinorProtocolVersionMinor protocol version of the KMIP server.
OffsetItemsThe number of items to skip on getting the object list.
PaddingMethodPadding method to use for encrypting or decrypting.
RandomIVWhether to generate the initialization vector automatically.
TagLengthTag length to use for encrypting or decrypting.
TempPathPath for storing temporary files.
CheckKeyIntegrityBeforeUseEnables or disable private key integrity check before use.
CookieCachingSpecifies whether a cookie cache should be used for HTTP(S) transports.
CookiesGets or sets local cookies for the class (supported for HTTPClient, RESTClient and SOAPClient only).
DefDeriveKeyIterationsSpecifies the default key derivation algorithm iteration count.
EnableClientSideSSLFFDHEEnables or disables finite field DHE key exchange support in TLS clients.
GlobalCookiesGets or sets global cookies for all the HTTP transports.
HttpUserAgentSpecifies the user agent name to be used by all HTTP clients.
LogDestinationSpecifies the debug log destination.
LogDetailsSpecifies the debug log details to dump.
LogFileSpecifies the debug log filename.
LogFiltersSpecifies the debug log filters.
LogFlushModeSpecifies the log flush mode.
LogLevelSpecifies the debug log level.
LogMaxEventCountSpecifies the maximum number of events to cache before further action is taken.
LogRotationModeSpecifies the log rotation mode.
MaxASN1BufferLengthSpecifies the maximal allowed length for ASN.1 primitive tag data.
MaxASN1TreeDepthSpecifies the maximal depth for processed ASN.1 trees.
OCSPHashAlgorithmSpecifies the hash algorithm to be used to identify certificates in OCSP requests.
UseOwnDNSResolverSpecifies whether the client classes should use own DNS resolver.
UseSharedSystemStoragesSpecifies whether the validation engine should use a global per-process copy of the system certificate stores.
UseSystemOAEPAndPSSEnforces or disables the use of system-driven RSA OAEP and PSS computations.
UseSystemRandomEnables or disables the use of the OS PRNG.

Copyright (c) 2022 /n software inc. - All rights reserved.
SecureBlackbox 2020 iOS Edition - Version 20.0 [Build 8166]