Hinweis zum Ende des Supports: Am 30. Oktober 2026 AWS wird der Support für Amazon Pinpoint eingestellt. Nach dem 30. Oktober 2026 können Sie nicht mehr auf die Amazon Pinpoint-Konsole oder die Amazon Pinpoint Pinpoint-Ressourcen (Endpunkte, Segmente, Kampagnen, Journeys und Analysen) zugreifen. Weitere Informationen finden Sie unter Ende des Supports von Amazon Pinpoint. Hinweis: APIs In Bezug auf SMS sind Sprach-, Handy-Push-, OTP- und Telefonnummernvalidierung von dieser Änderung nicht betroffen und werden von AWS End User Messaging unterstützt.

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.

Funktionsweise von Amazon Pinpoint mit IAM

Um Amazon Pinpoint verwenden zu können, benötigen Benutzer in Ihrem AWS Konto Berechtigungen, die es ihnen ermöglichen, Analysedaten einzusehen, Projekte zu erstellen, Benutzersegmente zu definieren, Kampagnen bereitzustellen und vieles mehr. Wenn Sie eine Mobil- oder Web-App in Amazon Pinpoint integrieren, benötigen Benutzer Ihrer App auch Zugriff auf Amazon Pinpoint. Dieser Zugriff ermöglicht es Ihrer App, Endpunkte zu registrieren und Nutzungsdaten an Amazon Pinpoint zu melden. Um Zugriff auf Amazon Pinpoint Pinpoint-Funktionen zu gewähren, erstellen Sie AWS Identity and Access Management (IAM-) Richtlinien, die Amazon Pinpoint Pinpoint-Aktionen für IAM-Identitäten oder Amazon Pinpoint Pinpoint-Ressourcen zulassen.

IAM ist ein Service, der Administratoren hilft, den Zugriff auf Ressourcen sicher zu kontrollieren. AWS IAM-Richtlinien beinhalten Anweisungen, die bestimmte Aktionen, die Benutzer auf bestimmten Ressourcen durchführen können, zulassen oder verweigern. Amazon Pinpoint stellt eine Reihe von Aktionen bereit, die Sie in IAM-Richtlinien verwenden können, um abgestufte Berechtigungen für Amazon-Pinpoint-Benutzer festzulegen. Sie können den angemessenen Zugriffsgrad für Amazon Pinpoint gewähren, ohne übermäßig lockere Richtlinien zu erstellen, die möglicherweise wichtige Daten gefährden oder Ihre Ressourcen beeinträchtigen könnten. Beispielsweise können Sie einem Amazon-Pinpoint-Administrator uneingeschränkten Zugriff und Personen, die nur Zugriff auf ein spezifisches Projekt benötigen, Lesezugriff erteilen.

Bevor Sie mit IAM den Zugriff auf Amazon Pinpoint verwalten können, sollten Sie sich darüber informieren, welche IAM-Features Sie mit Amazon Pinpoint verwenden können. Einen allgemeinen Überblick darüber, wie Amazon Pinpoint und andere AWS Services mit IAM zusammenarbeiten, finden Sie im AWS IAM-Benutzerhandbuch unter Services, die mit IAM funktionieren.

Identitätsbasierte Amazon-Pinpoint-Richtlinien

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 Pinpoint 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.

Dies bedeutet, dass Richtlinienaktionen steuern, was Benutzer auf der Amazon-Pinpoint-Konsole tun können. Sie kontrollieren auch, was Benutzer programmgesteuert tun können, indem sie den AWS SDKs, AWS Command Line Interface (AWS CLI) oder den Amazon APIs Pinpoint direkt verwenden.

Richtlinienaktionen in Amazon Pinpoint verwenden die folgenden Präfixe:

Um beispielsweise jemandem die Berechtigung zum Anzeigen von Informationen über alle Segmente für ein Projekt zu erteilen, wobei es sich um eine Aktion handelt, die der GetSegments-Operation in der Amazon-Pinpoint-API entspricht, schließen Sie die mobiletargeting:GetSegments-Aktion in ihre Richtlinie ein. Richtlinienanweisungen müssen entweder ein – Actionoder ein NotAction-Element enthalten. Amazon Pinpoint definiert eine eigene Gruppe von Aktionen, die Aufgaben beschreiben, die Benutzer damit durchführen können.

