Zugriff auf Instanzen mit einfacher tokenbasierter Authentifizierung sichern

Zusätzlich zur IAM-Authentifizierung (Identity and Access Management) können Sie die einfache tokenbasierte Authentifizierung verwenden, um den Zugriff auf Ihre Memorystore for Valkey-Instanzen zu sichern. Die einfache tokenbasierte Authentifizierung ist eine schlanke Lösung, mit der Clients ihre Identitäten in Ihren Anwendungen mithilfe ihrer Tokens bestätigen können.

Die grundlegende tokenbasierte Authentifizierung hat minimale Ressourcenanforderungen und einen geringen Ressourcenaufwand. Wenn Ihre aktuellen Arbeitslasten in Memorystore for Redis oder Ihren lokalen Anwendungen bereits die einfache tokenbasierte Authentifizierung verwenden, erleichtert diese Funktion den Übergang bei der Migration zu Memorystore for Valkey.

Vorteile

Die Verwendung der einfachen tokenbasierten Authentifizierung bietet folgende Vorteile:

  • Flexibilität: Sie können die Authentifizierung jederzeit für neue und vorhandene Instanzen aktivieren. Wenn Sie die einfache tokenbasierte Authentifizierung aktivieren, sind Ihre Instanzen sicher. Für alle neuen Verbindungen müssen Nutzer ein Authentifizierungstoken angeben, um sich bei Ihren Instanzen zu authentifizieren.
  • Rotation ohne Ausfallzeiten: Nutzer-Tokens können ohne Ausfallzeiten für Ihre Anwendungen rotiert werden.
  • Kompatibilität: Der Superuser default behält die Berechtigungen, die diesem Nutzer gewährt wurden. Die grundlegende tokenbasierte Authentifizierung bietet eine zusätzliche Sicherheitsebene. So wird die Abwärtskompatibilität gewährleistet, wenn Sie Ihre Arbeitslasten von Memorystore for Redis zu Memorystore for Valkey migrieren.

Authentifizierungsmodi

Die einfache tokenbasierte Authentifizierung unterstützt zwei primäre Authentifizierungsmodi:

  • Einfache Authentifizierung: Eine einfache Methode, bei der ein Nutzer ein Authentifizierungstoken sendet, um sich als default-Nutzer zu authentifizieren.
  • Authentifizierung für mehrere Nutzer: Verwalten Sie mehrere Nutzer, um den Zugriff auf Ihre Instanzen zu authentifizieren.

Best Practices

Aus Sicherheitsgründen empfehlen wir, die folgenden Best Practices für die einfache tokenbasierte Authentifizierung zu verwenden:

  • Nutzer-Tokens rotieren: Verwenden Sie eine Rotationsrichtlinie für Nutzer-Tokens.

  • Secret Manager verwenden: Codieren Sie die grundlegenden tokenbasierten Authentifizierungsdaten eines Nutzers nicht hart in Ihrem Anwendungscode. Speichern Sie sie stattdessen in Secret Manager und rufen Sie sie zur Laufzeit ab.

    Secret Manager bietet einen zentralen, verschlüsselten Vault für Nutzeranmeldedaten. Dadurch wird die unkontrollierte Verbreitung von Secrets vermieden und der operative Aufwand für die manuelle Verwaltung von Anmeldedaten reduziert. Die Zugriffssteuerung wird mithilfe von IAM erzwungen und Audit-Logs werden automatisch generiert. So wird die Compliance sichergestellt und die Offenlegung von Anmeldedaten verhindert.

  • Einfache tokenbasierte Authentifizierung mit Transport Layer Security (TLS) kombinieren: Wenn Sie die einfache tokenbasierte Authentifizierung verwenden, empfehlen wir, die Verschlüsselung bei der Übertragung zu aktivieren. So wird verhindert, dass Nutzernamen und Authentifizierungstokens als Klartext über das Netzwerk gesendet werden.

Hinweis

