Skip to main content

SCIM System examples

Operations

List all

List all GroupUser.Systems.

Request
GET http://<your-domain>/soffid/webservice/scim2/v1/GroupUserSystem
Response 200 OK
{
    "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
    ],
    "totalResults": 25,16,
    "startIndex": 1,
    "Resources": [
        {
            "groupDescription"accessControl": false,
            "usersDomain": "Enterprise"DEFAULT",
            "fullReconciliation": false,
            "authoritative": false,
            "description": "Soffid system",
            "groups": "",
            "threads": 1,
            "className": "- no class -",
            "userTypes": "I",
            "groupsList": [],
            "readOnly": false,
            "passwordsDomain": "DEFAULT",
            "timeStamp": "2020-04-18 19:32:37",
            "rolebased": true,
            "trusted": false,
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/480412"System/44",
                "resourceType": "GroupUser"System"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.api.GroupUser"System"
            ],
            "start"name": "2020-07-02 12:14:48",
            "fullName": "test User",
            "disabled": false,
            "attributes": {}soffid",
            "id": 480412,44,
            "user"passwordsDomainId": 27,
            "tenant": "test2"master",
            "primaryGroup"generateTasksOnLoad": false,
            "group": "enterprise"true
        },
        {
            "groupDescription"accessControl": false,
            "usersDomain": "WorldDEFAULT",
            Modified""fullReconciliation": false,
            "authoritative": false,
            "description": "External SSO accounts",
            "groups": "admingroup,enterprise",
            "threads": 1,
            "className": "com.soffid.iam.sync.sso.agent.SSOAgent",
            "userTypes": "S,I",
            "groupsList": [
                "admingroup",
                "enterprise"
            ],
            "readOnly": false,
            "url": "local",
            "passwordsDomain": "DEFAULT",
            "timeStamp": "2020-09-21 10:17:38",
            "rolebased": false,
            "trusted": false,
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/503629"System/47",
                "resourceType": "GroupUser"System"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.api.GroupUser"System"
            ],
            "start"name": "2020-08-06 15:52:12",
            "fullName": "test User",
            "end": "2021-02-26 13:05:44",
            "disabled": true,
            "attributes": {}SSO",
            "id": 503629,47,
            "user"manualAccountCreation": true,
            "passwordsDomainId": 27,
            "tenant": "test2"master",
            "primaryGroup"generateTasksOnLoad": false,
            "group": "world2"true
        },
      {
            "groupDescription": "Enterprise Administrators Group",
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1182887",
                "resourceType": "GroupUser"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.api.GroupUser"
            ],
            "start": "2020-12-31 16:48:58",
            "fullName": "John Smith",
            "disabled": false,
            "attributes": {
                "comments": "This is a test",
                "startDate": "2021-01-01 00:00:00"
            },
            "id": 1182887,
            "user": "jsmith",
            "primaryGroup": false,
            "group": "admingroup"
        },
      ................
    ]
}

List by filter

List all GroupUsersSystems with a filter expression.

It is allowed to use pagination and sort the information, for more information visit the Sorting and Pagination information.

Request

List all GroupUserSystems with a filter expression.

