Tutorial: Erste Schritte mit der Sicherheit in Amazon OpenSearch Serverless (Konsole)

Öffnen Sie die Amazon OpenSearch Service-Konsole unter https://console.aws.amazon.com/aos/home.

Erweitern Sie im linken Navigationsbereich Serverless und wählen Sie Encryption policies (Verschlüsselungsrichtlinien).

Wählen Sie Create encryption policy (Verschlüsselungsrichtlinie erstellen).

Speichern Sie die Richtlinie unter dem Namen books-policy. Geben Sie für die Beschreibung einEncryption policy for books collection.

Geben Sie books unter Ressourcen den Namen Ihrer Sammlung ein. Wenn Sie etwas umfangreicher sein möchten, können Sie ein Sternchen (books*) angeben, damit die Richtlinie für alle Sammlungen gilt, die mit dem Wort „Bücher“ beginnen.

Lassen Sie für Verschlüsselung die Option Eigenen AWS Schlüssel verwenden aktiviert.

Wählen Sie Erstellen aus.

Wählen Sie im linken Navigationsbereich Network policies (Netzwerkrichtlinien) und dann Create network policy (Netzwerkrichtlinie erstellen) aus.

Speichern Sie die Richtlinie unter dem Namen books-policy. Geben Sie für die Beschreibung einNetwork policy for books collection.

Geben Sie unter Regel 1 einen Namen für die Regel einPublic access for books collection.

Der Einfachheit halber konfigurieren Sie in diesem Tutorial den öffentlichen Zugriff für die Büchersammlung. Wählen Sie für den Zugriffstyp Public (Öffentlich) aus.

Sie greifen über OpenSearch Dashboards auf die Sammlung zu. Dazu müssen Sie den Netzwerkzugriff für Dashboards und den OpenSearch Endpunkt konfigurieren, da Dashboards sonst nicht funktionieren.

Aktivieren Sie für den Ressourcentyp sowohl Zugriff auf OpenSearch Endpunkte als auch Zugriff auf Dashboards. OpenSearch

Geben Sie in beiden Eingabefeldern ein. Collection Name = books Diese Einstellung schränkt die Richtlinie so ein, dass sie nur für eine einzelne Sammlung gilt (books). Ihre Regel sollte folgendermaßen aussehen:

Wählen Sie Erstellen aus.

Wählen Sie im linken Navigationsbereich Data access policies (Datenzugriffsrichtlinien) und anschließend Create access policy (Zugriffsrichtlinie erstellen) aus.

Speichern Sie die Richtlinie unter dem Namen books-policy. Geben Sie für die Beschreibung einData access policy for books collection.

Wählen Sie JSON als Methode zur Richtliniendefinition aus und fügen Sie die folgende Richtlinie in den JSON-Editor ein.

Ersetzen Sie den Haupt-ARN durch den ARN des Kontos, mit dem Sie sich bei OpenSearch Dashboards anmelden und Daten indexieren.

[
   {
      "Rules":[
         {
            "ResourceType":"index",
            "Resource":[
               "index/books/*"
            ],
            "Permission":[
               "aoss:CreateIndex",
               "aoss:DescribeIndex", 
               "aoss:ReadDocument",
               "aoss:WriteDocument",
               "aoss:UpdateIndex",
               "aoss:DeleteIndex"
            ]
         }
      ],
      "Principal":[
         "arn:aws:iam::123456789012:user/my-user"
      ]
   }
]

Diese Richtlinie gewährt einem einzelnen Benutzer die Mindestberechtigungen, die erforderlich sind, um einen Index in der Bücher-Sammlung zu erstellen, einige Daten zu indizieren und danach zu suchen.

Wählen Sie Erstellen aus.

Wählen Sie im linken Navigationsbereich Collections (Sammlungen) und wählen Sie Create collection (Sammlung erstellen) aus.

Wählen Sie im Feld Serverlose Generierung die Option Zu Classic wechseln aus, falls Sie Classic noch nicht aktiviert haben.

Geben books Sie als Namen der Sammlung ein.

Wählen Sie als Sammlungstyp Search (Suchen) aus.

Unter Verschlüsselung informiert Sie OpenSearch Serverless darüber, dass der Name der Sammlung der books-policy Verschlüsselungsrichtlinie entspricht.

Unter Netzwerkzugriffseinstellungen informiert Sie OpenSearch Serverless darüber, dass der Name der Sammlung der books-policy Netzwerkrichtlinie entspricht.

Wählen Sie Weiter aus.

Unter Optionen für Datenzugriffsrichtlinien informiert Sie OpenSearch Serverless darüber, dass der Name der Sammlung der books-policy Datenzugriffsrichtlinie entspricht.

Wählen Sie Weiter aus.

Konfigurieren Sie unter OpenSearch Benutzeroberfläche konfigurieren die OpenSearch Anwendung und den Arbeitsbereich für Ihre Sammlung. Wählen Sie „Vorhandene OpenSearch Anwendung auswählen“ oder „Neue OpenSearch Anwendung erstellen“ und wählen oder erstellen Sie einen Arbeitsbereich. Wählen Sie Weiter aus.

Überprüfen Sie die Sammlungskonfiguration und wählen Sie Submit (Senden) aus. Die Initialisierung von Sammlungen dauert in der Regel weniger als eine Minute.

Wählen Sie im linken Navigationsbereich Collections (Sammlungen) und dann die Bücher-Sammlung aus, um die Detailseite zu öffnen.

Wählen Sie die OpenSearch Dashboard-URL für die Sammlung aus. Die URL nimmt das Format https://collection-id.us-east-1.aoss.amazonaws.com/_dashboards an.

Melden Sie sich mit den AWS Zugriffs- und Geheimschlüsseln für den Principal, die Sie in Ihrer Datenzugriffsrichtlinie angegeben haben, bei OpenSearch Dashboards an.

Öffnen Sie in OpenSearch Dashboards das linke Navigationsmenü und wählen Sie Dev Tools aus.

Führen Sie den folgenden Befehl aus, um einen einzelnen Index mit dem Namen books-index zu erstellen:

PUT books-index 

Führen Sie den folgenden Befehl aus, um ein einzelnes Dokument in books-index zu indizieren:

PUT books-index/_doc/1
{ 
  "title": "The Shining",
  "author": "Stephen King",
  "year": 1977
}

Um Daten in OpenSearch Dashboards zu suchen, müssen Sie mindestens ein Indexmuster konfigurieren. OpenSearch verwendet diese Muster, um zu identifizieren, welche Indizes Sie analysieren möchten. Öffnen Sie das Dashboards-Hauptmenü, wählen Sie Stack-Management, wählen Sie Indexmuster und dann Indexmuster erstellen. Geben Sie für dieses Tutorial books-index ein.

Wählen Sie Nächster Schritt aus und klicken Sie auf Indexmuster erstellen. Nachdem das Muster erstellt wurde, können Sie die verschiedenen Dokumentfelder anzeigen, z. B. author und title.

Um mit der Suche nach Ihren Daten zu beginnen, öffnen Sie erneut das Hauptmenü und wählen Sie Discover (Erkunden) oder verwenden Sie die Such-API.