addNewDeviceOptions

🧭 Overview

The addNewDeviceOptions event is triggered when a user attempts to log in from a new device. It is part of the additional device activation flow. The event provides the developer with information on how the device can be authenticated, such as via REL-ID Verify Notification.

🎯 Purpose

To prompt the developer to show a screen informing the user about device activation.
To give the user a way to approve or deny device activation.
If approved, call performVerifyAuth(true) to complete the activation.
If denied, call performVerifyAuth(false) or fallback using fallbackNewDeviceActivationFlow().

🖥️ UI Screen Requirements

Present a screen showing:

📱 Device activation method: "REL-ID Verify Authentication".
🛡️ Description and response label (from challengeInfo).
✅ "Yes, activate this device" → call performVerifyAuth(true)
❌ "No, do not activate" → call performVerifyAuth(false) or fallbackNewDeviceActivationFlow()

📩 Sample Event Payload

{
  "userID": "testuser",
  "newDeviceOptions": ["REL-ID Verify Authentication"],
  "challengeInfo": [
    {
      "key": "Response label",
      "value": "REL-ID Verify notification will be sent on all your registered device(s). Approve it to activate this device."
    },
    {
      "key": "description",
      "value": "You will have to provide additional authentication data registered with Enterprise to activate this device."
    },
    { "key": "SDK_CHLNG", "value": "NO" },
    { "key": "SDK_CHLNG_MODE", "value": "NA" },
    { "key": "AUTO_ANSWER", "value": "true" }
  ]
}

💻 Code Snippets

React Native

let addNewDeviceOptionsSubscription = rdnaEventRegistery.addListener(
  'addNewDeviceOptions',
  this.addNewDeviceOptions.bind(this)
);

RdnaClient.performVerifyAuth(true, (syncResponse) => {
  console.log("Device activation approved.");
});

Flutter

rdnaClient.on(RdnaClient.addNewDeviceOptions, (response) {
  print("Device activation option:", response);
});

rdnaClient.performVerifyAuth(true);

Cordova

document.addEventListener('addNewDeviceOptions', function(event) {
  console.log("Received device auth event:", event);
});

com.uniken.rdnaplugin.RdnaClient.performVerifyAuth(
  () => console.log("Approved"),
  (err) => console.error("Error", err),
  [true]
);

Native Android

void addNewDeviceOptions(String userID, String[] arrOfOptions, HashMap<String, String> info) {
    // Show UI with challengeInfo data
}
RDNAError error = rdna.performVerifyAuth(true);

Native iOS

- (void)addNewDeviceOptions:(NSString *)userID options:(NSArray<NSString *> *)options info:(NSArray<RDNAChallengeInfo *> *)info {
    // Show UI with options and info content
}
[client performVerifyAuth:YES];

❗ Error Handling

Updated 3 months ago