createOnlinePresentationSession

@Blocking
fun createOnlinePresentationSession(authorizationRequestUri: String, authenticationOption: AuthenticationOption = AuthenticationOption.Signature, requireTrustedVerifier: Boolean = false): OnlinePresentationSession

Create an online presentation session compliant with the ISO 18013-7 and OpenID4VP.

If Activity Log writes are enabled for this instance, the returned session records Activity Log entries for online presentations when presentations occur in that session. Activity Log storage is not accessed during session creation - it is accessed later when a presentation is performed, and failures to open or write may cause the presentation call to fail.

Return

OnlinePresentationSession.

Parameters

authorizationRequestUri

Authorization Request URI (request_uri parameter), defined in authorizationRequestUri See also: ISO 18013-7, section B.4.2.2.

authenticationOption

Device authentication option to be used for mDocs which are presented in the established session.

requireTrustedVerifier

Controls the signed request object validation strategy. When set to true, the signed request object (represented as a JWT), retrieved from the authorizationRequestUri, can only be validated using stored verifier certificates. When set to false (default), verification is first attempted using stored verifier certificates. If it fails, the client's metadata is resolved and the JWKs from this metadata are used to validate the signed request object.

Throws

If the SDK API is called before the SDK is initialized.

If the authorization request URI is invalid.

If there is a connectivity issue while requesting the authorization object.

If the response mode is not supported.

If any error occurs during the verification process.

If the algorithm is not supported.

If the Activity Log storage cannot be opened or initialized.

If reading or mapping activity log entries fails for any other reason.