ACL

Since 1.1.0ACL

Syntax

ACL
  • Flags: admin
  • ACL categories: @admin, @dangerous, @server, @slow
  • Arity: -2

Manages users and what each may do: which commands it may run, which keys it may read or write, which channels it may use. The default user always exists; new connections are logged in as it. See its subcommands, and AUTH.

Subcommands

  • ACL CAT: Returns the command categories, or the commands of one category.
  • ACL DELUSER: Deletes users.
  • ACL DRYRUN: Tells whether a user could run a command, without running it.
  • ACL GENPASS: Returns a random password, as hexadecimal digits, from the system's secure random source.
  • ACL GETUSER: Returns a user's rules: its flags, the SHA-256 hashes of its passwords, its command rules, its key and channel patterns, and its selectors.
  • ACL HELP: In Redis, lists the ACL subcommands.
  • ACL LIST: Returns every user as a line of the ACL file format: user <name> <on|off> <passwords> <key patterns> <channel patterns> <command rules>.
  • ACL LOAD: Replaces every user with those in the ACL file, the aclfile setting.
  • ACL LOG: Returns recent security events, newest first: failed logins, and commands, keys or channels refused for lack of permission.
  • ACL SAVE: Writes every user to the ACL file, the aclfile setting.
  • ACL SETUSER: Creates the user username, or changes it, by applying rules from left to right.
  • ACL USERS: Returns the names of every user.
  • ACL WHOAMI: Returns the name of the user this connection is logged in as.