GET http://<your-domain>/soffid/webservice/scim2/v1/GroupUser?System?filter=groupDescriptiondescription eqco "World Modified"10.129.
Response 200 OK
{
    "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
    ],
    "totalResults": 4,2,
    "startIndex": 1,
    "Resources": [
        {
            "groupDescription"accessControl": false,
            "description": "WorldDiscovered Modified"host 10.129.122.22",
            "className": "com.soffid.iam.sync.agent.SimpleSSHAgent",
            "userTypes": "",
            "passwordsDomain": "DEFAULT",
            "rolebased": false,
            "id": 1885153,
            "manualAccountCreation": true,
            "tenant": "master",
            "generateTasksOnLoad": false,
            "param7": "false",
            "usersDomain": "DEFAULT",
            "param6": "UTF-8",
            "fullReconciliation": true,
            "authoritative": false,
            "sharedDispatcher": true,
            "param0": "soffid",
            "groups": "",
            "threads": 1,
            "groupsList": [],
            "readOnly": false,
            "param3": "10.129.122.22",
            "param4": "true",
            "url": "local",
            "param2": "517y1hF40k4=",
            "timeStamp": "2021-04-23 12:23:15",
            "trusted": false,
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/503629"System/1885153",
                "resourceType": "GroupUser"System"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.api.GroupUser"System"
            ],
            "start"name": "2020-08-06 15:52:12"10.129.122.22",
            "fullName"passwordsDomainId": "test User",
            "end": "2021-02-26 13:05:44",
            "disabled": true,
            "attributes": {},
            "id": 503629,
            "user": "test2",
            "primaryGroup": false,
            "group": "world2"27
        },
        {
            "groupDescription"accessControl": false,
            "description": "WorldDiscovered Modified"host 10.129.122.25",
            "className": "com.soffid.iam.sync.agent.SimpleWindowsAgent",
            "userTypes": "",
            "passwordsDomain": "DEFAULT",
            "rolebased": false,
            "id": 1890334,
            "manualAccountCreation": true,
            "tenant": "master",
            "generateTasksOnLoad": false,
            "param7": "false",
            "usersDomain": "DEFAULT",
            "fullReconciliation": true,
            "authoritative": false,
            "sharedDispatcher": true,
            "param0": "Administrador",
            "groups": "",
            "threads": 1,
            "groupsList": [],
            "readOnly": false,
            "param3": "10.129.122.25",
            "param4": "true",
            "url": "local",
            "param2": "VFJV1pSRfE7s",
            "timeStamp": "2021-04-23 20:00:34",
            "trusted": false,
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1519730"System/1890334",
                "resourceType": "GroupUser"System"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.api.GroupUser"System"
            ],
            "start"name": "2021-02-20 18:08:23"10.129.122.25",
            "fullName"passwordsDomainId": "Dilbert ADAMS .",
            "end": "2021-02-20 19:07:45",
            "disabled": true,
            "attributes": {},
            "id": 1519730,
            "user": "dilbert",
            "primaryGroup": false,
            "group": "world2"
        },
        {
            "groupDescription": "World Modified",
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1521501",
                "resourceType": "GroupUser"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.api.GroupUser"
            ],
            "start": "2021-02-20 20:21:06",
            "fullName": "Dilbert ADAMS .",
            "disabled": false,
            "attributes": {},
            "id": 1521501,
            "user": "dilbert",
            "primaryGroup": false,
            "group": "world2"
        },
        {
            "groupDescription": "World Modified",
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1558480",
                "resourceType": "GroupUser"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.api.GroupUser"
            ],
            "start": "2021-02-26 13:06:24",
            "fullName": "test User",
            "disabled": false,
            "attributes": {},
            "id": 1558480,
            "user": "test2",
            "primaryGroup": false,
            "group": "world2"27
        }
    ]
}

Query by id

Query a GroupUserSystem by its id (primary key). 

Request
GET http://<your-domain>/soffid/webservice/scim2/v1/GroupUser/1974296System/389082
Response 200 OK
{
    "groupDescription"accessControl": true,
    "description": "HelpActive deskDirectory.",
    support"className": team""com.soffid.iam.sync.agent2.CustomizableActiveDirectoryAgent",
    "userTypes": "I",
    "passwordsDomain": "DEFAULT",
    "rolebased": true,
    "id": 389082,
    "manualAccountCreation": false,
    "tenant": "master",
    "generateTasksOnLoad": true,
    "param7": "true",
    "param8": "true",
    "usersDomain": "DEFAULT",
    "fullReconciliation": false,
    "authoritative": true,
    "sharedDispatcher": false,
    "param0": "ad.bubu.lab",
    "groups": "",
    "threads": 1,
    "groupsList": [],
    "readOnly": false,
    "param3": "C27Nv4vjbIsI",
    "url": "https://soffid.bubu.lab:1760/",
    "param1": "dc=ad,dc=bubu,dc=lab",
    "param2": "ad\\Administrator",
    "timeStamp": "2021-04-07 09:31:59",
    "trusted": true,
    "meta": {
        "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1974296"System/389082",
        "resourceType": "GroupUser"System"
    },
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"System"
    ],
    "start"name": "2021-05-05 12:49:51"ad",
    "fullName"passwordsDomainId": "John Smith",
    "disabled": false,
    "attributes": {
        "startDate": "2021-05-04 00:00:00"
    },
    "id": 1974296,
    "user": "jsmith",
    "primaryGroup": false,
    "group": "it"27
}

Create

To create a GroupUser.System.

Request

POST http://<your-domain>/soffid/webservice/scim2/v1/GroupUserSystem

JSON

{
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"System"
    ],
    "group"name": "it"SQLRRHH",
    "groupDescription"description": "HelpSQL deskRRHH support team"test",
    "user"className": "ckelp"com.soffid.iam.sync.agent.SQLAgent2",
    "fullName"userTypes": "Casey Kelp"E,I",
    "primaryGroup"passwordsDomain": true,"DEFAULT",
    "attributes"usersDomain": {}"DEFAULT"
}
Response 201 Created
{
    "groupDescription"accessControl": false,
    "usersDomain": "HelpDEFAULT",
    desk"fullReconciliation": supportfalse,
    team""authoritative": false,
    "description": "SQL RRHH test",
    "groups": "",
    "threads": 1,
    "className": "com.soffid.iam.sync.agent.SQLAgent2",
    "userTypes": "I,E",
    "groupsList": [],
    "readOnly": false,
    "passwordsDomain": "DEFAULT",
    "timeStamp": "2021-05-12 10:58:35",
    "rolebased": false,
    "trusted": false,
    "meta": {
        "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1976741"System/1977157",
        "resourceType": "GroupUser"System"
    },
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"System"
    ],
    "start"name": "2021-05-11 10:39:23",
    "fullName": "Casey Kelp",
    "disabled": false,
    "attributes": {}SQLRRHH",
    "id": 1976741,1977157,
    "user"passwordsDomainId": 27,
    "tenant": "ckelp"master",
    "primaryGroup"generateTasksOnLoad": true,
    "group": "it"false
}