Bevor Sie Ihre Instanzen mit einfacher tokenbasierter Authentifizierung schützen, müssen Sie die Voraussetzungen in diesem Abschnitt erfüllen.

Clientunterstützung für die einfache tokenbasierte Authentifizierung prüfen

Prüfen Sie, ob Ihre Clientanwendungen die einfache tokenbasierte Authentifizierung unterstützen, indem Sie sicherstellen, dass die Anwendungen den Befehl AUTH verwenden können.

Der default-Nutzer authentifiziert sich mit dem folgenden Befehl bei Ihren Clientanwendungen:

AUTH TOKEN

Bei diesem Befehl ist TOKEN das Authentifizierungstoken des Standardnutzers.

Alle anderen Nutzer authentifizieren sich mit dem folgenden Befehl:

AUTH USERNAME TOKEN

Bei diesem Befehl sind USERNAME und TOKEN der Nutzername und das Authentifizierungstoken des Nutzers.

Weitere Informationen zum Befehl AUTH finden Sie in der Valkey-Dokumentation unter AUTH.

Google Cloud Console, Google Cloud CLI und APIs verwenden

So verwenden Sie die Google Cloud Console, die gcloud CLI und APIs:

  1. Wählen Sie in der Google Cloud Console auf der Seite für die Projektauswahl ein Google Cloud -Projekt aus oder erstellen Sie eines.

    Projektauswahl aufrufen

  2. Die Abrechnung für Ihr Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

  3. Installieren und initialisieren Sie die Google Cloud CLI (gcloud CLI).

    Hinweis:Wenn Sie die gcloud CLI installiert haben, prüfen Sie, ob Sie die aktuelle Version haben, indem Sie gcloud components update ausführen. Für den Zugriff auf die gcloud CLI-Befehle für Memorystore for Valkey benötigen Sie mindestens die gcloud CLI-Version 489.0.0.

  4. Aktivieren Sie die Memorystore for Valkey API.
    Memorystore for Valkey API
  5. Aktivieren Sie die Network Connectivity API.
    Network Connectivity API
  6. Aktivieren Sie die Service Consumer Management API.
    Service Consumer Management API

Rollen gewähren

Zum Konfigurieren der grundlegenden tokenbasierten Authentifizierung oder zum Aufrufen von Authentifizierungstokens für Ihre Instanzen benötigen Sie die IAM-Rolle „Memorystore-Administrator“ (roles/memorystore.admin) in Ihrem Google Cloud Projekt. Weitere Informationen zum Zuweisen dieser Rolle finden Sie unter Zugriffssteuerung.

Einfache tokenbasierte Authentifizierung für Instanzen verwalten

Memorystore for Valkey unterstützt die folgenden Aktionen zum Verwalten der einfachen tokenbasierten Authentifizierung für Instanzen:

Instanz mit einfacher tokenbasierter Authentifizierung erstellen

Wenn Sie eine Instanz mit einfacher tokenbasierter Authentifizierung erstellen, haben Sie eine einfache und weitgehend unterstützte Methode, um den Zugriff eines Nutzers auf die Instanz einzuschränken.

Sie können die Instanz entweder mit der Google Cloud Console oder der gcloud CLI erstellen.

Console

Informationen zum Erstellen einer Instanz und zum Aktivieren der einfachen tokenbasierten Authentifizierung finden Sie unter Instanzen erstellen.

gcloud

Verwenden Sie den Befehl gcloud memorystore instances create, um eine Instanz zu erstellen und die einfache tokenbasierte Authentifizierung dafür zu aktivieren.

gcloud memorystore instances create INSTANCE_ID \
--location=REGION \
--authorization-mode=token-auth

Ersetzen Sie die folgenden Werte:

  • INSTANCE_ID: die ID der Instanz, die Sie erstellen möchten, um die grundlegende tokenbasierte Authentifizierung zu verwenden
  • REGION: die Region, in der sich die Instanz befinden soll

Einfache tokenbasierte Authentifizierung für eine Instanz aktivieren

