Unsuccessful Registration of the RSA Authenticator app for iOS or Android with a registration code from the Cloud Administration Retrieve Device Registration Code API
2 years ago
Originally Published: 2022-09-09
Article Number
000067958
Applies To
RSA Product Set: RSA ID Plus
RSA Product/Service Type: Cloud Authentication Service
RSA Product/Service Type: Cloud Administration Retrieve Device Registration Code API
RSA Product/Service Type: RSA Authenticator app for iOS and Android
RSA Version/Condition: all
Issue

The user attempts to register their RSA Authenticator app with a Registration Code returned by the Cloud Administration Retrieve Device Registration Code API .

However, registration fails with the error message:

Unsuccessful Registration
Confirm that you have correctly
entered the Organization ID, Email
Address and Registration Code.


image.png

 

Cause

A working registration code can be obtained for the RSA Authenticator app for Windows or for RSA Authenticator app for MacOS by sending a Cloud Administration Retrieve Device Registration Code API request containing only the user's email address, e.g. 

{

"email": "user@example.com"

}

That also previously worked to obtain a registration code for the RSA Authenticate App for IOS and Android (registration of that app is now no longer supported ).

However, the registration code returned from such a request will not work with the RSA Authenticator app for iOS and Android .  Retrieval of a registration code for the iOS and Android app requires the appid parameter to be specified in the API request with the value 1f00c62b-a5c0-49d3-9ffb-92314d717187 .

Resolution

Include the appid parameter in any Cloud Administration Retrieve Device Registration Code API request for the RSA Authenticator app for iOS or Android, as shown in the example below:
 

{

"email": "user@example.com",

"appId":"1f00c62b-a5c0-49d3-9ffb-92314d717187"

}

See also section "Example Request Body" on page Cloud Administration Retrieve Device Registration Code API which explains correct appid usage for each type of RSA Authenticator app.

Notes

The "Unsuccessful Registration" error message can also be displayed for other reasons. If the Cloud Administration Retrieve Device Registration Code API request is being sent with correct appid usage, check for other possible causes.   

General app registration troubleshooting tips are in section "Authenticator Registration" on page Troubleshooting Cloud Authentication Service User Issues .