Skip to main content

Upgrade Guide: POST users-srv/search/userlist Transition to POST user-srv/graph/users

This guide provides a structured overview of deprecated APIs/features and their replacements. It includes details on changes in Authorization, RequestBody, RequestPath, Response, and changes in Features. Follow this guide to ensure a seamless transition to the new versions <3.101.3>.

1. API Changes​

ttps://docs.cidaas.com/docs/cidaas-iam/5b3c6d6e1555f-find-users-using-filters https://docs.cidaas.com/docs/cidaas-iam/5b3c6d6e1555f-find-users-using-filters

1.1 Authorization Changes​

Deprecated:

  • Scope: cidaas:admin_read

Replacement:

  • Method: OAuth 2.0
  • Steps:
    1. Obtain a token from the /token-srv/token endpoint.
    2. Use the token in the header: Authorization: Bearer <access_token>
  • Scope: cidaas:users_search or cidaas:users_read

1.2 RequestBody Changes​

Deprecated:
Sending form-encoded data:

{
   "terms": ["john_doe"],
  "filters": {
    "fields": {
      "fieldkey": "email",
      "value": [
       "[email protected]"
      ]
    },
    "range": {
      "fieldkey": "createDate",
      "startRange": "2022-05-10",
      "endRange": "2023-09-10"
    },
    "groups": {
      "groupID": "CIDAAS_USERS",
      "roles": [
        "USER"
      ]
    }
  },
  "skip": 0,
  "take": 50
}

Replacement:
Use JSON structure:

{
  "terms": ["john_doe"],
  "from_value": "2022-05-10T14:15:22Z", //replacing range filter
  "to_value": "2023-09-10T14:15:22Z", //replacing range filter
  "rangefield": "createDate",//replacing range filter
  "fieldsFilter": [
    {
      "field": "email",
      "value": "[email protected]",
      "exactMatch": true
    }
  ],
  "groupsFilter": [ //replacing filters.groups
    {
      "groupId": "CIDAAS_USERS",
      "roles": [
        "USER"
      ],
      "rolesCondition": "and"
    }
  ],
  "from": 0,
  "size": 50,
}

2. Resources​