Step 1: Initiate PUSH Enrollment
POST {{HOST}}/admin/v1/MyAuthenticationFactorEnroller
Prerequisites for this step: - Use the 'Obtain ME access_token' to obtain a valid access token. - Use 'Get my information' to obtain the user 'id' value.
In the request, the client must pass the following attributes:
- value: the id of the user returned in 'Get My Information'
In the response, the deviceId and requestId are passed in the next step. The value for qrCodeContent
should be decoded using a base64 decoder:
https://www.base64decode.org/
The decoded string should then be entered in a QR Code Generator: https://www.the-qrcode-generator.com/
Scan the QR code generated with an authenticator such as Oracle Mobile Authenticator.
As this is a PUSH enrollment, enrollment happens automatically.
Request Body
{"schemas"=>["urn:ietf:params:scim:schemas:oracle:idcs:AuthenticationFactorEnroller"], "user"=>{"value"=>"c810ff4522eb437abac013291c1984d1"}, "authnFactors"=>["PUSH"]}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Authorization | string |
RESPONSES
status: Created
{"schemas":["urn:ietf:params:scim:schemas:oracle:idcs:AuthenticationFactorEnroller"],"user":{"value":"c810ff4522eb437abac013291c1984d1","$ref":"https://example.identitycloud.com/admin/v1/Users/c810ff4522eb437abac013291c1984d1"},"authnFactors":["PUSH","TOTP"],"isDeviceOffline":false,"meta":{"resourceType":"MyAuthenticationFactorEnroller","location":"https://example.identitycloud.com/admin/v1/MyAuthenticationFactorEnroller"},"deviceId":"8bb96b4302eb40b2916079b3f597b077","displayName":"Joe's Phone","requestId":"7d988fb0-fe10-458d-aaba-0cb1230bfc25","qrCodeImgContent":"aVZCT1J3MEtHZ29BQUFBTlNVaEVVZ0FBQVN3QU...........RHLzZyOU8wcnF3a0YrNnBBQUFBQUJKUlU1RXJrSmdnZz09","qrCodeContent":"b3JhY2xlbW9iaWxlYXV0aGVudGljYXRvcjovL3RvdH...........VU0gmS2V5UGFpckxlbmd0aD0yMDQ4JlNTRT1CYXNlMzI=","qrCodeImgType":"PNG"}