Um mehrere Aktionen in einer einzigen Anweisung anzugeben, trennen Sie sie mit Kommata:

"Action": [
      "mobiletargeting:action1",
      "mobiletargeting:action2"

Sie können auch mehrere Aktionen mittels Platzhaltern (*) angeben. Beispielsweise können Sie alle Aktionen festlegen, die mit dem Wort Get beginnen, einschließlich der folgenden Aktion:

"Action": "mobiletargeting:Get*"

Als bewährte Methode sollten Sie jedoch Richtlinien erstellen, die dem Prinzip der geringsten Rechte folgen. Mit anderen Worten: Sie sollten Richtlinien erstellen, die nur die Berechtigungen enthalten, die zum Ausführen einer bestimmten Aktion erforderlich sind.

Eine vollständige Liste der Amazon-Pinpoint-Aktionen, die Sie in IAM-Richtlinien verwenden können, finden Sie unter Amazon-Pinpoint-Aktionen für IAM-Richtlinien.

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": "*"

Beispielsweise ruft die mobiletargeting:GetSegments-Aktion Informationen über alle Segmente ab, die einem bestimmten Amazon-Pinpoint-Projekt zugeordnet sind. Sie identifizieren ein Projekt mit einem ARN im folgenden Format:

arn:aws:mobiletargeting:${Region}:${Account}:apps/${projectId}

Weitere Informationen zum Format von ARNs finden Sie unter Amazon Resource Names (ARNs) in der Allgemeine AWS-Referenz.

In IAM-Richtlinien können Sie die folgenden Arten von Amazon Pinpoint Pinpoint-Ressourcen angeben ARNs :

Um beispielsweise eine Richtlinienanweisung für das Projekt mit der Projekt-ID 810c7aab86d42fb2b56c8c966example zu erstellen, verwenden Sie den folgenden ARN:

"Resource": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/810c7aab86d42fb2b56c8c966example"

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

"Resource": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/*"

Einige Amazon-Pinpoint-Aktionen, z. B. zum Erstellen von Ressourcen, können auf bestimmten Ressourcen nicht ausgeführt werden. In diesen Fällen müssen Sie den Platzhalter (*) verwenden:

"Resource": "*"

In IAM-Richtlinien können Sie auch die folgenden Typen von Amazon Pinpoint SMS- und Voice-Ressourcen angeben ARNs :

Um beispielsweise eine Richtlinienerklärung für eine Telefonnummer mit der Rufnummern-ID zu erstellen, verwendet phone-12345678901234567890123456789012 den folgenden ARN:

"Resource": "arn:aws:sms-voice:us-east-1:123456789012:phone-number/phone-12345678901234567890123456789012"

Um alle Telefonnummern anzugeben, die zu einem bestimmten Konto gehören, verwenden Sie einen Platzhalter (*) anstelle der Rufnummer-ID:

"Resource": "arn:aws:sms-voice:us-east-1:123456789012:phone-number/*"

Einige SMS- und Sprachnachricht-Aktionen von Amazon Pinpoint werden nicht für eine bestimmte Ressource ausgeführt, z. B. für die Verwaltung von Einstellungen auf Kontoebene, wie Ausgabenlimits. In diesen Fällen müssen Sie den Platzhalter (*) verwenden:

"Resource": "*"

Bei einigen Amazon-Pinpoint-API-Aktionen sind mehrere Ressourcen beteiligt. Beispielsweise kann die TagResource-Aktion mehreren Projekten ein Tag hinzufügen. Um mehrere Ressourcen in einer einzigen Anweisung anzugeben, trennen Sie die ARNs durch Kommas voneinander:

"Resource": [
      "resource1",
      "resource2"

Eine Liste der Amazon Pinpoint-Ressourcentypen und ihrer Eigenschaften ARNs finden Sie unter Von Amazon Pinpoint definierte Ressourcen im IAM-Benutzerhandbuch. Informationen zu den Aktionen, mit denen Sie den ARN einzelner Ressourcen angeben können, finden Sie unter Von Amazon Pinpoint definierte Aktionen im IAM-Benutzerhandbuch.

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 Pinpoint definiert einen eigenen Satz von Bedingungsschlüsseln und unterstützt auch einige globale Bedingungsschlüssel. Eine Liste aller AWS globalen Bedingungsschlüssel finden Sie unter Kontextschlüssel für AWS globale Bedingungen im IAM-Benutzerhandbuch. Eine Liste der Amazon-Pinpoint-Bedingungsschlüssel finden Sie unter Bedingungsschlüssel für Amazon Pinpoint im IAM-Benutzerhandbuch. Informationen dazu, mit welchen Aktionen und Ressourcen Sie einen Bedingungsschlüssel verwenden können, finden Sie unter Von Amazon Pinpoint definierte Aktionen im IAM-Benutzerhandbuch.

Beispiele

Beispiele für identitätsbasierte Amazon-Pinpoint-Richtlinien finden Sie unter Beispiele für identitätsbasierte Amazon-Pinpoint-Richtlinien.

Amazon-Pinpoint-Richtlinien auf Basis von Ressourcenberechtigungen

Richtlinien auf Basis von Ressourcenberechtigungen sind JSON-Richtliniendokumente, die angeben, welche Aktionen ein bestimmter Auftraggeber auf einer Amazon-Pinpoint-Ressource durchführen kann und unter welchen Bedingungen. Amazon Pinpoint unterstützt Richtlinien auf Basis von Ressourcenberechtigungen für Kampagnen, Journeys, Nachrichtenvorlagen (Vorlagen), Empfehlungsmodelle (Empfehlungen), Projekte (Apps) und Segmente.

Beispiele

Beispiele für ressourcenbasierte Amazon-Pinpoint-Richtlinien finden Sie unter Beispiele für identitätsbasierte Amazon-Pinpoint-Richtlinien,

Autorisierung basierend auf Amazon-Pinpoint-Tags

Sie können Tags bestimmten Arten von Amazon-Pinpoint-Ressourcen zuordnen oder Tags in einer Anforderung an Amazon Pinpoint übergeben. Um den Zugriff auf der Grundlage von Tags zu steuern, geben Sie im Bedingungselement einer Richtlinie Tag-Informationen an, indem Sie die Schlüssel aws:ResourceTag/${TagKey}, aws:RequestTag/${TagKey}, oder Bedingung aws:TagKeys verwenden.

Hinweise zum Markieren von Amazon-Pinpoint-Ressourcen, einschließlich einer IAM-Beispielrichtlinie, finden Sie unter Amazon Pinpoint Pinpoint-Ressourcen-Tags verwalten.

Amazon-Pinpoint-IAM-Rollen

Eine IAM-Rolle ist eine Entität in Ihrem AWS -Konto mit spezifischen Berechtigungen.

Verwenden temporärer Anmeldeinformationen mit Amazon Pinpoint

Sie können temporäre Anmeldeinformationen verwenden, um sich mit dem Verbund anzumelden, eine IAM-Rolle zu übernehmen oder eine kontoübergreifende Rolle zu übernehmen. Sie erhalten temporäre Sicherheitsanmeldedaten, indem Sie API-Operationen AWS Security Token Service (AWS STS) wie AssumeRoleoder GetFederationTokenaufrufen.

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

Service-verknüpfte Rollen

Mit Diensten verknüpfte Rollen ermöglichen es AWS Diensten, auf Ressourcen in anderen Diensten zuzugreifen, um eine Aktion in Ihrem Namen auszuführen. Serviceverknüpfte Rollen werden in Ihrem IAM-Konto angezeigt und gehören zum Service. Ein IAM-Administrator kann die Berechtigungen für serviceverknüpfte Rollen anzeigen, aber nicht bearbeiten.

Amazon Pinpoint verwendet keine serviceverknüpften Rollen.

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 Pinpoint unterstützt die Verwendung von Servicerollen.