Skip to content

Latest commit

 

History

History
121 lines (83 loc) · 5.17 KB

check-group-membership.md

File metadata and controls

121 lines (83 loc) · 5.17 KB
description
Checks users membership within a group

Check a group has a user member

A group can be checked to see if it has a user member using the following HEAD request. A 204 HTTP status response confirms membership, whereas a 404 HTTP status marks no membership.

If an invalid value for userIdentifier or any groupIdentifier is passed then a 400 HTTP status response will be returned.

HEAD /api/management/security/groups/{groupIdentifier}/users/{userIdentifier}

Name Parameter type Type Description
groupIdentifier path GroupIdentifier One of the group identifiers
userIdentifier path UserIdentifier One of the user identifiers

Remarks

Membership will be classed as true if the user is a member of a child group of the specified group.

Example requests

HEAD: /api/management/security/groups/9bb89380-fd49-41a5-ab2f-fc25e482a251/users/9f02a3d1-d8eb-4b10-8ed6-293a11d5201f
HEAD: /api/management/security/groups/9bb89380-fd49-41a5-ab2f-fc25e482a251/users/tdurden
HEAD: /api/management/security/groups/9bb89380-fd49-41a5-ab2f-fc25e482a251/users/[email protected]
HEAD: /api/management/security/groups/Paper%20Street%20Soap%20Company/users/3d063773-2ca9-4baf-90e1-ed674fa68640

Response message

HTTP status code Reason Response model
204 OK - user in group
403 Forbidden Error
404 NotFound - user not in group Error
500 InternalServerError Error

Check a user is a member of a group

A user can be checked to see if it is a member of a specific group, or groups, using the following HEAD request. A 204 HTTP status response confirms membership, whereas a 404 HTTP status marks no membership.

Multiple groups can be specified using a CSV of GroupIdentifiers.

If an invalid value for userIdentifier or any groupIdentifier is passed then a 400 HTTP status response will be returned.

HEAD /api/management/security/users/{userIdentifier}/groups/{groupIdentifier}[ ,...n ]

Name Parameter type Type Description
groupIdentifier path GroupIdentifier One of the group identifiers
userIdentifier path UserIdentifier One of the user identifiers

Remarks

Membership will be classed as true if the user is a member of a child group of the specified group.

Multiple groupId values can be passed in the path as comma-separated-value (CSV). If a CSV is passed then an OR evaluation will be performed.

Example requests

Single groupId

HEAD: /api/management/security/users/9f02a3d1-d8eb-4b10-8ed6-293a11d5201f/groups/9bb89380-fd49-41a5-ab2f-fc25e482a251
HEAD: /api/management/security/users/tdurden/groups/9bb89380-fd49-41a5-ab2f-fc25e482a251
HEAD: /api/management/security/users/[email protected]/groups/9bb89380-fd49-41a5-ab2f-fc25e482a251
HEAD: /api/management/security/users/[email protected]/groups/Paper%20Street%20Soap%20Company

Csv of groupId values

HEAD: /api/management/security/users/653aca45-d768-48d4-9af0-435e138b063f/groups/0ccf6d37-56a2-4a0d-bda1-efc377369232,eee2ca1a-8736-48b7-a274-da6f35499e56,504f21d0-361c-4c56-a87c-25e24ea81dfc
HEAD: /api/management/security/users/tdurden/groups/0ccf6d37-56a2-4a0d-bda1-efc377369232,eee2ca1a-8736-48b7-a274-da6f35499e56,504f21d0-361c-4c56-a87c-25e24ea81dfc
HEAD: /api/management/security/users/tdurden/groups/9bb89380-fd49-41a5-ab2f-fc25e482a251
HEAD: /api/management/security/users/[email protected]/groups/Paper%20Street%20Soap%20Company,Liposuction%20Technicians
HEAD: /api/management/security/users/[email protected]/groups/0ccf6d37-56a2-4a0d-bda1-efc377369232,Liposuction%20Technicians

Response message

HTTP status code Reason Response model
204 OK - user in group
403 Forbidden Error
404 NotFound - user not in group Error
500 InternalServerError Error