📋 REL-ID SDK API: fetchRegisteredTOTPUsers

🧭 Overview

The fetchRegisteredTOTPUsers API is used to retrieve a list of users who have been registered and are eligible to use TOTP (Time-based One-Time Password) authentication. This is particularly useful in multi-user applications or offline-capable systems.

🎯 Purpose

• To check which users have TOTP provisioning available.
• To determine if TOTP can be used in offline or fallback authentication flows.
• To validate TOTP setup before generating a TOTP.

🔧 API: fetchRegisteredTOTPUsers()

📥 Parameters

• None

📤 Returns

• An array of user IDs registered for TOTP. These are users provisioned for TOTP on the device, usable for offline login or multi-user switching.

💻 Platform Usage Examples

RdnaClient.fetchRegisteredTOTPUsers((users) => {
  console.log("Registered TOTP users:", users);
});

rdnaClient.fetchRegisteredTOTPUsers().then((users) {
  print("TOTP users: $users");
});

com.uniken.rdnaplugin.RdnaClient.fetchRegisteredTOTPUsers(
  (users) => console.log(users),
  (err) => console.error("Error fetching users", err)
);

NSArray *users = [client fetchRegisteredTOTPUsers];

List<String> users = rdnaClient.fetchRegisteredTOTPUsers();

✅ On Success

• The list of eligible TOTP users is returned.
• App can show TOTP login or offline login options based on availability.

❌ On Failure

• SDK may return an empty list or error callback.
• App should handle fallback flows gracefully.