Zum Hauptinhalt springen

ACL

ACL CAT​

Syntax​

    ACL CAT [category]

Der Befehl zeigt die verfügbaren ACL-Kategorien an, wenn er ohne Argumente aufgerufen wird. Wenn ein Kategoriename angegeben wird, zeigt der Befehl alle Granat-Befehle in der angegebenen Kategorie an.

Resp Reply​

Eine der folgenden

  • Array-Antwort: Ein Array von Bulk-String-Antwort-Elementen, die ACL-Kategorien oder Befehle in einer gegebenen Kategorie darstellen.
  • Einfache Fehlerantwort: Der Befehl gibt einen Fehler zurück, wenn ein ungültiger Kategoriename angegeben wird.

ACL DELUSER​

Syntax​

    ACL DELUSER username [username ...]

Löscht alle angegebenen ACL-Benutzer und beendet alle Verbindungen, die mit solchen Benutzern authentifiziert sind. Hinweis: Der spezielle Standardbenutzer kann nicht aus dem System entfernt werden. Dies ist der Standardbenutzer, mit dem jede neue Verbindung authentifiziert wird. Die Liste der Benutzer kann Benutzernamen enthalten, die nicht existieren. In diesem Fall wird für nicht existierende Benutzer keine Operation durchgeführt.

Resp Reply​

Integer-Antwort: Die Anzahl der gelöschten Benutzer. Diese Zahl stimmt nicht immer mit der Anzahl der Argumente überein, da bestimmte Benutzer möglicherweise nicht existieren.

ACL GETUSER​

Syntax​

    ACL GETUSER username

Der Befehl gibt alle Regeln zurück, die für einen vorhandenen ACL-Benutzer definiert sind.

Insbesondere listet er die ACL-Flags, Passwort-Hashes und Befehle des Benutzers auf.

RESP-Antwort​

Eine der folgenden

  • Array-Antwort: Eine Liste von ACL-Regeldefinitionen für den Benutzer.
  • Nil-Antwort: Wenn der Benutzer nicht existiert.

ACL GENPASS​

    ACL GENPASS [bits]

Die Ausgabe des Befehls ist eine hexadezimale Darstellung einer zufälligen binären Zeichenfolge, die „stark“ genug ist, um als Passwort verwendet zu werden. Standardmäßig werden 256 Bit ausgegeben (also 64 Hexadezimalzeichen). Der Benutzer kann ein Argument in Form einer Bitanzahl von 1 bis 1024 angeben, um die Ausgabelänge zu ändern. Beachten Sie, dass die angegebene Bitanzahl immer auf das nächste Vielfache von 4 gerundet wird. Wenn Sie beispielsweise nur ein 1-Bit-Passwort anfordern, werden 4 Bit in Form eines einzelnen Hexadezimalzeichens ausgegeben.

RESP-Antwort​

Bulk-String-Antwort: Pseudozufällige Daten. Standardmäßig enthält es 64 Bytes, die 256 Bit Daten darstellen. Wenn Bits angegeben wurden, ist die Länge der Ausgabesonderzeichenfolge die Anzahl der angegebenen Bits (gerundet auf das nächste Vielfache von 4) geteilt durch 4.

ACL LIST​

Syntax​

    ACL LIST

Der Befehl zeigt die aktuell aktiven ACL-Regeln im Granat-Server an.

RESP-Antwort​

Array-Antwort: Ein Array von Bulk-String-Antwort-Elementen.

ACL LOAD​

Syntax​

    ACL LOAD

Wenn Granat für die Verwendung einer ACL-Datei konfiguriert ist, lädt dieser Befehl die ACLs aus der Datei neu und ersetzt alle aktuellen ACL-Regeln durch die in der Datei definierten. Der Befehl stellt sicher, dass ein Alles-oder-Nichts-Verhalten vorliegt, d. h.

  • Wenn jede Zeile in der Datei gültig ist, werden alle ACLs geladen.
  • Wenn eine oder mehrere Zeilen in der Datei ungültig sind, wird nichts geladen und die alten ACL-Regeln, die im Server-Speicher definiert sind, werden weiterhin verwendet.

RESP-Antwort​

Gibt +OK bei Erfolg zurück, andernfalls --ERR-Nachricht, falls vorhanden.

ACL SAVE​

Syntax​

    ACL SAVE

Wenn Redis für die Verwendung einer ACL-Datei konfiguriert ist (mit der Konfigurationsoption „aclfile“), speichert dieser Befehl die aktuell definierten ACLs aus dem Serverspeicher in die ACL-Datei.

RESP-Antwort​

Gibt +OK bei Erfolg zurück, andernfalls --ERR-Nachricht, falls vorhanden.

ACL SETUSER​

Syntax​

    ACL SETUSER username [rule [rule ...]]

Erstellt einen ACL-Benutzer mit den angegebenen Regeln oder ändert die Regeln eines vorhandenen Benutzers.

Manipuliert Granat ACL-Benutzer interaktiv. Wenn der Benutzername nicht existiert, erstellt der Befehl den Benutzernamen ohne Berechtigung. Anschließend liest er von links nach rechts alle als aufeinanderfolgende Argumente bereitgestellten Regeln und setzt die Benutzer-ACL-Regeln wie angegeben. Wenn der Benutzer bereits existiert, werden die bereitgestellten ACL-Regeln einfach zusätzlich zu den bereits festgelegten Regeln angewendet.

RESP-Antwort​

Gibt +OK bei Erfolg zurück, andernfalls --ERR-Nachricht, falls vorhanden.

ACL USERS​

Syntax​

    ACL USERS

Der Befehl zeigt eine Liste aller Benutzernamen der aktuell konfigurierten Benutzer im Granat ACL-System an.

RESP-Antwort​

Array-Antwort: Liste der vorhandenen ACL-Benutzer.

ACL WHOAMI​

Syntax​

    ACL WHOAMI

Gibt den Benutzernamen zurück, mit dem die aktuelle Verbindung authentifiziert ist. Neue Verbindungen werden mit dem Benutzer „default“ authentifiziert. Sie können den Benutzer mit AUTH wechseln.

RESP-Antwort​

Bulk-String-Antwort: Der Benutzername der aktuellen Verbindung.