Criteria

PreviousMFA Default Settings NextDevices

Last updated 1 year ago

Was this helpful?

Get

get

Retrieve the Criteria settings of a MFA Default object.

Query parameters

siteIdinteger · int32Optional

The SiteId of a MFA Default object for which to retrieve the Criteria settings (optional).

Responses

application/json; api-version=1.0

objectOptional

MFA Criteria

application/json; api-version=1.0

get

GET /api/MFADefaultSettings/Criteria HTTP/1.1
Host: 
Accept: */*

{
  "securityPrincipals": {
    "enabled": true,
    "matchingMode": [
      "0 = IsNotOneOfTheFollowing",
      "1 = IsOneOfTheFollowing"
    ],
    "members": [
      {
        "account": "text",
        "type": [
          "1 = User",
          "2 = Group",
          "3 = ForeignSecurityPrincipal",
          "4 = Computer"
        ],
        "sid": "text"
      }
    ]
  },
  "gateways": {
    "enabled": true,
    "matchingMode": [
      "0 = IsNotOneOfTheFollowing",
      "1 = IsOneOfTheFollowing"
    ],
    "members": [
      {
        "gatewayIP": "text"
      }
    ]
  },
  "oSs": {
    "enabled": true,
    "matchingMode": [
      "0 = IsNotOneOfTheFollowing",
      "1 = IsOneOfTheFollowing"
    ],
    "allowedOSes": {
      "chrome": true,
      "android": true,
      "webClient": true,
      "iOS": true,
      "linux": true,
      "mac": true,
      "wyse": true,
      "windows": true
    }
  },
  "iPs": {
    "enabled": true,
    "matchingMode": [
      "0 = IsNotOneOfTheFollowing",
      "1 = IsOneOfTheFollowing"
    ],
    "allowedIPs": {
      "iPv4s": [
        {
          "from": "text",
          "to": "text"
        }
      ],
      "iPv6s": [
        {
          "from": "text",
          "to": "text"
        }
      ]
    }
  },
  "hardwareIDs": {
    "enabled": true,
    "matchingMode": [
      "0 = IsNotOneOfTheFollowing",
      "1 = IsOneOfTheFollowing"
    ],
    "members": [
      {
        "hardwareID": "text"
      }
    ]
  },
  "access": [
    "0 = DenyCriteriaWhen",
    "1 = AllowCriteriaWhen"
  ],
  "devices": {
    "enabled": true,
    "matchingMode": [
      "0 = IsNotOneOfTheFollowing",
      "1 = IsOneOfTheFollowing"
    ],
    "members": [
      {
        "client": "text"
      }
    ]
  }
}

Update

put

Update the Criteria settings of a MFA Default object.

Query parameters

siteIdinteger · int32Optional

The SiteId of a MFA Default object for which to modify the Criteria settings (optional).

Body

accessstring · enumOptional

Access type options

Available options:

securityPrincipalsEnabledboolean | nullableOptional

Whether the Security Principals criteria is enabled or not

securityPrincipalsMatchingModestring · enumOptional

Matching mode type options

Available options:

gatewaysEnabledboolean | nullableOptional

Whether the Gateways criteria is enabled or not

gatewaysMatchingModestring · enumOptional

Matching mode type options

Available options:

devicesEnabledboolean | nullableOptional

Whether the Devices criteria is enabled or not

devicesMatchingModestring · enumOptional

Matching mode type options

Available options:

oSsEnabledboolean | nullableOptional

Whether the OSs criteria is enabled or not

oSsMatchingModestring · enumOptional

Matching mode type options

Available options:

iPsEnabledboolean | nullableOptional

Whether the IPs criteria is enabled or not

iPsMatchingModestring · enumOptional

Matching mode type options

Available options:

hardwareIDsEnabledboolean | nullableOptional

Whether the HardwareIDs criteria is enabled or not

hardwareIDsMatchingModestring · enumOptional

Matching mode type options

Available options:

Responses

application/json; api-version=1.0

put

PUT /api/MFADefaultSettings/Criteria HTTP/1.1
Host: 
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 681

{
  "access": [
    "0 = DenyCriteriaWhen",
    "1 = AllowCriteriaWhen"
  ],
  "securityPrincipalsEnabled": true,
  "securityPrincipalsMatchingMode": [
    "0 = IsNotOneOfTheFollowing",
    "1 = IsOneOfTheFollowing"
  ],
  "gatewaysEnabled": true,
  "gatewaysMatchingMode": [
    "0 = IsNotOneOfTheFollowing",
    "1 = IsOneOfTheFollowing"
  ],
  "devicesEnabled": true,
  "devicesMatchingMode": [
    "0 = IsNotOneOfTheFollowing",
    "1 = IsOneOfTheFollowing"
  ],
  "oSsEnabled": true,
  "oSsMatchingMode": [
    "0 = IsNotOneOfTheFollowing",
    "1 = IsOneOfTheFollowing"
  ],
  "iPsEnabled": true,
  "iPsMatchingMode": [
    "0 = IsNotOneOfTheFollowing",
    "1 = IsOneOfTheFollowing"
  ],
  "hardwareIDsEnabled": true,
  "hardwareIDsMatchingMode": [
    "0 = IsNotOneOfTheFollowing",
    "1 = IsOneOfTheFollowing"
  ]
}

No content