Kotlin: IamUtil.awaitPairLocalInitial()

DESCRIPTION

Perform Local Initial pairing, assigning the default initial username configured on the device (typically “admin”).

In this mode, the initial user can be paired on the local network without providing a username or password - and only the initial user. This is a typical bootstrap scenario to pair the admin user (device owner).

This function is meant to be used in a Kotlin coroutine to suspend execution until the operation has completed.

Read more here: https://docs.nabto.com/developer/guides/iam/pairing.html#initial-local

DECLARATION

suspend fun IamUtil.awaitPairLocalInitial(
    connection: Connection,
) 

PARAMETERS

connection:

An established connection to the device this client should be paired with

THROWS EXCEPTIONS

INITIAL_USER_ALREADY_PAIRED:

if the initial user was already paired

BLOCKED_BY_DEVICE_CONFIGURATION:

if the device configuration does not support local open pairing (the IAM:PairingLocalInitial action is not set for the Unpaired role or the device does not support the pairing mode at all)

PAIRING_MODE_DISABLED:

if the pairing mode is configured on the device but is disabled at runtime.

IAM_NOT_SUPPORTED:

if Nabto Edge IAM is not supported by the device