Skip to content
/
Replace the strong passwo...

Replace the strong password enforcement configuration

Request

Replaces your organization's strong password enforcement configuration with the configuration you send. Any rule you don't include is deleted.

A rule with an id updates the existing rule with that id. A rule without an id is created. Rules are evaluated in the order you send them, and the first rule that matches wins.

To change part of the configuration, retrieve it first, apply your changes, and send the complete configuration back.

Security
x-api-key
Bodyapplication/jsonrequired

The complete set of rules to save.

rulesArray of objects(Strong Password Enforcement Rule)required

Complete list of Strong Password Enforcement rules.

globalsobject

Reserved for control-wide settings. Empty for this control.

Example:
{}
PUT
/v1/controls/strongPasswordEnforcement/configuration
curl -i -X PUT \
  https://api.pushsecurity.com/v1/controls/strongPasswordEnforcement/configuration \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "globals": {},
    "rules": []
  }'

Responses

OK

Bodyapplication/json
rulesArray of objects(Strong Password Enforcement Rule)required

Complete list of Strong Password Enforcement rules.

globalsobject

Reserved for control-wide settings. Empty for this control.

Example:
{}
Response
{
  "globals": {},
  "rules": [
    {
      "id": "c478966c-f927-411c-b919-179832d3d50c",
      "name": "Prompt Finance on weak passwords",
      "enabled": true,
      "mode": "ACKNOWLEDGE",
      "title": "Strengthen your password",
      "subtext": "This password does not meet our security policy.",
      "buttonText": "I understand",
      "applicableFindings": [
        "WEAK_PASSWORD",
        "REUSED_PASSWORD"
      ],
      "criteria": {
        "employeeIds": {
          "matches": [ … ]
        },
        "employeeGroups": {
          "matches": [ … ]
        },
        "appTypes": {
          "matches": [ … ]
        },
        "appLabels": {
          "matches": [ … ]
        },
        "appCategories": {
          "matches": [ … ]
        },
        "approvalStatuses": {
          "matches": [ … ]
        },
        "sensitivityLevels": {
          "matches": [ … ]
        }
      }
    }
  ]
}