- Bookmark applications
- Okta Administrator
- Okta API
Currently, the Okta admin GUI does not allow the updating of the app username for a bookmark app.
The bookmark app does not require any credentials (username or password) due to the fact that no authentication occurs when launching an Okta bookmark app.
For full details, please read: Unable to update 'Okta user name format' configuration of Bookmark App.
The only way to achieve this is by making an Okta API call. Follow the steps or video below.
- Obtain the target bookmark app's application Id via Okta Admin Dashboard, navigate to the target bookmark app, and extract the application instance id from the Address URL. We will need the application Id value for steps 2 and step 3.
Or alternatively, use the List Application API call and extract the target bookmark app ID.
GET/api/v1/apps
For full documentation and example, please read: List Application - List all app users assigned to the bookmark app and extract the target user id. We will need the target user id for step 3.
GET/api/v1/apps/${applicationId}/users
For full documentation and example, please read: List users assigned to an application - Update the target user's app username for the target bookmark app with the application Id extracted from Step 1 and the user id extracted from Step 2.
POST/api/v1/apps/${applicationId}/users/${userId}
{
"credentials": {
"userName": "newUpdatedAppUsername@example.com"
}
For full documentation and example, please read: Update application credentials for assigned user
Please find below a sample Okta API call to update the bookmark app,curl -v -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: SSWS ${api_token}" \
-d '{
"credentials": {
"userName": "updatedAppUsername@example.com"
}
}' "https://${yourOktaDomain}/api/v1/apps/${yourbookmarkAppId}/users/${your OktaUserId}"
Additional Notes!
- Any REST API client can be used to run the Okta API calls. Below are a few popular free REST API tools or browser add-ons that can be used to run Okta API calls:
- For Questions about how to set up a REST API client (such as Postman or Curl) to run Okta API calls, please reach out to the corresponding product vendor/owner for further assistance, as Okta does not own those products.
