You're viewing OCI IAM documentation for new tenancies in regions that have been updated to use identity domains.

User Device Baselining

Enable this feature to automatically baseline a user's device the first time they sign in to OCI.

The first time a user signs in to OCI a baseline is created for the user's device. When a user signs in from this device, they don't receive an email notification. If a user accesses their account using an unknown device, then the user receives an email notifying them that a new device was used to sign in to their account.

Enabling Device Baselining

To enable device baselining:
  1. Enable Adaptive Security, see Activating Adaptive Security.
  2. Enable deviceBaseliningEnabled flag in SsoSettings.
    PUT /admin/v1/SsoSettings/SsoSettings
    Note

    Include the following attribute in the body of the API command: deviceBaseliningEnabled = true

Getting the Baseline Status of a Device

The tenant administrator can use the following endpoint to retrieve the device details associated with a user:
POST /admin/v1/UserDevices?attributeSets=all&filter=owner.userName eq "{{UserName of the user}}" 
isBaselined: If the value of this attribute is true, then this particular device is baselined for the user. Sample response:
         {
           "owner": {
               "value": "bacxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
               "userName": "user@abccorp.com",
               "display": "user abc"
           },
           "id": "blcxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
           "isBaselined": true,
           "deviceType": "Mac",
           "verified": true,
           "deviceFingerPrint": "cn2ayxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
           "dfp": "36bacesaxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
           "schemas": [
               "urn:ietf:params:scim:schemas:oracle:idcs:UserDevice"
           ]
       }

Deleting a User Device

To delete a user device, use the following endpoint:
DELETE /admin/v1/UserDevices/{{id}}

Was this article helpful?