# salt.runners.auth

Authentication runner for creating, deleting, and managing eauth tokens.

Added in version 2016.11.0.

salt.runners.auth.del_token(token)

  Delete an eauth token by name

  CLI Example:

      salt-run auth.del_token 6556760736e4077daa601baec2b67c24

salt.runners.auth.mk_token(**load)

  Create an eauth token using provided credentials

  Non-root users may specify an expiration date -- if allowed via the `token_expire_user_override` setting -- by passing an additional `token_expire` param. This overrides the `token_expire` setting of the same name in the Master config and is how long a token should live in seconds.

  CLI Example:

      salt-run auth.mk_token username=saltdev password=saltdev eauth=auto

      # Create a token valid for three years.
      salt-run auth.mk_token username=saltdev password=saltdev eauth=auto \
          token_expire=94670856

      # Calculate the number of seconds using expr.
      salt-run auth.mk_token username=saltdev password=saltdev eauth=auto \
          token_expire=$(expr \( 365 \* 24 \* 60 \* 60 \) \* 3)