Wenn Sie die einfache tokenbasierte Authentifizierung für eine Instanz aktivieren, haben Sie eine einfache und weitgehend unterstützte Methode, um den Zugriff eines Nutzers auf die Instanz einzuschränken.

Der Nutzer default kann sich nur mit seinem Token bei der Instanz authentifizieren. Alle anderen Nutzer authentifizieren sich mit einem Standardnutzernamen und ‑token. Weitere Informationen finden Sie unter Clientunterstützung für die einfache tokenbasierte Authentifizierung prüfen.

Wenn Sie die einfache tokenbasierte Authentifizierung aktivieren, kann es zu Ausfallzeiten für Anwendungen kommen, die versuchen, neue Verbindungen herzustellen, da für Memorystore for Valkey authentifizierte Anfragen erforderlich sind. Vorhandene Verbindungen sind davon zwar nicht betroffen, aber wenn Sie die einfache tokenbasierte Authentifizierung für nachfolgende Verbindungsversuche mit der Instanz verwenden möchten, müssen Sie Ihre Anwendungen aktualisieren. Weitere Informationen finden Sie unter Über die einfache tokenbasierte Authentifizierung eine Verbindung zu einer Instanz herstellen.

Sie können die einfache tokenbasierte Authentifizierung für eine Instanz entweder über die Google Cloud Console oder die gcloud CLI aktivieren.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Memorystore for Valkey auf.

    Memorystore for Valkey

  2. Klicken Sie auf die Instanz, für die Sie die einfache tokenbasierte Authentifizierung aktivieren möchten.

  3. Scrollen Sie auf der Seite Instanz auf einen Blick zur Karte Sicherheit.

  4. Klicken Sie neben dem Feld Auth Mode (Authentifizierungsmodus) auf Bearbeiten ().

    Wenn neben dem Feld IAM-Authentifizierung oder Token-Authentifizierung angezeigt wird, haben Sie die IAM-Authentifizierung oder die grundlegende tokenbasierte Authentifizierung für die Instanz bereits aktiviert.

  5. Wählen Sie im Dialogfeld Authentifizierungsmodus die Option Tokenauthentifizierung aus und klicken Sie dann auf Instanz aktualisieren.

gcloud

Verwenden Sie den Befehl gcloud memorystore instances update, um die einfache tokenbasierte Authentifizierung zu aktivieren.

gcloud memorystore instances update INSTANCE_ID \
--location=REGION \
--authorization-mode=token-auth

Ersetzen Sie die folgenden Werte:

  • INSTANCE_ID: die ID der Instanz, für die Sie die einfache tokenbasierte Authentifizierung aktivieren möchten
  • REGION: die Region, in der sich die Instanz befindet

Einfachen tokenbasierten Authentifizierungsnutzer für eine Instanz erstellen

Wenn Sie einen Nutzer mit einfacher tokenbasierter Authentifizierung für eine Instanz erstellen, konfigurieren Sie die Instanz so, dass die Authentifizierung für mehrere Nutzer möglich ist. Nach der ersten Anmeldung des Nutzers dient dieser Authentifizierungsmodus als sichere und widerrufliche Anmeldedaten für neue Verbindungen. Der Nutzer kann das Authentifizierungstoken weiterhin verwenden, bis er es löscht oder entfernt wird.

Sie können einen Nutzer für die einfache tokenbasierte Authentifizierung entweder über die Google Cloud Console oder die gcloud CLI erstellen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Memorystore for Valkey auf.

    Memorystore for Valkey

  2. Klicken Sie auf die Instanz, für die Sie einen Nutzer mit einfacher tokenbasierter Authentifizierung erstellen möchten.

  3. Klicken Sie in der Navigationsleiste auf den Menüpunkt Nutzer.

    Wenn dieser Menüpunkt nicht in der Seitenleiste angezeigt wird, haben Sie keine Instanz mit Basisauthentifizierung erstellt oder keine tokenbasierte Basisauthentifizierung für die Instanz aktiviert.

  4. Klicken Sie auf der Seite Nutzer auf Nutzer hinzufügen.

  5. Geben Sie im Dialogfeld Nutzer hinzufügen eine ID für den Nutzer ein und klicken Sie dann auf Hinzufügen.

