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.
Zugreifen auf kontoübergreifende Ressourcen mit AWS IoT Regeln
Sie können AWS IoT Regeln für den kontoübergreifenden Zugriff konfigurieren, sodass Daten, die zu MQTT-Themen eines Kontos aufgenommen wurden, an die AWS Dienste, wie Amazon SQS und Lambda, eines anderen Kontos weitergeleitet werden können. Im Folgenden wird erklärt, wie Sie AWS IoT Regeln für die kontoübergreifende Datenaufnahme von einem MQTT-Thema in einem Konto zu einem Ziel in einem anderen Konto einrichten.
Cross-account Regeln können mithilfe ressourcenbasierter Berechtigungen für die Zielressource konfiguriert werden. Daher können nur Ziele, die ressourcenbasierte Berechtigungen unterstützen, für den kontoübergreifenden Zugriff mithilfe von Regeln aktiviert werden. AWS IoT Zu den unterstützten Zielen gehören Amazon SQS, Amazon SNS, Amazon S3 und AWS Lambda.
Anmerkung
Für die unterstützten Ziele, mit Ausnahme von Amazon SQS, müssen Sie die Regel genauso definieren AWS-Region wie die Ressource eines anderen Dienstes, damit die Regelaktion mit dieser Ressource interagieren kann. Weitere Informationen zu AWS IoT Regelaktionen finden Sie unter AWS IoT Regelaktionen. Weitere Informationen zur SQS-Aktion der Regel finden Sie unterSQS.
Voraussetzungen
-
Vertrautheit mit AWS IoT Regeln
-
Ein Verständnis von IAM-Benutzern, -Rollen und ressourcenbasierten Berechtigungen
-
Nach der AWS CLI Installation
Cross-account für Amazon SQS einrichten
Szenario: Konto A sendet Daten aus einer MQTT-Nachricht an die Amazon SQS-Warteschlange von Konto B.
| AWS-Konto | Konto bezeichnet als | Description |
|---|---|---|
|
Konto A | Regelaktion: sqs:SendMessage |
|
Konto B | Amazon-SQS-Warteschlange
|
Anmerkung
Ihre Amazon SQS-Zielwarteschlange muss nicht mit Ihrer AWS-Region AWS IoT Regel übereinstimmen. Weitere Informationen zur SQS-Aktion der Regel finden Sie unter. SQS
Erledigen der Aufgaben von Konto A
Hinweis
Um die folgenden Befehle auszuführen, muss Ihr IAM-Benutzer über die Berechtigung iot:CreateTopicRule mit dem Amazon Resource Name (ARN) der Regel als Ressource und über die Berechtigung iam:PassRole Aktion mit einer Ressource als ARN der Rolle verfügen.
-
Konfigurieren Sie AWS CLI unter Verwendung des IAM-Benutzers von Konto A.
-
Erstellen Sie eine IAM-Rolle, die der AWS IoT Regel-Engine vertraut und eine Richtlinie anfügt, die den Zugriff auf die Amazon SQS-Warteschlange von Konto B ermöglicht. Beispielbefehle und Richtliniendokumente finden Sie unter Gewähren AWS IoT des erforderlichen Zugriffs.
-
Um eine Regel zu erstellen, die an ein Thema angehängt ist, führen Sie den Befehl create-topic-rule aus.
aws iot create-topic-rule --rule-namemyRule--topic-rule-payload file://./my-rule.jsonIm Folgenden finden Sie ein Beispiel für eine Nutzlastdatei mit einer Regel, die alle an das
iot/testThema gesendeten Nachrichten in die angegebene Amazon SQS-Warteschlange einfügt. Die SQL-Anweisung filtert die Nachrichten und der Rollen-ARN gewährt AWS IoT die Berechtigung, die Nachricht zur Amazon SQS-Warteschlange hinzuzufügen.{ "sql": "SELECT * FROM 'iot/test'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "sqs": { "queueUrl": "https://sqs.region.amazonaws.com/2222-2222-2222/ExampleQueue", "roleArn": "arn:aws:iam::1111-1111-1111:role/my-iot-role", "useBase64": false } } ] }Weitere Informationen zum Definieren einer Amazon SQS-Aktion in einer AWS IoT Regel finden Sie unter AWS IoT Regelaktionen — Amazon SQS.
Erledigen der Aufgaben von Konto B
-
Konfigurieren Sie AWS CLI mithilfe des IAM-Benutzers von Konto B.
-
Um Konto A Berechtigungen für die Amazon SQS-Warteschlangenressource zu erteilen, führen Sie den Befehl add-permission aus.
aws sqs add-permission --queue-urlhttps://sqs.region.amazonaws.com/2222-2222-2222/ExampleQueue--labelSendMessagesToMyQueue--aws-account-ids1111-1111-1111--actions SendMessage
Cross-account für Amazon SNS einrichten
Szenario: Konto A sendet Daten von einer MQTT-Nachricht an ein Amazon SNS Thema von Konto B.
| AWS-Konto | Konto bezeichnet als | Description |
|---|---|---|
|
Konto A | Regelaktion: sns:Publish |
|
Konto B | ARN des Amazon-SNS-Themas: |
Erledigen der Aufgaben von Konto A
Hinweise
Um die folgenden Befehle auszuführen, sollte Ihr IAM-Benutzer über Berechtigungen für die iot:CreateTopicRule Regel ARN als Ressource und über Berechtigungen für die iam:PassRole Aktion mit einer Ressource als Rolle ARN verfügen.
-
Konfigurieren Sie AWS CLI unter Verwendung des IAM-Benutzers von Konto A.
-
Erstellen Sie eine IAM-Rolle, die der AWS IoT Regel-Engine vertraut und eine Richtlinie anfügt, die den Zugriff auf das Amazon SNS-Thema von Konto B ermöglicht. Beispiele für Befehle und Richtliniendokumente finden Sie unter Gewähren AWS IoT des erforderlichen Zugriffs.
-
Um eine Regel zu erstellen, die an ein Thema angehängt ist, führen Sie den Befehl create-topic-rule aus.
aws iot create-topic-rule --rule-namemyRule--topic-rule-payload file://./my-rule.jsonIm Folgenden finden Sie ein Beispiel für eine Nutzlastdatei mit einer Regel, die alle an das
iot/testThema gesendeten Nachrichten in die angegebene -Amazon SNS Thema einfügt. Die SQL-Anweisung filtert die Nachrichten, und die Rollen-ARN gewährt AWS IoT Berechtigungen zum Senden der Nachricht an das Amazon SNS Thema.{ "sql": "SELECT * FROM 'iot/test'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "sns": { "targetArn": "arn:aws:sns:region:2222-2222-2222:ExampleTopic", "roleArn": "arn:aws:iam::1111-1111-1111:role/my-iot-role" } } ] }Weitere Informationen zum Definieren einer Amazon SNS-Aktion in einer AWS IoT Regel finden Sie unter AWS IoT Regelaktionen — Amazon SNS.
Erledigen der Aufgaben von Konto B
-
Konfigurieren Sie AWS CLI mithilfe des IAM-Benutzers von Konto B.
-
Um Konto A die Erlaubnis für die Amazon SNS-Themenressource zu erteilen, führen Sie den Befehl add-permission aus.
aws sns add-permission --topic-arnarn:aws:sns:region:2222-2222-2222:ExampleTopic--labelPublish-Permission--aws-account-id1111-1111-1111--action-name Publish
Cross-account für Amazon S3 einrichten
Szenario: Konto A sendet Daten von einer MQTT-Nachricht an einen Amazon-S3-Bucket von Konto B.
| AWS-Konto | Konto bezeichnet als | Description |
|---|---|---|
|
Konto A | Regelaktion: s3:PutObject |
|
Konto B | Amazon S3-Bucket ARN: |
Erledigen der Aufgaben von Konto A
Hinweis
Um die folgenden Befehle auszuführen, sollte Ihr IAM-Benutzer über Berechtigungen für iot:CreateTopicRule mit der Regel ARN als Ressource und über Berechtigungen für iam:PassRole Aktionen mit einer Ressource als Rolle ARN verfügen.
-
Konfigurieren Sie AWS CLI unter Verwendung des IAM-Benutzers von Konto A.
-
Erstellen Sie eine IAM-Rolle, die der AWS IoT Regel-Engine vertraut und eine Richtlinie anhängt, die den Zugriff auf den Amazon S3-Bucket von Konto B ermöglicht. Beispiele für Befehle und Richtliniendokumente finden Sie unter Gewähren AWS IoT des erforderlichen Zugriffs.
-
Um eine Regel zu erstellen, die an Ihren Ziel-S3-Bucket angehängt ist, führen Sie den Befehl create-topic-rule aus.
aws iot create-topic-rule --rule-namemy-rule--topic-rule-payload file://./my-rule.jsonIm Folgenden finden Sie ein Beispiel für eine Nutzlastdatei mit einer Regel, die alle an das
iot/testThema gesendeten Nachrichten in den angegebenen Amazon S3-Bucket einfügt. Die SQL-Anweisung filtert die Nachrichten und der Rollen-ARN gewährt AWS IoT die Berechtigung zum Hinzufügen der Nachricht zum Amazon S3-Bucket.{ "sql": "SELECT * FROM 'iot/test'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "s3": { "bucketName": "amzn-s3-demo-bucket", "key": "${topic()}/${timestamp()}", "roleArn": "arn:aws:iam::1111-1111-1111:role/my-iot-role" } } ] }Weitere Informationen zum Definieren einer Amazon S3-Aktion in einer AWS IoT Regel finden Sie unter AWS IoT Regelaktionen — Amazon S3.
Erledigen der Aufgaben von Konto B
-
Konfigurieren Sie AWS CLI mithilfe des IAM-Benutzers von Konto B.
-
Erstellen Sie eine Bucket-Richtlinie, die dem Prinzipal von Konto A vertraut.
Im Folgenden finden Sie ein Beispiel für eine Payload-Datei, die eine Bucket-Richtlinie definiert, die dem Prinzipal eines anderen Kontos vertraut.
-
{ "Version":"2012-10-17", "Statement": [ { "Sid": "AddCannedAcl", "Effect": "Allow", "Principal": { "AWS": [ "arn:aws:iam::123456789012:root" ] }, "Action": "s3:PutObject", "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*" } ] }
Weitere Informationen finden Sie unter Beispiele für Bucket-Richtlinien.
-
Um die Bucket-Richtlinie an den angegebenen Bucket anzuhängen, führen Sie den Befehl put-bucket-policy aus.
aws s3api put-bucket-policy --bucket amzn-s3-demo-bucket --policy file://./amzn-s3-demo-bucket-policy.json -
Damit der kontoübergreifende Zugriff funktioniert, stellen Sie sicher, dass Sie die richtigen Einstellungen für Blockieren des gesamten öffentlichen Zugangs ausgewählt haben. Weitere Informationen finden Sie unter Bewährte Methoden für die Sicherheit in Amazon S3.
Cross-account eingerichtet für AWS Lambda
Szenario: Konto A ruft eine AWS Lambda Funktion von Konto B auf und übergibt eine MQTT-Nachricht.
| AWS-Konto | Konto bezeichnet als | Description |
|---|---|---|
|
Konto A | Regelaktion: lambda:InvokeFunction |
|
Konto B | ARN der Lambda-Funktion: |
Erledigen der Aufgaben von Konto A
Hinweise
Um die folgenden Befehle ausführen zu können, sollte Ihr IAM-Benutzer über Berechtigungen für iot:CreateTopicRule mit der Regel ARN als Ressource und über Berechtigungen für iam:PassRole Aktionen mit der Ressource als Rolle ARN verfügen.
-
Konfigurieren Sie AWS CLI unter Verwendung des IAM-Benutzers von Konto A.
-
Führen Sie den Befehl create-topic-rule aus, um eine Regel zu erstellen, die den kontoübergreifenden Zugriff auf die Lambda-Funktion von Konto B definiert.
aws iot create-topic-rule --rule-namemy-rule--topic-rule-payload file://./my-rule.jsonIm Folgenden finden Sie ein Beispiel für eine Nutzlastdatei mit einer Regel, die alle an das
iot/testThema gesendeten Nachrichten in die angegebene Lambda-Funktion einfügt. Die SQL-Anweisung filtert die Nachrichten und die Rolle ARN erteilt AWS IoT die Berechtigung, die Daten an die Lambda-Funktion zu übergeben.{ "sql": "SELECT * FROM 'iot/test'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "lambda": { "functionArn": "arn:aws:lambda:region:2222-2222-2222:function:example-function" } } ] }Weitere Informationen zum Definieren einer AWS Lambda Aktion in einer AWS IoT Regel finden Sie unter AWS IoT Regelaktionen — Lambda.
Erledigen der Aufgaben von Konto B
-
Konfigurieren Sie AWS CLI mithilfe des IAM-Benutzers von Konto B.
-
Führen Sie den Befehl add-permission von Lambda aus, um AWS IoT Regeln die Berechtigung zur Aktivierung der Lambda-Funktion zu erteilen. Um den folgenden Befehl auszuführen, sollte Ihr IAM-Benutzer über die entsprechende Berechtigung für
lambda:AddPermissionAktion verfügen.aws lambda add-permission --function-nameexample-function--regionus-east-1--principal iot.amazonaws.com --source-arnarn:aws:iot:region:1111-1111-1111:rule/example-rule--source-account1111-1111-1111--statement-id"unique_id"--action "lambda:InvokeFunction"Optionen:
--Prinzipal
Dieses Feld erteilt die Erlaubnis AWS IoT (dargestellt durch
iot.amazonaws.com), die Lambda-Funktion aufzurufen.--source-arn
Dieses Feld bestätigt, dass diese Lambda-Funktion nur
arn:aws:iot:region:1111-1111-1111:rule/example-rulein AWS IoT Triggern und keine andere Regel in demselben oder einem anderen Konto diese Lambda-Funktion aktivieren kann.--source-account
Dieses Feld bestätigt, dass diese Lambda-Funktion nur im Namen des
1111-1111-1111Kontos AWS IoT aktiviert wird.Hinweise
Wenn Sie in der Konsole Ihrer AWS Lambda Funktion unter Konfiguration die Fehlermeldung „Die Regel konnte nicht gefunden werden“ sehen, ignorieren Sie die Fehlermeldung und fahren Sie mit dem Testen der Verbindung fort.