# salt.auth.rest

Provide authentication using a REST call

REST auth can be defined like any other eauth module:

    external_auth:
      rest:
        ^url: https://url/for/rest/call
        fred:
          - .*
          - '@runner'

If there are entries underneath the ^url entry then they are merged with any responses from the REST call. In the above example, assuming the REST call does not return any additional ACLs, this will authenticate Fred via a REST call and allow him to run any execution module and all runners.

The REST call should return a JSON array that maps to a regular eauth YAML structure of a user as above.

salt.auth.rest.acl(username, **kwargs)

  REST authorization

salt.auth.rest.auth(username, password)

  REST authentication

salt.auth.rest.fetch(username, password)

  Call the rest authentication endpoint