gcloud

Verwenden Sie den Befehl gcloud memorystore instances create-token-auth-user, um den Nutzer zu erstellen.

gcloud memorystore instances create-token-auth-user INSTANCE_ID \
--location=REGION \
--token-auth-user=USERNAME

Ersetzen Sie die folgenden Werte:

  • INSTANCE_ID: die ID der Instanz, für die Sie einen Nutzer mit einfacher tokenbasierter Authentifizierung erstellen möchten
  • REGION: die Region, in der sich die Instanz befindet
  • USERNAME: der Nutzername des Nutzers

Grundlegende tokenbasierte Authentifizierungsnutzer für eine Instanz auflisten

Sie können eine Liste der Nutzer mit einfacher tokenbasierter Authentifizierung für eine Instanz entweder über die Google Cloud Console oder die gcloud CLI abrufen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Memorystore for Valkey auf.

    Memorystore for Valkey

  2. Klicken Sie auf die Instanz, für die Sie eine Liste der Nutzer mit einfacher tokenbasierter Authentifizierung abrufen möchten.

  3. Klicken Sie in der Navigationsleiste auf den Menüpunkt Nutzer. Auf der Seite Nutzer wird eine Liste der Nutzer mit grundlegender tokenbasierter Authentifizierung angezeigt.

    Wenn der Menüpunkt Nutzer nicht in der Navigationsleiste angezeigt wird, haben Sie keine Instanz mit einfacher Authentifizierung erstellt oder keine einfache tokenbasierte Authentifizierung für die Instanz aktiviert.

gcloud

Verwenden Sie den Befehl gcloud memorystore instances token-auth-users list, um die Nutzer aufzulisten.

gcloud memorystore instances token-auth-users list \
--instance=INSTANCE_ID \
--location=REGION

Ersetzen Sie die folgenden Werte:

  • INSTANCE_ID: die ID der Instanz, für die Sie eine Liste der Nutzer mit einfacher tokenbasierter Authentifizierung abrufen möchten
  • REGION: die Region, in der sich die Instanz befindet.

Informationen zu einem Nutzer mit einfacher tokenbasierter Authentifizierung ansehen

Mit der gcloud CLI können Sie Informationen zu einem Nutzer mit einfacher tokenbasierter Authentifizierung aufrufen.

Verwenden Sie den Befehl gcloud memorystore instances token-auth-users describe, um Informationen zum Nutzer aufzurufen.

gcloud memorystore instances token-auth-users describe USERNAME \
--instance=INSTANCE_ID \
--location=REGION

Ersetzen Sie die folgenden Werte:

  • USERNAME: der Nutzername des Nutzers der einfachen tokenbasierten Authentifizierung, zu dem Sie Informationen aufrufen möchten
  • INSTANCE_ID: die ID der Instanz, bei der sich der Nutzer authentifizieren kann
  • REGION: die Region, in der sich die Instanz befindet

Nutzer mit einfacher tokenbasierter Authentifizierung aus einer Instanz löschen

Wenn Sie einen Nutzer mit einfacher tokenbasierter Authentifizierung aus einer Instanz löschen, widerrufen Sie die Zugriffsrechte des Nutzers auf die Instanz.

