Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

So arbeitet Amazon Kendra mit IAM

Bevor Sie IAM verwenden, um den Zugriff auf Amazon Kendra zu verwalten, sollten Sie wissen, welche IAM-Funktionen für Amazon Kendra verfügbar sind. Einen allgemeinen Überblick darüber, wie Amazon Kendra und andere AWS Services mit IAM zusammenarbeiten, finden Sie unter AWS Services That Work with IAM im IAM-Benutzerhandbuch.

Identitätsbasierte Richtlinien von Amazon Kendra

Mit identitätsbasierten IAM-Richtlinien können Sie angeben, welche Aktionen und Ressourcen zugelassen oder abgelehnt werden. Darüber hinaus können Sie die Bedingungen festlegen, unter denen Aktionen zugelassen oder abgelehnt werden. Amazon Kendra unterstützt bestimmte Aktionen, Ressourcen und Bedingungsschlüssel. Informationen zu sämtlichen Elementen, die Sie in einer JSON-Richtlinie verwenden, finden Sie in der IAM-Referenz für JSON-Richtlinienelemente im IAM-Benutzerhandbuch.

Aktionen

Administratoren können mithilfe von AWS JSON-Richtlinien angeben, wer Zugriff auf was hat. Das heißt, welcher Prinzipal Aktionen für welche Ressourcen und unter welchen Bedingungen ausführen kann.

Das Element Action einer JSON-Richtlinie beschreibt die Aktionen, mit denen Sie den Zugriff in einer Richtlinie zulassen oder verweigern können. Richtlinienaktionen haben normalerweise denselben Namen wie der zugehörige AWS API-Vorgang. Es gibt einige Ausnahmen, z. B. Aktionen, die nur mit Genehmigung durchgeführt werden können und für die es keinen passenden API-Vorgang gibt. Es gibt auch einige Operationen, die mehrere Aktionen in einer Richtlinie erfordern. Diese zusätzlichen Aktionen werden als abhängige Aktionen bezeichnet.

Schließen Sie Aktionen in eine Richtlinie ein, um Berechtigungen zur Durchführung der zugeordneten Operation zu erteilen.

Richtlinienaktionen in Amazon Kendra verwenden das folgende Präfix vor der Aktion:kendra:. Um beispielsweise jemandem die Erlaubnis zu erteilen, Amazon Kendra Kendra-Indizes mit der ListIndicesAPI-Operation aufzulisten, nehmen Sie die kendra:ListIndices Aktion in seine Richtlinie auf. Richtlinienanweisungen müssen entweder ein – Actionoder ein NotAction-Element enthalten. Amazon Kendra definiert eigene Aktionen, die Aufgaben beschreiben, die Sie mit diesem Service ausführen können.

Um mehrere Aktionen in einer einzigen Anweisung anzugeben, trennen Sie sie wie folgt durch Kommata:

"Action": [
      "kendra:action1",
      "kendra:action2"

Sie können auch Platzhalter verwenden, um mehrere Aktionen anzugeben. Beispielsweise können Sie alle Aktionen festlegen, die mit dem Wort Describe beginnen, einschließlich der folgenden Aktion:

"Action": "kendra:Describe*"

Eine Liste der Amazon Kendra-Aktionen finden Sie unter Von Amazon Kendra definierte Aktionen im IAM-Benutzerhandbuch.

Ressourcen

Administratoren können mithilfe von AWS JSON-Richtlinien angeben, wer Zugriff auf was hat. Das heißt, welcher Prinzipal Aktionen für welche Ressourcen und unter welchen Bedingungen ausführen kann.

Das JSON-Richtlinienelement Resource gibt die Objekte an, auf welche die Aktion angewendet wird. Anweisungen müssen entweder ein – Resourceoder ein NotResource-Element enthalten. Als bewährte Methode geben Sie eine Ressource mit dem zugehörigen Amazon-Ressourcennamen (ARN) an. Sie können dies für Aktionen tun, die einen bestimmten Ressourcentyp unterstützen, der als Berechtigungen auf Ressourcenebene bezeichnet wird.

Verwenden Sie für Aktionen, die keine Berechtigungen auf Ressourcenebene unterstützen, z. B. Auflistungsoperationen, einen Platzhalter (*), um anzugeben, dass die Anweisung für alle Ressourcen gilt.

"Resource": "*"

Die Amazon Kendra Kendra-Indexressource hat den folgenden ARN:

arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}

