Authorization

Update authorization settings

put/authorization/settings

Request

  • Base URL: https://docs.emqx.com/api/v5
  • URL: https://docs.emqx.com/api/v5/authorization/settings
  • Auth: one of:
    • HTTP basic
    • bearerAuth (a scheme the document does not define)

Request body

no_match'allow' | 'deny' required

<br/>Default access control action if the user or client matches no ACL rules,<br/>or if no such user or client is found by the configurable authorization<br/>sources such as built_in_database, an HTTP API, or a query against PostgreSQL.<br/>Find more details in 'authorization.sources' config.<br/>

deny_action'ignore' | 'disconnect' required

The action when the authorization check rejects an operation.

Example request

{
  "cache": {
    "ttl": "12m"
  }
}

Response

no_match'allow' | 'deny' required

<br/>Default access control action if the user or client matches no ACL rules,<br/>or if no such user or client is found by the configurable authorization<br/>sources such as built_in_database, an HTTP API, or a query against PostgreSQL.<br/>Find more details in 'authorization.sources' config.<br/>

deny_action'ignore' | 'disconnect' required

The action when the authorization check rejects an operation.

Example response

{
  "cache": {
    "ttl": "12m"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.