Sie können einen Nutzer mit einfacher tokenbasierter Authentifizierung aus einer Instanz löschen. Verwenden Sie dazu entweder die Google Cloud Console oder die gcloud CLI.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Memorystore for Valkey auf.

    Memorystore for Valkey

  2. Klicken Sie auf die Instanz, aus der Sie einen Nutzer mit einfacher tokenbasierter Authentifizierung löschen möchten.

  3. Klicken Sie in der Navigationsleiste auf den Menüpunkt Nutzer.

    Wenn der Menüpunkt nicht im Drawer angezeigt wird, haben Sie keine Instanz mit Basisauthentifizierung erstellt oder die tokenbasierte Basisauthentifizierung für die Instanz aktiviert.

  4. Klicken Sie auf der Seite Nutzer neben der ID des Nutzers, den Sie löschen möchten, auf Aktionen ().

  5. Wähle im angezeigten Menü Nutzer entfernen aus.

  6. Geben Sie im Dialogfeld Nutzer löschen? die ID des Nutzers ein und klicken Sie auf Löschen. Memorystore for Valkey löscht den Nutzer und alle Authentifizierungstokens, die mit dem Nutzer verknüpft sind.

  7. Optional: Memorystore for Valkey beendet keine bestehenden Verbindungen für den Nutzer, den Sie löschen. Führen Sie den folgenden Befehl auf allen Knoten in der Instanz aus, um diese Verbindungen zu beenden:

    CLIENT KILL USER USERNAME

gcloud

Verwenden Sie zum Löschen des Nutzers den Befehl gcloud memorystore instances token-auth-users delete.

gcloud memorystore instances token-auth-users delete USERNAME \
--instance=INSTANCE_ID \
--location=REGION

Ersetzen Sie die folgenden Werte:

  • USERNAME: der Nutzername des Nutzers der einfachen tokenbasierten Authentifizierung
  • INSTANCE_ID: die ID der Instanz, aus der Sie den Nutzer löschen möchten
  • REGION: die Region, in der sich die Instanz befindet

Wenn Sie einen Nutzer löschen, werden in Memorystore for Valkey auch alle Authentifizierungstokens gelöscht, die mit dem Nutzer verknüpft sind. Außerdem werden vorhandene Verbindungen von Memorystore for Valkey nicht beendet. Führen Sie den folgenden Befehl auf allen Knoten in der Instanz aus, um diese Verbindungen zu beenden:

CLIENT KILL USER USERNAME

Einfache tokenbasierte Authentifizierung für Nutzer verwalten

Memorystore for Valkey unterstützt die folgenden Aktionen zum Verwalten der einfachen tokenbasierten Authentifizierung für Nutzer:

Authentifizierungstoken für einen Nutzer erstellen

Wenn Sie einen einfachen Nutzer für die tokenbasierte Authentifizierung für eine Instanz erstellen, generiert Memorystore for Valkey automatisch ein Authentifizierungstoken für den Nutzer. Sie können jedoch ein zusätzliches Authentifizierungstoken für den Nutzer erstellen. So können Sie das vorhandene Token des Nutzers rotieren, ohne dass es zu Ausfallzeiten für Ihre Anwendungen kommt.

Sie können ein Authentifizierungstoken für einen Nutzer entweder mit der Google Cloud -Konsole oder der gcloud CLI erstellen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Memorystore for Valkey auf.

    Memorystore for Valkey

  2. Klicken Sie auf die Instanz mit dem Nutzer, für den Sie ein Authentifizierungstoken erstellen möchten.

  3. Klicken Sie in der Navigationsleiste auf den Menüpunkt Nutzer.

    Wenn der Menüpunkt nicht in der Navigationsleiste angezeigt wird, haben Sie keine Instanz mit Basisauthentifizierung erstellt oder die tokenbasierte Basisauthentifizierung für die Instanz nicht aktiviert.

  4. Klicken Sie auf der Seite Nutzer neben der ID des Nutzers, für den Sie ein Authentifizierungstoken erstellen möchten, auf Aktionen ().

  5. Wählen Sie im angezeigten Menü Authentifizierungstoken hinzufügen aus.

  6. Klicken Sie im Dialogfeld Authentifizierungstoken hinzufügen auf Hinzufügen.

    Wenn ein Nutzer bereits zwei Authentifizierungstokens hat, müssen Sie ein vorhandenes Token löschen, bevor Sie ein weiteres Token für den Nutzer erstellen können.