Weitere Informationen zum Format von ARNs finden Sie unter Amazon Resource Names (ARNs) und AWS Service Namespaces.

Um beispielsweise einen Index in Ihrer Anweisung anzugeben, verwenden Sie die GUID des Indexes im folgenden ARN:

"Resource": "arn:aws:kendra:${Region}:${Account}:index/${GUID}"

Um alle Indizes anzugeben, die zu einem bestimmten Konto gehören, verwenden Sie den Platzhalter (*):

"Resource": "arn:aws:${Region}:${Account}:index/*"

Einige Amazon Kendra Kendra-Aktionen, z. B. zum Erstellen von Ressourcen, können nicht für eine bestimmte Ressource ausgeführt werden. In diesen Fällen müssen Sie den Platzhalter (*) verwenden.

"Resource": "*"

Eine Liste der Amazon Kendra-Ressourcentypen und ihrer Eigenschaften ARNs finden Sie unter Von Amazon Kendra definierte Ressourcen im IAM-Benutzerhandbuch. Informationen darüber, mit welchen Aktionen Sie den ARN jeder Ressource angeben können, finden Sie unter Von Amazon Kendra definierte Aktionen.

Bedingungsschlüssel

Administratoren können mithilfe von AWS JSON-Richtlinien angeben, wer Zugriff auf was hat. Das heißt, welcher Prinzipal kann Aktionen für welche Ressourcen und unter welchen Bedingungen ausführen.

Das Element Condition (oder Condition block) ermöglicht Ihnen die Angabe der Bedingungen, unter denen eine Anweisung wirksam ist. Das Element Condition ist optional. Sie können bedingte Ausdrücke erstellen, die Bedingungsoperatoren verwenden, z. B. ist gleich oder kleiner als, damit die Bedingung in der Richtlinie mit Werten in der Anforderung übereinstimmt.

Wenn Sie mehrere Condition-Elemente in einer Anweisung oder mehrere Schlüssel in einem einzelnen Condition-Element angeben, wertet AWS diese mittels einer logischen AND-Operation aus. Wenn Sie mehrere Werte für einen einzelnen Bedingungsschlüssel angeben, AWS wertet die Bedingung mithilfe einer logischen OR Operation aus. Alle Bedingungen müssen erfüllt werden, bevor die Berechtigungen der Anweisung gewährt werden.

Sie können auch Platzhaltervariablen verwenden, wenn Sie Bedingungen angeben. Beispielsweise können Sie einem IAM-Benutzer die Berechtigung für den Zugriff auf eine Ressource nur dann gewähren, wenn sie mit dessen IAM-Benutzernamen gekennzeichnet ist. Weitere Informationen finden Sie unter IAM-Richtlinienelemente: Variablen und Tags im IAM-Benutzerhandbuch.

AWS unterstützt globale Bedingungsschlüssel und dienstspezifische Bedingungsschlüssel. Eine Übersicht aller AWS globalen Bedingungsschlüssel finden Sie unter Kontextschlüssel für AWS globale Bedingungen im IAM-Benutzerhandbuch.

Amazon Kendra stellt keine dienstspezifischen Bedingungsschlüssel bereit, unterstützt jedoch die Verwendung einiger globaler Bedingungsschlüssel. Eine Übersicht aller AWS globalen Bedingungsschlüssel finden Sie unter AWS Globale Bedingungskontextschlüssel im IAM-Benutzerhandbuch.

Beispiele