Update partial

Update only of the attributes with changes, only these atrributes will be updated, the rest will maintain the same value.

Request
PATCH http://<your-domain>/soffid/webservice/scim2/v1/GroupUser/1976741System/1977157

JSON

{
    "Operations": [
        {
            "op": "replace",
            "path": "groupDescription"param0",
            "value": "Enterprise engineering team"user"
        },
        {
            "op": "replace",
            "path": "group"param1",
            "value": "EngineeringTeam"password"
        },
        {
            "op": "replace",
            "path": "param2",
            "value": "jdbc:mysql://localhost/personal"
        }
    ]
}
Response 200 OK
{
    "groupDescription"accessControl": false,
    "description": "EnterpriseSQL engineeringRRHH team"test",
    "className": "com.soffid.iam.sync.agent.SQLAgent2",
    "userTypes": "I,E",
    "passwordsDomain": "DEFAULT",
    "rolebased": false,
    "id": 1977157,
    "tenant": "master",
    "generateTasksOnLoad": false,
    "usersDomain": "DEFAULT",
    "fullReconciliation": false,
    "authoritative": false,
    "param0": "user",
    "groups": "",
    "threads": 1,
    "groupsList": [],
    "readOnly": false,
    "param1": "password",
    "param2": "jdbc:mysql://localhost/personal",
    "timeStamp": "2021-05-12 10:59:44",
    "trusted": false,
    "meta": {
        "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1976741"System/1977157",
        "resourceType": "GroupUser"System"
    },
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"System"
    ],
    "start"name": "2021-05-11 10:39:23"SQLRRHH",
    "fullName"passwordsDomainId": "Casey Kelp",
    "disabled": false,
    "attributes": {},
    "id": 1976741,
    "user": "ckelp",
    "primaryGroup": true,
    "group": "EngineeringTeam"27
}

Update all

This operation replace all values in the GroupUser.System.

  • Note that the attribute id is required to confirm that the resource "...GroupUser/System/<id>" is the same that the JSON GroupUser.System.
  • Note that all the attributes not included in the request will be cleared in the GroupUserSystem type and their data will be lost.
  • Note that not all the attributes are updatable, for example tag meta, avoid these tags. For more information seevisit Resource data model page
Request
PUT http://<your-domain>/soffid/webservice/scim2/v1/GroupUser/1976741System/1977157

JSON

{
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"System"
    ],
    "id": 1976741,1977157,
    "group"name": "it"SQLRRHH",
    "groupDescription"description": "HelpSQL deskRRHH support team"test",
    "user"className": "ckelp"com.soffid.iam.sync.agent.SQLAgent2",
    "fullName"userTypes": "Casey Kelp"E,I",
    "primaryGroup"passwordsDomain": true,"DEFAULT",
    "attributes"usersDomain": {}"DEFAULT"
}
Response 200 OK
{
    "groupDescription"accessControl": false,
    "usersDomain": "HelpDEFAULT",
    desk"fullReconciliation": supportfalse,
    team""authoritative": false,
    "description": "SQL RRHH test",
    "groups": "",
    "threads": 1,
    "className": "com.soffid.iam.sync.agent.SQLAgent2",
    "userTypes": "I,E",
    "groupsList": [],
    "readOnly": false,
    "passwordsDomain": "DEFAULT",
    "timeStamp": "2021-05-12 11:02:49",
    "rolebased": false,
    "trusted": false,
    "meta": {
        "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1976741"System/1977157",
        "resourceType": "GroupUser"System"
    },
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"System"
    ],
    "fullName"name": "Casey Kelp",
    "disabled": false,
    "attributes": {}SQLRRHH",
    "id": 1976741,1977157,
    "user"passwordsDomainId": 27,
    "tenant": "ckelp"master",
    "primaryGroup"generateTasksOnLoad": true,
    "group": "it"false
}

Delete

Delete a role.System.

Please note after this delete, the accountSystem has to be created again to use it in the next examples.

Request
DELETE http://<your-omain>/soffid/webservice/scim2/v1/GroupUser/1976741System/1977157
Response 204 No Content
204 No Content

Error response

For more infomationinformation about error response visit https://bookstack.soffid.com/link/116#bkmrk-error-response

 

Back to top