SecureBlackbox Lite 2020 Kotlin Edition

Questions / Feedback?

ConnectionInfo Type

Contains information about a network connection.

Remarks

Use this property to check various details of the network connection. These include the total amounts of data transferred, the availability of TLS, and its parameters.

Fields

AEADCipher
Boolean

Indicates whether the encryption algorithm used is an AEAD cipher.

ChainValidationDetails
Int

The details of a certificate chain validation outcome. They may often suggest what reasons that contributed to the overall validation result.

Returns a bit mask of the following options:

cvrBadData0x0001One or more certificates in the validation path are malformed

cvrRevoked0x0002One or more certificates are revoked

cvrNotYetValid0x0004One or more certificates are not yet valid

cvrExpired0x0008One or more certificates are expired

cvrInvalidSignature0x0010A certificate contains a non-valid digital signature

cvrUnknownCA0x0020A CA certificate for one or more certificates has not been found (chain incomplete)

cvrCAUnauthorized0x0040One of the CA certificates are not authorized to act as CA

cvrCRLNotVerified0x0080One or more CRLs could not be verified

cvrOCSPNotVerified0x0100One or more OCSP responses could not be verified

cvrIdentityMismatch0x0200The identity protected by the certificate (a TLS endpoint or an e-mail addressee) does not match what is recorded in the certificate

cvrNoKeyUsage0x0400A mandatory key usage is not enabled in one of the chain certificates

cvrBlocked0x0800One or more certificates are blocked

cvrFailure0x1000General validation failure

cvrChainLoop0x2000Chain loop: one of the CA certificates recursively signs itself

cvrWeakAlgorithm0x4000A weak algorithm is used in one of certificates or revocation elements

cvrUserEnforced0x8000The chain was considered invalid following intervention from a user code

ChainValidationResult
ChainValidities

The outcome of a certificate chain validation routine.

Available options:

cvtValid0The chain is valid

cvtValidButUntrusted1The chain is valid, but the root certificate is not trusted

cvtInvalid2The chain is not valid (some of certificates are revoked, expired, or contain an invalid signature)

cvtCantBeEstablished3The validity of the chain cannot be established because of missing or unavailable validation information (certificates, CRLs, or OCSP responses)

Use the ValidationLog property to access the detailed validation log.

Ciphersuite
String?

The cipher suite employed by this connection.

For TLS connections, this property returns the ciphersuite that was/is employed by the connection.

ClientAuthenticated
Boolean

Specifies whether client authentication was performed during this connection.

ClientAuthRequested
Boolean

Specifies whether client authentication was requested during this connection.

ConnectionEstablished
Boolean

Indicates whether the connection has been established fully.

ConnectionID
ByteArray?

The unique identifier assigned to this connection.

DigestAlgorithm
String?

The digest algorithm used in a TLS-enabled connection.

EncryptionAlgorithm
String?

The symmetric encryption algorithm used in a TLS-enabled connection.

Exportable
Boolean

Indicates whether a TLS connection uses a reduced-strength exportable cipher.

KeyExchangeAlgorithm
String?

The key exchange algorithm used in a TLS-enabled connection.

KeyExchangeKeyBits
Int

The length of the key exchange key of a TLS-enabled connection.

NamedECCurve
String?

The elliptic curve used in this connection.

PFSCipher
Boolean

Indicates whether the chosen ciphersuite provides perfect forward secrecy (PFS).

PreSharedIdentityHint
String?

A hint professed by the server to help the client select the PSK identity to use.

PublicKeyBits
Int

The length of the public key.

ResumedSession
Boolean

Indicates whether a TLS-enabled connection was spawned from another TLS connection

SecureConnection
Boolean

Indicates whether TLS or SSL is enabled for this connection.

ServerAuthenticated
Boolean

Indicates whether server authentication was performed during a TLS-enabled connection.

SignatureAlgorithm
String?

The signature algorithm used in a TLS handshake.

SymmetricBlockSize
Int

The block size of the symmetric algorithm used.

SymmetricKeyBits
Int

The key length of the symmetric algorithm used.

TotalBytesReceived
Long

The total number of bytes received over this connection.

TotalBytesSent
Long

The total number of bytes sent over this connection.

ValidationLog
String?

Contains the server certificate's chain validation log. This information may be very useful in investigating chain validation failures.

Version
String?

Indicates the version of SSL/TLS protocol negotiated during this connection.

Constructors

public constructor()

Creates a new ConnectionInfo object.

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