Beispiele für identitätsbasierte Richtlinien von Amazon Kendra finden Sie unter. Beispiele für identitätsbasierte Richtlinien in Amazon Kendra

Ressourcenbasierte Richtlinien von Amazon Kendra

Amazon Kendra unterstützt keine ressourcenbasierten Richtlinien.

Zugriffskontrolllisten () ACLs

Amazon Kendra unterstützt keine Zugriffskontrolllisten (ACLs) für den Zugriff auf AWS Dienste und Ressourcen.

Autorisierung basierend auf Amazon Kendra Kendra-Tags

Sie können Tags mit bestimmten Arten von Amazon Kendra Kendra-Ressourcen verknüpfen, um den Zugriff auf diese Ressourcen zu autorisieren. Um den Zugriff anhand von Tags zu steuern, geben Sie Tag-Informationen im Bedingungselement einer Richtlinie anaws:RequestTag/key-name, indem Sie die aws:TagKeys Bedingungstasten oder verwenden.

In der folgenden Tabelle sind die Aktionen, die entsprechenden Ressourcentypen und Bedingungsschlüssel für die Tag-basierte Zugriffskontrolle aufgeführt. Jede Aktion wird basierend auf den Tags autorisiert, die dem entsprechenden Ressourcentyp zugeordnet sind.

Informationen zum Taggen von Amazon Kendra Kendra-Ressourcen finden Sie unter. Tags Ein Beispiel für eine identitätsbasierte Richtlinie, die den Zugriff auf eine Ressource anhand von Ressourcen-Tags einschränkt, finden Sie unter. Beispiel für eine tagbasierte Richtlinie Weitere Informationen zur Verwendung von Tags zur Beschränkung des Zugriffs auf Ressourcen finden Sie unter Steuern des Zugriffs mithilfe von Tags im IAM-Benutzerhandbuch.

Amazon Kendra IAM-Rollen

Eine IAM-Rolle ist eine Entität innerhalb Ihres AWS Kontos, die über bestimmte Berechtigungen verfügt.

Temporäre Anmeldeinformationen mit Amazon Kendra verwenden

Sie können temporäre Anmeldeinformationen verwenden, um sich über einen Verbund anzumelden, eine IAM-Rolle anzunehmen oder eine kontenübergreifende Rolle anzunehmen. Sie erhalten temporäre Sicherheitsanmeldedaten, indem Sie AWS STS API-Operationen wie AssumeRoleoder GetFederationTokenaufrufen.

Amazon Kendra unterstützt die Verwendung temporärer Anmeldeinformationen.

Servicerollen

Dieses Feature ermöglicht einem Service das Annehmen einer Servicerolle in Ihrem Namen. Diese Rolle gewährt dem Service Zugriff auf Ressourcen in anderen Diensten, um eine Aktion in Ihrem Namen auszuführen. Servicerollen werden in Ihrem IAM-Konto angezeigt und gehören zum Konto. Dies bedeutet, dass ein IAM-Administrator die Berechtigungen für diese Rolle ändern kann. Dies kann jedoch die Funktionalität des Dienstes beeinträchtigen.

Amazon Kendra unterstützt Servicerollen.

Auswahl einer IAM-Rolle in Amazon Kendra

Wenn Sie einen Index erstellen, den BatchPutDocument Vorgang aufrufen, eine Datenquelle erstellen oder eine häufig gestellte Frage erstellen, müssen Sie eine Zugriffsrolle angeben, die Amazon Resource Name (ARN) Amazon Kendra um in Ihrem Namen auf die erforderlichen Ressourcen zuzugreifen. Wenn Sie zuvor eine Rolle erstellt haben, bietet Ihnen die Amazon Kendra Kendra-Konsole eine Liste von Rollen, aus denen Sie wählen können. Es ist wichtig, eine Rolle auszuwählen, die den Zugriff auf die Ressourcen ermöglicht, die Sie benötigen. Weitere Informationen finden Sie unter IAM Zugriffsrollen für Amazon Kendra.