Security Principals

List

Retrieve Criteria Security Principal List of a Site Defaults object.

GET/api/MFADefaultSettings/Criteria/SecurityPrincipals

Query parameters

Response

200401404

Success

Body

application/json; api-version=1.0

accountnullable string

The name of the user/group account the filter is added to.

typeUserType (enum)

User Type

1 = User,2 = Group,3 = ForeignSecurityPrincipal,4 = Computer

sidnullable string

The SID of the user/group account the filter is added to.

Request

JavaScriptCurlPython

const response = await fetch('/api/MFADefaultSettings/Criteria/SecurityPrincipals', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401404

[
  {
    "account": "text",
    "type": [
      "1 = User",
      "2 = Group",
      "3 = ForeignSecurityPrincipal",
      "4 = Computer"
    ],
    "sid": "text"
  }
]

Add

Add a user, group or machine to the Security Principal List of the Criteria settings.

POST/api/MFADefaultSettings/Criteria/SecurityPrincipals

Query parameters

Body

application/json; api-version=1.0

SecurityPrincipal configuration.

accountnullable string

The name of the account to add to the Criteria.

sidnullable string

The SID of the account to add to the Criteria.

Response

201401404409

Created

Request

JavaScriptCurlPython

const response = await fetch('/api/MFADefaultSettings/Criteria/SecurityPrincipals', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json; api-version=1.0"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

401404409

{
  "type": "text",
  "title": "text",
  "detail": "text",
  "instance": "text"
}

Remove

Remove a user, group or machine from the Security Principal List of the Criteria settings.

DELETE/api/MFADefaultSettings/Criteria/SecurityPrincipals

Query parameters

Body

application/json; api-version=1.0

SecurityPrincipal configuration.

accountnullable string

The name of the account to remove from the Criteria.

sidnullable string

The SID of the account to remove from the Criteria.

Response

204401404

No Content

Request

JavaScriptCurlPython

const response = await fetch('/api/MFADefaultSettings/Criteria/SecurityPrincipals', {
    method: 'DELETE',
    headers: {
      "Content-Type": "application/json; api-version=1.0"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

401404

{
  "type": "text",
  "title": "text",
  "detail": "text",
  "instance": "text"
}