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.
# AWS IoT SiteWise identitätsbasierte Richtlinien
Mit IAM-Richtlinien können Sie kontrollieren, wer was tun kann. AWS IoT SiteWise Sie können entscheiden, welche Aktionen zulässig sind oder nicht, und spezifische Bedingungen für diese Aktionen festlegen. Sie können beispielsweise Regeln dafür festlegen, wer Informationen sehen oder ändern kann AWS IoT SiteWise. AWS IoT SiteWise 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html) im *IAM-Benutzerhandbuch*.
## Richtlinienaktionen
Administratoren können mithilfe von AWS JSON-Richtlinien angeben, wer auf was Zugriff 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. Nehmen Sie Aktionen in eine Richtlinie auf, um Berechtigungen zur Ausführung des zugehörigen Vorgangs zu erteilen.
Bei Richtlinienaktionen wird vor der Aktion das folgende Präfix AWS IoT SiteWise verwendet:`iotsitewise:`. Um beispielsweise jemandem die Erlaubnis zu erteilen, Objektdaten im Rahmen des `BatchPutAssetPropertyValue` API-Vorgangs hochzuladen, nehmen Sie die `iotsitewise:BatchPutAssetPropertyValue` Aktion in seine Richtlinie auf. AWS IoT SiteWise Richtlinienerklärungen müssen `Action` entweder ein `NotAction` Oder-Element enthalten. AWS IoT SiteWise definiert einen eigenen Satz von Aktionen, die Aufgaben beschreiben, die Sie mit diesem Dienst ausführen können.
Um mehrere -Aktionen in einer einzigen Anweisung anzugeben, trennen Sie sie folgendermaßen durch Kommas.
```
"Action": [
"iotsitewise:action1",
"iotsitewise:action2"
]
```
Sie können auch Platzhalter (\$1) verwenden, um mehrere Aktionen anzugeben. Beispielsweise können Sie alle Aktionen festlegen, die mit dem Wort `Describe` beginnen, einschließlich der folgenden Aktion:
```
"Action": "iotsitewise:Describe*"
```
Eine Liste der AWS IoT SiteWise [Aktionen finden Sie AWS IoT SiteWise im *IAM-Benutzerhandbuch* unter Definierte Aktionen von](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-actions-as-permissions).
### BatchPutAssetPropertyValue Autorisierung
AWS IoT SiteWise autorisiert den Zugriff auf die [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)Aktion auf ungewöhnliche Weise. Wenn Sie bei den meisten Aktionen den Zugriff zulassen oder verweigern, gibt diese Aktion einen Fehler zurück, wenn keine Berechtigungen erteilt wurden. Mit `BatchPutAssetPropertyValue` können Sie in einer einzigen API-Anfrage mehrere Dateneinträge an verschiedene Assets und Asset-Eigenschaften senden. AWS IoT SiteWise autorisiert jede Dateneingabe unabhängig. Fügt für jeden einzelnen Eintrag, bei dem die Autorisierung in der Anfrage fehlschlägt AWS IoT SiteWise , eine Fehlerliste `AccessDeniedException` in die zurückgegebene Liste ein. AWS IoT SiteWise empfängt die Daten für jeden Eintrag, der autorisiert wurde und erfolgreich ist, auch wenn ein anderer Eintrag in derselben Anfrage fehlschlägt.
**Wichtig**
Gehen Sie wie folgt vor, bevor Sie Daten in einen Datenstream aufnehmen:
Autorisieren Sie die `time-series` Ressource, wenn Sie einen Eigenschaftsalias verwenden, um den Datenstrom zu identifizieren.
Autorisieren Sie die `asset` Ressource, wenn Sie eine Asset-ID verwenden, um das Asset zu identifizieren, das die zugehörige Asset-Eigenschaft enthält.
## Richtlinienressourcen
Administratoren können mithilfe von AWS JSON-Richtlinien angeben, wer auf was Zugriff 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. Als Best Practice geben Sie eine Ressource mit dem zugehörigen [Amazon-Ressourcennamen (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) an. Verwenden Sie für Aktionen, die keine Berechtigungen auf Ressourcenebene unterstützen, einen Platzhalter (\$1), um anzugeben, dass die Anweisung für alle Ressourcen gilt.
```
"Resource": "*"
```
Jede IAM-Richtlinienerklärung gilt für die Ressourcen, die Sie mithilfe ihrer ARNs angeben. Ein ARN weist die folgende allgemeine Syntax auf:
```
arn:${Partition}:${Service}:${Region}:${Account}:${ResourceType}/${ResourcePath}
```
Weitere Informationen zum Format von ARNs finden Sie unter [Identifizieren von AWS Ressourcen mit Amazon-Ressourcennamen (ARNs)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html).
Um beispielsweise die Komponente mit der ID `a1b2c3d4-5678-90ab-cdef-22222EXAMPLE` in Ihrer Anweisung anzugeben, verwenden Sie den folgenden ARN.
```
"Resource": "arn:aws:iotsitewise:region:123456789012:asset/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE"
```
Um alle Datenströme anzugeben, die zu einem bestimmten Konto gehören, verwenden Sie den Platzhalter (\$1):
```
"Resource": "arn:aws:iotsitewise:region:123456789012:time-series/*"
```
Um alle Komponenten anzugeben, die zu einem bestimmten Konto gehören, verwenden Sie den Platzhalter (\$1).
```
"Resource": "arn:aws:iotsitewise:region:123456789012:asset/*"
```
Einige AWS IoT SiteWise Aktionen, z. B. die zum Erstellen von Ressourcen, können für eine bestimmte Ressource nicht ausgeführt werden. In diesen Fällen müssen Sie den Platzhalter (\$1) verwenden.
```
"Resource": "*"
```
Um mehrere Ressourcen in einer einzigen Anweisung anzugeben, trennen Sie sie ARNs durch Kommas.
```
"Resource": [
"resource1",
"resource2"
]
```
Eine Liste der AWS IoT SiteWise Ressourcentypen und ihrer ARNs Eigenschaften finden Sie unter [Ressourcentypen definiert von AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-resources-for-iam-policies) im *IAM-Benutzerhandbuch*. Informationen zu den Aktionen, mit denen Sie den ARN einzelner Ressourcen angeben können, finden Sie unter [Von AWS IoT SiteWise definierte Aktionen](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-actions-as-permissions).
## Bedingungsschlüssel für die Richtlinie
Administratoren können mithilfe von AWS JSON-Richtlinien angeben, wer auf was Zugriff hat. Das heißt, welcher **Prinzipal** **Aktionen** für welche **Ressourcen** und unter welchen **Bedingungen** ausführen kann.
Das Element `Condition` gibt an, wann Anweisungen auf der Grundlage definierter Kriterien ausgeführt werden. Sie können bedingte Ausdrücke erstellen, die [Bedingungsoperatoren](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html) verwenden, z. B. ist gleich oder kleiner als, damit die Bedingung in der Richtlinie mit Werten in der Anforderung übereinstimmt. Eine Übersicht aller AWS globalen Bedingungsschlüssel finden Sie unter [Kontextschlüssel für AWS globale Bedingungen](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) im *IAM-Benutzerhandbuch*.
**Wichtig**
Einige API-Aktionen verwenden mehrere Ressourcen. Viele Bedingungsschlüssel sind jedoch ressourcenspezifisch. Wenn Sie eine Richtlinienanweisung mit einem Bedingungsschlüssel schreiben, legen Sie über das `Resource`-Element der Anweisung fest, für welche Ressource der Bedingungsschlüssel gültig ist. Andernfalls verhindert die Richtlinie möglicherweise, dass Benutzer die Aktion überhaupt ausführen können, da die Bedingungsprüfung für die Ressourcen fehlschlägt, für die der Bedingungsschlüssel nicht gilt. Wenn Sie keine Ressource angeben möchten oder über das `Action`-Element Ihrer Richtlinie mehrere API-Aktionen hinzugefügt haben, müssen Sie mit dem `...IfExists`-Bedingungstyp sicherstellen, dass der Bedingungsschlüssel für die Ressourcen, die ihn nicht verwenden, ignoriert wird. [Weitere Informationen finden Sie unter... IfExists ](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html#Conditions_IfExists)Bedingungen im *IAM-Benutzerhandbuch*.
AWS IoT SiteWise definiert seinen eigenen Satz von Bedingungsschlüsseln und unterstützt auch die Verwendung einiger globaler Bedingungsschlüssel. Eine Übersicht aller AWS globalen Bedingungsschlüssel finden Sie unter [Kontextschlüssel für AWS globale Bedingungen](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) im *IAM-Benutzerhandbuch*.
**AWS IoT SiteWise Bedingungsschlüssel**
| Bedingungsschlüssel | Description | Typen |
| --- | --- | --- |
| iotsitewise:isAssociatedWithAssetProperty | Ob Datenströme mit einer Anlageneigenschaft verknüpft sind. Verwenden Sie diesen Bedingungsschlüssel, um Berechtigungen zu definieren, die auf dem Vorhandensein einer zugehörigen Asset-Eigenschaft für Datenstreams basieren. Beispielwert: `true` | Zeichenfolge |
| iotsitewise:assetHierarchyPath | Der Hierarchiepfad des Assets, bei dem es sich um eine Reihe von Assets handelt, die IDs jeweils durch einen Schrägstrich getrennt sind. Verwenden Sie diesen Bedingungsschlüssel, um Berechtigungen basierend auf einer Teilmenge Ihrer Hierarchie aller Komponenten in Ihrem Konto zu definieren. Beispielwert: `/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/a1b2c3d4-5678-90ab-cdef-66666EXAMPLE` | Zeichenfolge |
| iotsitewise:propertyId | Die ID einer Komponenteneigenschaft. Verwenden Sie diesen Bedingungsschlüssel, um Berechtigungen basierend auf der angegebenen Eigenschaft eines Komponentenmodells zu definieren. Dieser Bedingungsschlüssel gilt für alle Komponenten dieses Modells. Beispielwert: `a1b2c3d4-5678-90ab-cdef-33333EXAMPLE` | Zeichenfolge |
| iotsitewise:childAssetId | ID einer Komponente, die als untergeordnetes Element mit einer anderen Komponente verknüpft ist. Verwenden Sie diesen Bedingungsschlüssel, um Berechtigungen basierend auf untergeordneten Komponenten zu definieren. Um Berechtigungen basierend auf übergeordneten Komponenten zu definieren, verwenden Sie den Ressourcenabschnitt einer Richtlinienanweisung. Beispielwert: `a1b2c3d4-5678-90ab-cdef-66666EXAMPLE` | Zeichenfolge |
| iotsitewise:iam | Der ARN einer IAM-Identität beim Auflisten von Zugriffsrichtlinien. Verwenden Sie diesen Bedingungsschlüssel, um Zugriffsrichtlinienberechtigungen für eine IAM-Identität zu definieren. Beispielwert: `arn:aws:iam::123456789012:user/JohnDoe` | Zeichenfolge, Null |
| iotsitewise:propertyAlias | Der Alias, der eine Asset-Eigenschaft oder einen Datenstrom identifiziert. Verwenden Sie diesen Bedingungsschlüssel, um Berechtigungen auf der Grundlage des Alias zu definieren. | Zeichenfolge |
| iotsitewise:user | Die ID eines IAM Identity Center-Benutzers beim Auflisten von Zugriffsrichtlinien. Verwenden Sie diesen Bedingungsschlüssel, um Zugriffsrichtlinienberechtigungen für einen IAM Identity Center-Benutzer zu definieren. Beispielwert: `a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE` | Zeichenfolge, Null |
| iotsitewise:group | Die ID einer IAM Identity Center-Gruppe bei der Auflistung der Zugriffsrichtlinien. Verwenden Sie diesen Bedingungsschlüssel, um Zugriffsrichtlinienberechtigungen für eine IAM Identity Center-Gruppe zu definieren. Beispielwert: `a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE` | Zeichenfolge, Null |
| iotsitewise:portal | Die ID eines Portals in einer Zugriffsrichtlinie. Verwenden Sie diesen Bedingungsschlüssel, um Zugriffsrichtlinienberechtigungen basierend auf einem Portal zu definieren. Beispielwert: `a1b2c3d4-5678-90ab-cdef-77777EXAMPLE` | Zeichenfolge, Null |
| iotsitewise:project | Die ID eines Projekts in einer Zugriffsrichtlinie oder die ID eines Projekts für ein Dashboard. Verwenden Sie diesen Bedingungsschlüssel, um Dashboard- oder Zugriffsrichtlinienberechtigungen basierend auf einem Projekt zu definieren. Beispielwert: `a1b2c3d4-5678-90ab-cdef-88888EXAMPLE` | Zeichenfolge, Null |
Informationen zu den Aktionen und Ressourcen, mit denen Sie einen Bedingungsschlüssel verwenden können, finden Sie unter [Aktionen definiert von AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-actions-as-permissions).
## Beispiele
Beispiele für AWS IoT SiteWise identitätsbasierte Richtlinien finden Sie unter. [AWS IoT SiteWise Beispiele für identitätsbasierte Richtlinien](security_iam_id-based-policy-examples.md)