Documentation

IamUtil.pairLocalOpen()

DESCRIPTION

Perform Local Open pairing, requesting the specified username.

Local open pairing uses the trusted local network (LAN) pairing mechanism. No password is required for pairing and no invitation is needed, anybody on the LAN can initiate pairing.

This function blocks until it has succeeded.

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

DECLARATION

    public abstract void pairLocalOpen(Connection connection, String desiredUsername)

PARAMETERS

connection:
An established connection to the device this client should be paired with
desiredUsername:
Assign this username on the device if available (pairing fails with .USERNAME_EXISTS if not)

THROWS EXCEPTIONS

IamException:
with IamError USERNAME_EXISTS if desiredUsername is already in use on the device
IamException:
with IamError INVALID_INPUT if desiredUsername is not valid as per https://docs.nabto.com/developer/api-reference/coap/iam/post-users.html#request
IamException:
with IamError BLOCKED_BY_DEVICE_CONFIGURATION if the device configuration does not support local open pairing (the IAM:PairingLocalOpen action is not set for the Unpaired role or the device does not support the pairing mode at all)
IamException:
with IamError PAIRING_MODE_DISABLED if the pairing mode is configured on the device but is disabled at runtime
IamException:
with IamError IAM_NOT_SUPPORTED if Nabto Edge IAM is not supported by the device