gcloud

Verwenden Sie den Befehl gcloud memorystore instances token-auth-users create-auth-token, um das Token zu erstellen.

gcloud memorystore instances token-auth-users create-auth-token USERNAME \
--instance=INSTANCE_ID \
--location=REGION

Ersetzen Sie die folgenden Werte:

  • USERNAME: der Nutzername des Nutzers, für den Sie ein Authentifizierungstoken erstellen möchten
  • INSTANCE_ID: die ID der Instanz, auf die der Nutzer mit dem Token zugreifen kann
  • REGION: die Region, in der sich die Instanz befindet.

Wenn ein Nutzer bereits zwei Authentifizierungstokens hat, müssen Sie ein vorhandenes Token löschen, bevor Sie ein weiteres Token für den Nutzer erstellen können.

Authentifizierungstokens für einen Nutzer auflisten

Sie können eine Liste der Authentifizierungstokens für einen Nutzer mit der gcloud CLI abrufen.

Verwenden Sie den Befehl gcloud memorystore instances token-auth-users auth-tokens list, um die Tokens aufzulisten.

gcloud memorystore instances token-auth-users auth-tokens list \
--token-auth-user=USERNAME \
--instance=INSTANCE_ID \
--location=REGION

Ersetzen Sie die folgenden Werte:

  • USERNAME: Der Nutzername des Nutzers, zu dem die Authentifizierungstokens gehören
  • INSTANCE_ID: die ID der Instanz, auf die der Nutzer mit den Authentifizierungstokens zugreifen kann
  • REGION: die Region, in der sich die Instanz befindet

Informationen zu Authentifizierungstokens für einen Nutzer ansehen

Sie können Informationen zu Authentifizierungstokens für einen Nutzer entweder über die Google Cloud -Konsole oder die gcloud CLI aufrufen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Memorystore for Valkey auf.

    Memorystore for Valkey

  2. Klicken Sie auf die Instanz, für die Sie Informationen zu den Authentifizierungstokens eines Nutzers aufrufen möchten.

  3. Klicken Sie in der Navigationsleiste auf den Menüpunkt Nutzer.

    Wenn der Menüpunkt nicht im Drawer angezeigt wird, haben Sie keine Instanz mit Basisauthentifizierung erstellt oder die tokenbasierte Basisauthentifizierung für die Instanz aktiviert.

  4. Klicken Sie auf der Seite Nutzer neben der ID des Nutzers auf Aktionen ().

  5. Wählen Sie im angezeigten Menü Authentifizierungstokens ansehen aus. Im Dialogfeld Authentifizierungstokens werden die folgenden Informationen angezeigt:

    • Die ID des Nutzers.
    • Die Anzahl der Authentifizierungstokens, die der Nutzer hat (eins oder zwei).
    • Die Version jedes Authentifizierungstokens sowie das Datum und die Uhrzeit, zu der Memorystore for Valkey die einzelnen Versionen erstellt hat. Jedes Mal, wenn Sie ein Authentifizierungstoken für einen Nutzer erstellen, erstellt Memorystore for Valkey eine inkrementelle Version des Tokens.
    • Die Authentifizierungstokens.

  6. Optional: Wenn Sie das Authentifizierungstoken eines Nutzers abrufen möchten, um es für die Verbindung mit einer Instanz zu verwenden, klicken Sie neben einem Token auf Kopieren () und fügen Sie das Token dann in einen Texteditor ein.

  7. Klicken Sie auf Fertig.

gcloud

Verwenden Sie den Befehl gcloud memorystore instances token-auth-users auth-tokens describe, um die Informationen aufzurufen.

gcloud memorystore instances token-auth-users auth-tokens describe AUTH_TOKEN \
--instance=INSTANCE_ID \
--location=REGION \
--token-auth-user=USERNAME

