onDeviceAuthManagementStatus

🔄 REL-ID SDK Event: `onDeviceAuthManagementStatus`

📋 Description

The onDeviceAuthManagementStatus event is triggered after the app calls the manageDeviceAuthenticationModes() API to enable or disable a Local Device Authentication (LDA) type. This event reports the result of that operation, including the user, the LDA type involved, and whether the action was successful.

📤 Sample Payload

{
  "userID": "testuser",
  "OpMode": 1,
  "ldaType": 9,
  "status": {
    "statusCode": 100,
    "statusMessage": "Success"
  },
  "error": {
    "longErrorCode": 0,
    "shortErrorCode": 0,
    "errorString": "Success"
  }
}

🧾 Response Fields

Field	Type	Description
`userID`	String	User for whom the LDA mode was managed
`OpMode`	Integer	Indicates the operation mode: `1` = Enable, `0` = Disable
`ldaType`	Integer	The LDA type affected (same as in API call)
`status`	Object	Contains `statusCode` and `statusMessage` for the request outcome
`error`	Object	Contains `longErrorCode`, `shortErrorCode`, and `errorString`

🧠 Notes

OpMode and ldaType reflect the parameters used in the manageDeviceAuthenticationModes() API call.
Success is indicated when statusCode = 100 and error.longErrorCode = 0.
Errors typically relate to configuration issues or platform constraints.

💻 Platform Usage

React Native

rdnaEventRegistery.addListener(
  "onDeviceAuthManagementStatus",
  (response) => {
    console.log("Auth Management Status:", response);
  }
);

Flutter

rdnaClient.on(RdnaClient.onDeviceAuthManagementStatus, (response) {
  print("LDA Status: ${response.status.statusMessage}");
});

Cordova

document.addEventListener(
  "onDeviceAuthManagementStatus",
  function (event) {
    console.log("LDA Status: ", event);
  },
  false
);

iOS (Objective-C)

- (void)onDeviceAuthManagementStatus:(NSString *)userID
                 isAuthTypeEnabled:(BOOL)isAuthTypeEnabled
             authenticationType:(RDNALDACapabilities)authenticationType
                         status:(RDNARequestStatus *)status
                          error:(RDNAError *)error;

Android

void onDeviceAuthManagementStatus(String userID,
                                  boolean isAuthTypeEnabled,
                                  RDNALDACapability authType,
                                  RDNARequestStatus requestStatus,
                                  RDNAError error);

Updated 2 months ago