Skip to main content

SCIM VaultFolder examples

Operations

This page shows the operations that can be performed for the VaultFolder object

List all

Request
GET http://<your-domain>/soffid/webservice/scim2/v1/GroupUserVaultFolder/
Response 200 OK
{
    "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
    ],
    "totalResults": 25,4,
    "startIndex": 1,
    "Resources": [
        {
            "groupDescription"grantedRoles": [],
            "accessLevel": "Enterprise"O",
            "managerRoles": [],
            "navigateUsers": [],
            "navigateRoles": [],
            "description": "Accounts that won't be shared",
            "personal": true,
            "ownerGroups": [],
            "ownerRoles": [],
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/480412"VaultFolder/368461",
                "resourceType": "GroupUser"VaultFolder"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.api.GroupUser"VaultFolder"
            ],
            "start"name": "2020-07-02Personal 12:14:48"accounts",
            "fullName"managerUsers": "test User"[],
            "disabled"navigateGroups": false,
            "attributes": {}[],
            "id": 480412,368461,
            "user"grantedGroups": "test2"[],
            "primaryGroup"managerGroups": false,[],
            "group"grantedUsers": [],
            "enterprise"ownerUsers": [
                "admin"
            ]
        },
        {
            "groupDescription"grantedRoles": [],
            "accessLevel": "WorldO",
            Modified""managerRoles": [],
            "navigateUsers": [
                "test2",
                "admin"
            ],
            "navigateRoles": [],
            "description": "Password vault",
            "personal": false,
            "ownerGroups": [],
            "ownerRoles": [],
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/503629"VaultFolder/515461",
                "resourceType": "GroupUser"VaultFolder"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.api.GroupUser"VaultFolder"
            ],
            "start"name": "2020-08-06 15:52:12"vault",
            "fullName"managerUsers": "test User"[],
            "end"navigateGroups": "2021-02-26 13:05:44",
            "disabled": true,
            "attributes": {}[],
            "id": 503629,515461,
            "user"grantedGroups": "test2"[],
            "primaryGroup"managerGroups": false,
            "group": "world2"
        },
        {
            "groupDescription": "Enterprise Administrators Group"[],
            "meta"grantedUsers": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1182887"[],
            "resourceType": "GroupUser"
            },
            "schemas"ownerUsers": [
                "urn:soffid:com.soffid.iam.api.GroupUser"admin"
            ],
            "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 VaultFolders with a filter expression.

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

Request
GET http://<your-domain>/soffid/webservice/scim2/v1/GroupUser?VaultFolder/?filter=groupDescriptionpersonal eq "World Modified"true
Response 200 OK
{
    "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
    ],
    "totalResults": 4,1,
    "startIndex": 1,
    "Resources": [
        {
            "groupDescription"grantedRoles": [],
            "accessLevel": "WorldO",
            Modified""managerRoles": [],
            "navigateUsers": [],
            "navigateRoles": [],
            "description": "Accounts that won't be shared",
            "personal": true,
            "ownerGroups": [],
            "ownerRoles": [],
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/503629"VaultFolder/368461",
                "resourceType": "GroupUser"VaultFolder"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.api.GroupUser"VaultFolder"
            ],
            "start"name": "2020-08-06Personal 15:52:12"accounts",
            "fullName"managerUsers": "test User"[],
            "end"navigateGroups": "2021-02-26 13:05:44",
            "disabled": true,
            "attributes": {}[],
            "id": 503629,368461,
            "user"grantedGroups": "test2"[],
            "primaryGroup"managerGroups": false,
            "group": "world2"
        },
        {
            "groupDescription": "World Modified"[],
            "meta"grantedUsers": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1519730"[],
            "resourceType": "GroupUser"
            },
            "schemas"ownerUsers": [
                "urn:soffid:com.soffid.iam.api.GroupUser"admin"
            ],
            "start": "2021-02-20 18:08:23",
            "fullName": "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"
        }
    ]
}

Query by id

Query a VaultFolder by its id (primary key). 

Request
GET http://<your-domain>/soffid/webservice/scim2/v1/GroupUser/1974296VaultFolder/515461
Response 200 OK
{
    "groupDescription"grantedRoles": [],
    "accessLevel": "HelpO",
    desk"managerRoles": support[],
    team""navigateUsers": [
        "test2",
        "admin"
    ],
    "navigateRoles": [],
    "description": "Password vault",
    "personal": false,
    "ownerGroups": [],
    "ownerRoles": [],
    "meta": {
        "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1974296"VaultFolder/515461",
        "resourceType": "GroupUser"VaultFolder"
    },
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"VaultFolder"
    ],
    "start"name": "2021-05-05 12:49:51"vault",
    "fullName"managerUsers": "John Smith"[],
    "disabled"navigateGroups": false,
    "attributes": {
        "startDate": "2021-05-04 00:00:00"
    }[],
    "id": 1974296,515461,
    "user"grantedGroups": "jsmith"[],
    "primaryGroup"managerGroups": false,[],
    "group"grantedUsers": [],
    "it"ownerUsers": [
        "admin"
    ]
}

Create

Request

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

JSON

{
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"
    ],
    "group": "it",
    "groupDescription": "Help desk support team",
    "user": "ckelp",
    "fullName": "Casey Kelp",
    "primaryGroup": true,
    "attributes": {}
}
Response 201 Created
{
    "groupDescription": "Help desk support team",
    "meta": {
        "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1976741",
        "resourceType": "GroupUser"
    },
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"
    ],
    "start": "2021-05-11 10:39:23",
    "fullName": "Casey Kelp",
    "disabled": false,
    "attributes": {},
    "id": 1976741,
    "user": "ckelp",
    "primaryGroup": true,
    "group": "it"
}

Update partial

Only attributes with changes will be updated, the other will maintain the same value.

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

JSON

{
    "Operations": [
        {
            "op": "replace",
            "path": "groupDescription",
            "value": "Enterprise engineering team"
        },
        {
            "op": "replace",
            "path": "group",
            "value": "EngineeringTeam"
        }
    ]
}
Response 200 OK
{
    "groupDescription": "Enterprise engineering team",
    "meta": {
        "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1976741",
        "resourceType": "GroupUser"
    },
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"
    ],
    "start": "2021-05-11 10:39:23",
    "fullName": "Casey Kelp",
    "disabled": false,
    "attributes": {},
    "id": 1976741,
    "user": "ckelp",
    "primaryGroup": true,
    "group": "EngineeringTeam"
}

Update all

This operation replaces all values in the VaultFolder.

  • Note that the attribute id is required to confirm that the resource "...VaultFolder/<id>" is the same that the JSON VaultFolder.
  • Note that all the attributes not included in the request will be cleared in the GroupUser 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 visit Resource data model page
Request
PUT http://<your-domain>/soffid/webservice/scim2/v1/GroupUser/1976741

JSON

{
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"
    ],
    "id": 1976741,
    "group": "it",
    "groupDescription": "Help desk support team",
     "user": "ckelp",
    "fullName": "Casey Kelp",
    "primaryGroup": true,
    "attributes": {}
}
Response 200 OK
{
    "groupDescription": "Help desk support team",
    "meta": {
        "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1976741",
        "resourceType": "GroupUser"
    },
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"
    ],
    "fullName": "Casey Kelp",
    "disabled": false,
    "attributes": {},
    "id": 1976741,
    "user": "ckelp",
    "primaryGroup": true,
    "group": "it"
}

Delete

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

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

Error response

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

 

Back to top