loadSecurities #

Available since 1.7.0

Load roles, profiles and users into the storage layer.

The roles, profiles and users definitions follow the same structure as in the body parameter of these corresponding API routes:

• createRole
• createProfile
• createUser

Notes:

• The body can contain any number of roles, profiles and users.
• If a role, profile or user already exists, it will be replaced.
• Fixtures are loaded sequentially: first the roles, then the profiles and finally the users. If a failure occurs, Kuzzle immediately interrupts the sequence, without rollbacking what has already been loaded.

---

Query Syntax #

HTTP #

Copied to clipboard!

URL: http://kuzzle:7512/admin/_loadSecurities[?refresh=wait_for]
Method: POST
Body:

Copied to clipboard!

{
  "roles": {
    "role-id": {
      /* role definition */
    }
  },
  "profiles": {
    "profile-id": {
      /* profile definition */
    }
  },
  "users": {
    "user-id": {
      /* user definition */
    }
  }
}

Other protocols #

Copied to clipboard!

{
  "controller": "admin",
  "action": "loadSecurities",
  "body": {
    "roles": {
      "role-id": {
        /* role definition */
      }
    },
    "profiles": {
      "profile-id": {
        /* profile definition */
      }
    },
    "users": {
      "user-id": {
        /* user definition */
      }
    }
  }
}

Arguments #

Optional: #

• refresh: if set to wait_for, Kuzzle will not respond until the fixtures are loaded

---

Response #

Returns a confirmation that the command is being executed.

Copied to clipboard!

{
  "requestId": "d16d5e8c-464a-4589-938f-fd84f46080b9",
  "status": 200,
  "error": null,
  "controller": "admin",
  "action": "loadSecurities",
  "collection": null,
  "index": null,
  "result": { "acknowledge": true }
}