Ersetzen Sie die folgenden Werte:

  • AUTH_TOKEN: der Name des Authentifizierungstokens, zu dem Sie Informationen aufrufen möchten
  • INSTANCE_ID: die ID der Instanz, auf die der Nutzer mit dem Token zugreifen kann
  • REGION: die Region, in der sich die Instanz befindet
  • USERNAME: Der Nutzername des Nutzers, zu dem das Authentifizierungstoken gehört.

Authentifizierungstoken eines Nutzers löschen

Das Löschen eines Authentifizierungstokens von einem Nutzer ist eine wichtige Sicherheitsmaßnahme, durch die das Token ungültig wird.

Sie können ein Authentifizierungstoken eines Nutzers entweder über die Google Cloud Console oder die gcloud CLI löschen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Memorystore for Valkey auf.

    Memorystore for Valkey

  2. Klicken Sie auf die Instanz, die einen Nutzer enthält, von dem Sie ein Authentifizierungstoken löschen möchten.

  3. Klicken Sie in der Navigationsleiste auf den Menüpunkt Nutzer.

    Wenn der Menüpunkt nicht im Drawer angezeigt wird, haben Sie keine Instanz mit Basisauthentifizierung erstellt oder die tokenbasierte Basisauthentifizierung für die Instanz aktiviert.

  4. Klicken Sie auf der Seite Nutzer neben der ID des Nutzers, von dem Sie ein Authentifizierungstoken löschen möchten, auf Aktionen ().

  5. Wählen Sie im angezeigten Menü Authentifizierungstoken löschen aus.

  6. Führen Sie im Dialogfeld Authentifizierungstoken löschen? die folgenden Schritte aus:

    1. Wählen Sie im Menü Auth-Token das Authentifizierungstoken aus, das Sie löschen möchten.
    2. Geben Sie im Feld Auth-Token-ID die Versionsnummer des Tokens ein (z. B. version-1).
    3. Klicken Sie auf Löschen.

gcloud

Verwenden Sie zum Löschen des Tokens den Befehl gcloud memorystore instances token-auth-users auth-tokens delete.

gcloud memorystore instances token-auth-users auth-tokens delete AUTH_TOKEN \
--instance=INSTANCE_ID \
--location=REGION \
--token-auth-user=USERNAME

Ersetzen Sie die folgenden Werte:

  • AUTH_TOKEN: der Name des Authentifizierungstokens, das Sie für den Nutzer löschen möchten
  • INSTANCE_ID: die ID der Instanz, auf die der Nutzer durch Löschen des Tokens nicht mehr zugreifen soll
  • REGION: die Region, in der sich die Instanz befindet
  • USERNAME: Der Nutzername des Nutzers, der ein Token hat, das Sie löschen möchten.

Verbindung zu einer Instanz über die einfache tokenbasierte Authentifizierung herstellen

Sie können die folgenden Methoden verwenden, um eine Verbindung zu einer Instanz über die einfache tokenbasierte Authentifizierung herzustellen:

  • URI-String (Uniform Resource Identifier): Dieser einzelne, formatierte String wird aus Gründen der Einfachheit verwendet, da alle erforderlichen Verbindungsinformationen (z. B. der Nutzername und das Authentifizierungstoken des Nutzers sowie die IP-Adresse und der Hostname der Instanz) in einem String enthalten sind.
  • Flags: Diese Methode eignet sich besser für die Verwendung einzelner Befehlszeilentools, für Skripts oder für Umgebungen, in denen die Konfiguration mithilfe mehrerer separater Argumente in separate Umgebungsvariablen aufgeteilt wird.

In den folgenden Abschnitten wird jede Verbindungsmethode erläutert.

URI-String verwenden

Verwenden Sie den folgenden Befehl, um über einen URI-String eine Verbindung von einer Compute Engine-VM oder einer unterstützten Umgebung herzustellen:

valkey-cli -u
redis://USERNAME:TOKEN@IP_ADDRESS:PORT

