EdhocInitiatorConfig

class EdhocInitiatorConfig(val method: EdhocMethod, cipherSuites: List<CipherSuite>, credentials: List<LocalCredential>, val credentialResolver: CredentialResolver, val connectionIdentifiers: ConnectionIdentifierProvider = ConnectionIdentifierProvider.Random, val eadHandler: EadHandler = EadHandler.None, val ephemeralKeys: EphemeralKeySource = EphemeralKeySource.Random, val initialCipherSuite: CipherSuite? = null)(source)

The application profile (RFC 9528 §3.9) of an EdhocInitiator.

Constructors

Link copied to clipboard
constructor(method: EdhocMethod, cipherSuites: List<CipherSuite>, credentials: List<LocalCredential>, credentialResolver: CredentialResolver, connectionIdentifiers: ConnectionIdentifierProvider = ConnectionIdentifierProvider.Random, eadHandler: EadHandler = EadHandler.None, ephemeralKeys: EphemeralKeySource = EphemeralKeySource.Random, initialCipherSuite: CipherSuite? = null)

Properties

Link copied to clipboard

the supported suites in order of preference, most preferred first. Only those the crypto backend runs (CipherSuite.isSupportedBy) are offered, and the order is fixed: SUITES_I is always a prefix of them (RFC 9528 §5.2.2). supportedBy narrows the list to them up front.

Link copied to clipboard

chooses C_I, once per message_1.

Link copied to clipboard

resolves and authorizes ID_CRED_R.

Link copied to clipboard

own credentials; the first one usable for the method and the selected suite is used. A suite without a usable credential can still be listed, but a session that selects it fails when message_3 is created.

Link copied to clipboard
Link copied to clipboard

source of X; fresh random keys unless replaying test vectors.

Link copied to clipboard

the suite to select in the first message_1, for example one remembered from an earlier session with this Responder (RFC 9528 §6.3.1); by default the most preferred one the crypto backend runs.

Link copied to clipboard

the authentication method; the Initiator decides it alone (RFC 9528 §3.2).

Functions

Link copied to clipboard

This configuration with only the cipher suites crypto runs for method, in the same order of preference (CipherSuite.isSupportedBy, docs/adr/0001-crypto-capabilities.md). EdhocInitiator makes the same choice, asking the backend once per configuration and remembering the answers, which the returned configuration keeps for crypto. Calling this once where the configuration is set up finds a backend that cannot run it before any session starts, and shows what will be offered.