Ersetzen Sie die folgenden Werte:

  • USERNAME: der Nutzername des Nutzers, der versucht, eine Verbindung zur Instanz herzustellen.

  • TOKEN: Das Authentifizierungstoken des Nutzers.

    Wenn Sie ein falsches oder ungültiges Token angeben, können Sie keine Verbindung zur Instanz herstellen. Memorystore for Valkey erstellt einen Eintrag für diese Aktion im Audit-Log zum Datenzugriff. Sie können das Log aufrufen, um Sicherheitsbedrohungen zu erkennen oder Verbindungsprobleme zu beheben, die durch ein abgelaufenes oder falsch formatiertes Token verursacht werden. Weitere Informationen zum Aufrufen des Audit-Logs zum Datenzugriff finden Sie unter Logs ansehen.

  • IP_ADDRESS: die IP-Adresse der Instanz.

  • PORT: die Portnummer, die für die Instanz reserviert ist.

Wenn Sie die Verschlüsselung während der Übertragung für die Instanz aktivieren, müssen Sie das sichere Protokoll (rediss://) verwenden und die TLS-Flags anhängen. Beispiel:

valkey-cli -u
rediss://USERNAME:TOKEN@IP_ADDRESS:PORT --tls --cacert /tmp/server_ca.pem

Flags verwenden

Wenn Sie über Flags eine Verbindung von einer Compute Engine-VM oder einer unterstützten Umgebung herstellen möchten, verwenden Sie den folgenden Befehl:

valkey-cli --user USERNAME -a TOKEN -h IP_ADDRESS -p PORT

Ersetzen Sie die folgenden Werte:

  • USERNAME: der Nutzername des Nutzers, der versucht, eine Verbindung zur Instanz herzustellen.

  • TOKEN: Das Authentifizierungstoken des Nutzers.

    Wenn Sie ein falsches oder ungültiges Token angeben, können Sie keine Verbindung zur Instanz herstellen. Memorystore for Valkey erstellt für diese Aktion einen Eintrag im Audit-Log zum Datenzugriff. Sie können das Log aufrufen, um Sicherheitsbedrohungen zu erkennen oder Verbindungsprobleme zu beheben, die durch ein abgelaufenes oder falsch formatiertes Token verursacht werden. Weitere Informationen zum Aufrufen des Audit-Logs zum Datenzugriff finden Sie unter Logs ansehen.

  • IP_ADDRESS: die IP-Adresse der Instanz.

  • PORT: die Portnummer, die für die Instanz reserviert ist.

Wenn Sie die Verschlüsselung während der Übertragung für die Instanz aktivieren, müssen Sie die TLS-Flags anhängen. Beispiel:

valkey-cli --user USERNAME -a TOKEN -h IP_ADDRESS -p PORT --tls --cacert /tmp/server_ca.pem

Authentifizierungstoken eines Nutzers ohne Ausfallzeit rotieren

So rotieren Sie das Authentifizierungstoken eines Nutzers, ohne dass es zu Ausfallzeiten für Ihre Anwendungen kommt:

  1. Zusätzliches Authentifizierungstoken für den Nutzer erstellen: Memorystore for Valkey generiert ein zweites, gültiges Token. Beide Tokens sind gültig.
  2. Anwendungen aktualisieren: Aktualisieren Sie Ihre Anwendungen, damit sie das neue Token verwenden.
  3. Löschen Sie das Authentifizierungstoken für den Nutzer: Memorystore for Valkey entfernt das erste Token. Der Nutzer kann sich nur mit dem zweiten Token in Ihren Anwendungen authentifizieren.

Auf Logs für die einfache tokenbasierte Authentifizierung zugreifen

Memorystore for Valkey generiert Audit-Logs zu Administratoraktivitäten und zum Datenzugriff für Vorgänge, die mit Authentifizierungstokens und Nutzern verknüpft sind. Weitere Informationen zu diesen Audit-Logs finden Sie unter Zugriff mit Audit-Logs überwachen.