Amazon S3

Amazon S3 ist ein hoch skalierbares Speichersystem, das von Amazon Web Services angeboten wird.

Wichtig

Wenn Sie zwischen Cloud-Speicheranbietern wechseln, wenden Sie sich an Ihren CSM von Braze, um weitere Unterstützung bei der Einrichtung und Validierung Ihrer neuen Integration zu erhalten.

Die Integration von Braze und Amazon S3 bietet zwei Integrationsstrategien:

• Nutzen Sie Currents, um Ihre Daten dort zu speichern, bis Sie sie mit anderen Plattformen, Tools und Standorten verbinden möchten.
• Verwenden Sie Dashboard-Datenexporte (wie CSV-Exporte und Engagement-Berichte).

Voraussetzungen

Einen neuen S3-Bucket erstellen

Gehen Sie wie folgt vor, um einen Bucket für Ihre App zu erstellen:

1. Öffnen Sie die Amazon S3-Konsole und folgen Sie den Anweisungen, um sich anzumelden (Sign in) oder ein Konto zu erstellen (Create an Account with AWS).
2. Wählen Sie nach der Anmeldung S3 in der Kategorie Storage & Content Delivery aus.
3. Wählen Sie auf dem nächsten Bildschirm Create Bucket aus.
4. Erstellen Sie Ihren Bucket, wenn Sie dazu aufgefordert werden, und wählen Sie eine AWS-Region aus.

In Braze können Sie im Dashboard keine Region auswählen oder konfigurieren. Die AWS-Region ergibt sich daraus, wo Sie den Bucket in der AWS-Konsole erstellen. Die Integration sendet Daten an den von Ihnen angegebenen Bucket-Namen, und AWS leitet Anfragen automatisch an die Region des Buckets weiter. Wenn Ihr Konnektor versucht, eine Verbindung zu einer anderen als der gewünschten Region herzustellen (zum Beispiel eu-west-1 statt eu-central-1), erstellen oder verwenden Sie in AWS einen S3-Bucket in der gewünschten Region. Auf der Seite von Braze müssen Sie nichts ändern.

Hinweis

Currents unterstützt keine Buckets, für die Object Lock konfiguriert ist.

Integration

Braze bietet zwei verschiedene Integrationsstrategien mit Amazon S3: eine für Braze-Currents und eine für alle Datenexporte aus dem Dashboard (z. B. CSV-Exporte oder Engagement-Berichte). Beide Integrationen unterstützen zwei verschiedene Authentifizierungs- bzw. Autorisierungsmethoden:

• Methode mit AWS-Secret-Access-Key
• Methode mit AWS-Rollen-ARN

Authentifizierungsmethode mit AWS-Geheimschlüssel

Diese Authentifizierungsmethode generiert einen geheimen Schlüssel und eine Zugriffsschlüssel-ID, mit denen sich Braze als Nutzer:in in Ihrem AWS-Konto authentifizieren kann, um Daten in Ihren Bucket zu schreiben.

Schritt 1: Nutzer:in erstellen

Hinweis

Wenn Sie nur die Nachrichtenarchivierung einrichten, folgen Sie den Schritten im Tab Dashboard Data Export.

Um Ihre Zugriffsschlüssel-ID und Ihren geheimen Zugriffsschlüssel abzurufen, erstellen Sie in AWS eine IAM-Nutzer:in und eine Administratorgruppe.

Schritt 2: Zugangsdaten abrufen

Nachdem Sie eine neue Nutzer:in erstellt haben, wählen Sie Show User Security Credentials aus, um Ihre Zugriffsschlüssel-ID und Ihren geheimen Zugriffsschlüssel anzuzeigen. Notieren Sie diese Zugangsdaten anschließend oder wählen Sie den Button Download Credentials aus, da Sie sie später im Braze-Dashboard eingeben müssen.

Schritt 3: Richtlinie erstellen

Navigieren Sie zu Policies > Get Started > Create Policy, um Berechtigungen für Ihre Nutzer:in hinzuzufügen. Wählen Sie anschließend Create Your Own Policy aus. Dadurch werden nur eingeschränkte Berechtigungen vergeben, sodass Braze ausschließlich auf die angegebenen Buckets zugreifen kann.

Hinweis

Für Currents und Dashboard Data Export sind unterschiedliche Richtlinien erforderlich. s3:GetObject ist erforderlich, damit das Braze-Backend die Fehlerbehandlung durchführen kann.

Geben Sie einen Richtliniennamen Ihrer Wahl an und fügen Sie das folgende Code-Snippet in den Abschnitt Policy Document ein. Ersetzen Sie dabei INSERTBUCKETNAME durch Ihren Bucket-Namen. Ohne diese Berechtigungen schlägt die Prüfung der Zugangsdaten fehl und die Integration wird nicht erstellt.

Hinweis

Wenn Sie nur die Nachrichtenarchivierung einrichten, verwenden Sie das Code-Snippet im Tab Dashboard Data Export.

• braze currents
• dashboard data export

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME"]
        },
        {
            "Effect": "Allow",
            "Action": ["s3:PutObject", "s3:GetObject"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME/*"]
        }
    ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME"]
        },
        {
            "Effect": "Allow",
            "Action": ["s3:GetObject", "s3:PutObject", "s3:DeleteObject"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME*", "arn:aws:s3:::INSERTBUCKETNAME/", "arn:aws:s3:::INSERTBUCKETNAME"]
        }
    ]
}

Schritt 4: Richtlinie zuweisen

Nachdem Sie eine neue Richtlinie erstellt haben, gehen Sie zu Users und wählen Sie Ihre jeweilige Nutzer:in aus. Wählen Sie im Tab Permissions die Option Attach Policy aus und wählen Sie die neu erstellte Richtlinie aus. Jetzt können Sie Ihre AWS-Zugangsdaten mit Ihrem Braze-Konto verknüpfen.

Schritt 5: Braze mit AWS verknüpfen

Hinweis

Wenn Sie nur die Nachrichtenarchivierung einrichten, folgen Sie den Schritten im Tab Dashboard Data Export.

• braze currents
• dashboard data export

Gehen Sie in Braze zu Partnerintegrationen > Currents.

Wählen Sie anschließend Neuen Current erstellen und dann Amazon S3 Datenexport aus.

Geben Sie Ihrem Current einen Namen. Vergewissern Sie sich im Abschnitt Zugangsdaten, dass AWS Secret Access Key ausgewählt ist, und geben Sie dann Ihre S3-Zugriffs-ID, Ihren geheimen AWS-Zugriffsschlüssel und Ihren AWS S3-Bucket-Namen in die entsprechenden Felder ein.

Geben Sie eine Kontakt-E-Mail-Adresse für Benachrichtigungen bei Integrationsfehlern an. Braze sendet Benachrichtigungen an diese Adresse, wenn bei der Integration Fehler auftreten, z. B. Probleme mit Anmeldedaten oder der Konnektivität. Um sicherzustellen, dass die richtigen Personen Benachrichtigungen erhalten, verwenden Sie einen Verteiler oder eine Gruppen-E-Mail-Adresse.

Warnung

Halten Sie Ihre AWS-Zugriffsschlüssel-ID und Ihren geheimen Zugriffsschlüssel auf dem neuesten Stand. Wenn die Zugangsdaten Ihres Konnektors ablaufen, sendet der Konnektor keine Events mehr. Hält dieser Zustand länger als 5 Tage an, werden die Events des Konnektors verworfen und die Daten gehen dauerhaft verloren.

Sie können je nach Bedarf außerdem die folgenden Anpassungen vornehmen:

• Ordnerpfad: Standardmäßig currents. Wenn dieser Ordner nicht existiert, erstellt Braze ihn automatisch für Sie.
• Serverseitige AES-256-Verschlüsselung im Ruhezustand: Standardmäßig AUS; enthält den Header x-amz-server-side-encryption.

Wählen Sie Current starten aus, um fortzufahren.

Eine Benachrichtigung informiert Sie darüber, ob Ihre Zugangsdaten erfolgreich validiert wurden. AWS S3 ist jetzt für Braze-Currents eingerichtet.

Gehen Sie in Braze zu Partnerintegrationen > Technologiepartner und wählen Sie Amazon S3 aus.

Vergewissern Sie sich auf der Seite AWS-Zugangsdaten, dass AWS Secret Access Key ausgewählt ist, und geben Sie dann Ihre AWS-Zugriffs-ID, Ihren geheimen AWS-Zugriffsschlüssel und Ihren AWS S3-Bucket-Namen in die entsprechenden Felder ein. Wählen Sie bei der Eingabe Ihres geheimen Schlüssels zuerst Zugangsdaten testen aus, um sicherzustellen, dass Ihre Zugangsdaten funktionieren, und wählen Sie bei Erfolg Speichern aus.

Tipp

Sie können jederzeit neue Zugangsdaten abrufen, indem Sie in der AWS-Konsole zu Ihrer Nutzer:in navigieren und im Tab Security Credentials die Option Create Access Key auswählen.

Eine Benachrichtigung informiert Sie darüber, ob Ihre Zugangsdaten erfolgreich validiert wurden. AWS S3 ist jetzt in Ihr Braze-Konto integriert.

Authentifizierungsmethode mit AWS-Rollen-ARN

Diese Authentifizierungsmethode erzeugt einen Amazon Resource Name (ARN) für eine Rolle. Damit kann sich das Amazon-Konto von Braze als Mitglied der Rolle authentifizieren, die Sie zum Schreiben von Daten in Ihren Bucket erstellt haben.

Schritt 1: Richtlinie erstellen

Melden Sie sich zunächst als Kontoadministrator:in bei der AWS Management Console an. Navigieren Sie in der AWS Console zum Bereich IAM, wählen Sie in der Navigationsleiste Policies aus und wählen Sie dann Create Policy.

Hinweis

Für Currents und den Dashboard-Datenexport sind unterschiedliche Richtlinien erforderlich. s3:GetObject ist erforderlich, damit das Braze-Backend Fehler behandeln kann.

Öffnen Sie den Tab JSON und geben Sie das folgende Code-Snippet im Abschnitt Policy Document ein. Ersetzen Sie dabei INSERTBUCKETNAME durch Ihren Bucket-Namen. Wählen Sie anschließend Review Policy.

Hinweis

Wenn Sie nur die Nachrichtenarchivierung einrichten, verwenden Sie das Code-Snippet im Tab Dashboard Data Export.

• braze currents
• dashboard data export

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME"]
        },
        {
            "Effect": "Allow",
            "Action": ["s3:PutObject", "s3:GetObject"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME/*"]
        }
    ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME"]
        },
        {
            "Effect": "Allow",
            "Action": ["s3:PutObject", "s3:GetObject","s3:DeleteObject"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME/*"]
        }
    ]
}

Geben Sie der Richtlinie anschließend einen Namen und eine Beschreibung und wählen Sie Create Policy.

Schritt 2: Rolle erstellen

Wählen Sie im selben IAM-Bereich der Konsole Roles > Create Role.

Rufen Sie Ihre Braze-Konto-ID und Ihre externe ID in Ihrem Braze-Konto ab:

• Currents: Gehen Sie in Braze zu Partnerintegrationen > Currents. Wählen Sie dann Neuen Current erstellen und anschließend Amazon S3 Datenexport. Hier finden Sie die Bezeichner, die Sie zum Erstellen Ihrer Rolle benötigen.
• Dashboard-Datenexport: Gehen Sie in Braze zu Partnerintegrationen > Technologie-Partner und wählen Sie Amazon S3. Hier finden Sie die Bezeichner, die Sie zum Erstellen Ihrer Rolle benötigen. (Erstellen Sie Ihre Rollen hier, wenn Sie nur die Nachrichtenarchivierung einrichten.)

Wählen Sie in der AWS Console als Typ für die vertrauenswürdige Entität Another AWS Account aus. Geben Sie Ihre Braze-Konto-ID an, aktivieren Sie das Kontrollkästchen Require external ID und geben Sie die externe ID von Braze ein. Wählen Sie anschließend Next.

Schritt 3: Richtlinie anhängen

Hängen Sie als Nächstes die zuvor erstellte Richtlinie an die Rolle an. Suchen Sie die Richtlinie über die Suchleiste und setzen Sie ein Häkchen daneben, um sie anzuhängen. Wählen Sie anschließend Next.

Geben Sie der Rolle einen Namen und eine Beschreibung und wählen Sie Create Role.

Ihre neu erstellte Rolle wird nun in der Liste angezeigt.

Schritt 4: Mit Braze AWS verknüpfen

Suchen Sie in der AWS Console Ihre neu erstellte Rolle in der Liste. Wählen Sie den Namen aus, um die Details dieser Rolle zu öffnen.

Notieren Sie sich den Role ARN oben auf der Übersichtsseite der Rolle.

Kehren Sie zu Ihrem Braze-Konto zurück und kopieren Sie den Rollen-ARN in das dafür vorgesehene Feld.

Hinweis

Wenn Sie nur die Nachrichtenarchivierung einrichten, folgen Sie den Schritten im Tab Dashboard Data Export.

• braze currents
• dashboard data export

Gehen Sie in Braze zu Partnerintegrationen > Currents. Wählen Sie dann Neuen Current erstellen und anschließend Amazon S3 Datenexport.

Geben Sie Ihrem Current einen Namen. Stellen Sie dann im Abschnitt Zugangsdaten sicher, dass AWS Role ARN ausgewählt ist, und geben Sie Ihren Rollen-ARN und den Namen Ihres AWS S3-Buckets in die entsprechenden Felder ein.

Geben Sie eine Kontakt-E-Mail-Adresse für Benachrichtigungen bei Integrationsfehlern an. Braze sendet Benachrichtigungen an diese Adresse, wenn bei der Integration Fehler auftreten, z. B. Probleme mit Anmeldedaten oder der Konnektivität. Um sicherzustellen, dass die richtigen Personen Benachrichtigungen erhalten, verwenden Sie einen Verteiler oder eine Gruppen-E-Mail-Adresse.

Je nach Bedarf können Sie außerdem die folgenden Anpassungen vornehmen:

• Ordnerpfad (Standard: currents)
• Serverseitige AES-256-Verschlüsselung im Ruhezustand (Standard: AUS) – fügt den Header x-amz-server-side-encryption hinzu

Wählen Sie Current starten, um fortzufahren. Eine Benachrichtigung zeigt an, ob Ihre Zugangsdaten erfolgreich validiert wurden. AWS S3 ist nun für Braze-Currents eingerichtet.

Wichtig

Wenn Sie den Fehler „S3 credentials are invalid“ erhalten, kann das daran liegen, dass Sie die Integration zu schnell nach dem Erstellen einer Rolle in AWS vorgenommen haben. Warten Sie und versuchen Sie es erneut. Wenn in der Meldung der Zugriff auf PutObject oder die serverseitige Verschlüsselung bei Dashboard-Datenexporten erwähnt wird, lesen Sie Fehlerbehebung bei S3-Zugangsdaten-Fehlern.

Gehen Sie in Braze unter Integrationen zur Seite Technologie-Partner und wählen Sie Amazon S3.

Stellen Sie auf der Seite AWS-Zugangsdaten sicher, dass das Optionsfeld AWS Role ARN ausgewählt ist, und geben Sie Ihren Rollen-ARN und den Namen Ihres AWS S3-Buckets in die entsprechenden Felder ein. Wählen Sie zuerst Zugangsdaten testen, um zu prüfen, ob Ihre Zugangsdaten korrekt funktionieren, und wählen Sie bei Erfolg Speichern.

Tipp

Sie können jederzeit neue Zugangsdaten abrufen, indem Sie in der AWS Console Ihr Nutzerkonto aufrufen und im Tab Security Credentials die Option Create Access Key wählen.

Eine Benachrichtigung informiert Sie, ob Ihre Zugangsdaten erfolgreich validiert wurden. AWS S3 ist nun in Ihr Braze-Konto integriert.

Sicherheitsaspekte bei der Rollen-ARN-Methode

Wenn Sie in Schritt 2 Another AWS Account auswählen und die Braze-Konto-ID eingeben, erstellt AWS eine Vertrauensrichtlinie, deren Principal der Root des Braze-AWS-Kontos ist (arn:aws:iam::<BRAZE_ACCOUNT_ID>:root). Wenn Ihr Sicherheitsteam diese Vertrauensrichtlinie prüft, beachten Sie Folgendes:

• Braze verwendet eine gemeinsam genutzte IAM-Nutzer:in, um Ihre Rolle zu übernehmen.
• Die externe ID ist erforderlich. Behalten Sie die Bedingung sts:ExternalId in Ihrer Vertrauensrichtlinie bei – auch dann, wenn Sie den Principal auf eine bestimmte IAM-Nutzer:in beschränken.
• Sie können den Principal auf eine bestimmte IAM-Nutzer:in beschränken. Wenn Ihre Sicherheitsrichtlinie es nicht erlaubt, einem Konto-Root zu vertrauen, können Sie den Principal durch den ARN der Braze-IAM-Nutzer:in ersetzen. Wenden Sie sich an den Braze-Support, um diesen ARN für Ihre Region zu erhalten.
• Die Braze-IAM-Nutzer:in kann sich ändern. Der Principal ist in der Regel stabil, Braze kann ihn aber künftig ändern. Wenn Sie Ihre Vertrauensrichtlinie auf eine bestimmte IAM-Nutzer:in beschränken und sich diese ändert, kann Braze Ihre Rolle erst wieder übernehmen, wenn Sie die Vertrauensrichtlinie aktualisieren.
• Die Principals unterscheiden sich je nach Produkt. Currents und Dashboard-Datenexporte verwenden dieselbe Braze-IAM-Nutzer:in. Cloud Data Ingestion verwendet einen anderen Principal in einem anderen AWS-Konto. Konfigurieren Sie die zugehörige Vertrauensrichtlinie daher separat.

Aktualisierung der Amazon S3-Zugangsdaten für Currents

Sie können die Amazon S3-Zugangsdaten eines bestehenden Braze-Currents-Konnektors aktualisieren, ohne die Integration zu stoppen oder bereits in Ihren Bucket exportierte Daten zu verlieren.

Um Zugangsdaten zu aktualisieren – oder zwischen AWS Secret Access Key und AWS Role ARN zu wechseln – führen Sie zunächst die IAM- und AWS-seitigen Schritte für Ihre gewählte Methode weiter oben in diesem Artikel durch (Richtlinien, Nutzer:in oder Rolle und Bezeichner nach Bedarf).

Wenn Sie die Zugangsdaten in AWS vorbereitet haben, gehen Sie in Braze zu Partnerintegrationen > Currents, suchen Sie Ihren Amazon S3-Konnektor in der Liste, wählen Sie Edit, aktualisieren Sie die Zugangsdaten und wählen Sie Update Current. Braze validiert die eingegebenen Zugangsdaten; Ihr Konnektor läuft weiter und die bereits in Ihrem Bucket vorhandenen Daten bleiben verfügbar. Weitere Informationen finden Sie unter Currents aktualisieren in Currents einrichten.

Wechseln Ihres Buckets für die Nachrichtenarchivierung

Die Nachrichtenarchivierung läuft weiter, während Sie zu einem neuen S3-Bucket oder einer neuen IAM-Rolle wechseln. Braze speichert Ihre neuen Einstellungen erst, nachdem der Test der Zugangsdaten erfolgreich war. So ist die Archivierung immer auf ein funktionierendes Ziel ausgerichtet.

Die Änderung wird nicht sofort wirksam. Für kurze Zeit nach dem Speichern verwendet Braze möglicherweise noch Ihre vorherigen Einstellungen:

• Ihr vorheriger Bucket erhält möglicherweise noch einige archivierte Nachrichten, zum Beispiel von Versendungen, die bereits im Gange waren.
• Ihre vorherige IAM-Rolle (wenn Sie die rollenbasierte Authentifizierung verwenden und den Rollen-ARN geändert haben) wird möglicherweise noch zum Schreiben in Ihren neuen Bucket verwendet.

Entziehen Sie den Zugriff auf Ihren vorherigen Bucket oder Ihre vorherige Rolle erst, wenn bereits seit mehreren Minuten neue Archive in Ihrem neuen Bucket eingehen. So stellen Sie sicher, dass die Migration abgeschlossen ist. Wenn Sie den Rollen-ARN ändern, stellen Sie sicher, dass die vorherige Rolle bis dahin ebenfalls in den neuen Bucket schreiben kann. Andernfalls werden Nachrichten, die während des Wechsels archiviert werden, möglicherweise nicht gespeichert, und es erfolgt kein erneuter Versuch.

Wie Currents Dateien in S3 hochlädt

Currents schließt jede Avro-Datei, sobald sie den Avro-Schreibschwellenwert erreicht, und lädt die fertige Datei dann mit dem mehrteiligen Upload von Amazon S3 in Teilen von 5 MB in Ihr Bucket hoch. Der mehrteilige Upload ist unabhängig vom Schreibschwellenwert und ist in der Regel innerhalb weniger Sekunden nach dem Schließen der Datei abgeschlossen.

Amazon S3 stellt einen laufenden mehrteiligen Upload nicht als Objekt bereit. Eine Currents-Datei wird für ListObjectsV2 und GetObject erst sichtbar, wenn der Upload abgeschlossen ist. Nachgelagerte Prozesse, die Ihr Bucket über die Standard-APIs von S3 auslesen, sehen daher keine teilweise hochgeladenen Dateien.

Exportverhalten

Nutzer:innen, die eine Cloud-Datenspeicherlösung integriert haben und APIs, Dashboard-Berichte oder CSV-Berichte exportieren, erleben Folgendes:

• Alle API-Exporte geben im Antwortkörper keine Download-URL zurück und müssen über den Datenspeicher abgerufen werden.
• Alle Dashboard-Berichte und CSV-Berichte werden zum Download an die E-Mail-Adresse der Nutzer:innen gesendet (keine Speicherberechtigungen erforderlich) und im Datenspeicher gesichert.

Fehler Unable to connect to S3, please validate that your credentials are correct

Wenn dieser Fehler beim Herunterladen eines CSV-Exports angezeigt wird, öffnen Sie die Amazon S3-Integration auf der Seite Technologiepartner und wählen Sie Zugangsdaten testen aus. Das Ergebnis erläutert, welche Validierung fehlgeschlagen ist. Beispielsweise fehlt dem Schlüssel möglicherweise die Berechtigung GetObject, wodurch Braze keine Download-Links generieren kann.

Aktualisieren Sie Ihre IAM-Richtlinie, damit die Integrationsnutzer:in oder -rolle s3:GetObject für den S3-Bucket und den Objektpfad aufrufen kann, die in Ihrer Braze-Integration konfiguriert sind. Weitere Probleme beim Export finden Sie unter Fehlerbehebung beim Export.

Wichtig

Anforderung an das JSON-Format: Für JSON-Exporte verwendet Braze das JSONL-Format (zeilengetrenntes JSON), bei dem jede Zeile ein separates JSON-Objekt enthält. Dieses Format unterscheidet sich von Standard-JSON, das aus einem einzelnen JSON-Array oder -Objekt besteht. Jede Zeile in der exportierten Datei ist ein gültiges JSON-Objekt, die Datei als Ganzes ist jedoch kein einzelnes gültiges JSON-Dokument. Parsen Sie bei der Verarbeitung dieser Dateien jede Zeile einzeln als separates JSON-Objekt, anstatt zu versuchen, die gesamte Datei als einzelnes JSON-Dokument zu parsen.

Currents-Exporte verwenden das Apache Avro-Format (.avro-Dateien), nicht JSON. Diese Anforderung an das JSON-Format gilt für Dashboard-Datenexporte und API-Exporte.

Mehrere Konnektoren

Wenn Sie mehr als einen Currents-Konnektor erstellen möchten, der Daten an Ihren S3-Bucket sendet, können Sie dieselben Zugangsdaten verwenden, müssen aber für jeden Konnektor einen anderen Ordnerpfad angeben. Sie können diese im selben Workspace erstellen oder sie auf mehrere Workspaces aufteilen. Außerdem haben Sie die Wahl, für jede Integration eine eigene Richtlinie zu erstellen oder eine einzige Richtlinie, die beide Integrationen abdeckt.

Wenn Sie denselben S3-Bucket sowohl für Currents als auch für Datenexporte verwenden möchten, müssen Sie zwei separate Richtlinien erstellen, da jede Integration unterschiedliche Berechtigungen benötigt.

Fehlerbehebung

Fehler: Das Konto hat keinen PutObject-Zugriff

Wenn beim Speichern von Amazon S3-Zugangsdaten für Dashboard-Datenexporte der folgende Fehler angezeigt wird, kann dies an falschen Berechtigungen oder an den Einstellungen für die serverseitige Verschlüsselung liegen.

1

S3 Credentials are invalid because this account does not have 'PutObject access'. Please check the permissions and ensure that this key has access to 'PutObject' in the 'CUSTOMER-BUCKET-HERE' bucket.

Um dieses Problem zu beheben, überprüfen Sie die folgenden Bereiche.

Falsche Bucket-Richtlinie

Vergewissern Sie sich, dass Sie eine Richtlinie mit den korrekten Berechtigungen erstellt haben, wie unter Amazon S3-Integration beschrieben (verwenden Sie die Richtlinie Dashboard Data Export für Ihre Authentifizierungsmethode).

Serverseitige Verschlüsselung

1

User: arn:aws:sts::XXX:assumed-role/braze-iam-role/braze is not authorized to perform: kms:GenerateDataKey on resource: arn:aws:XXX because no identity-based policy allows the kms:GenerateDataKey action

Wenn Sie diese Fehlermeldung vom Braze-Support oder in Ihren AWS-Logs erhalten, ist Ihr S3-Bucket mit der Verschlüsselung durch AWS Key Management Service (SSE-KMS) konfiguriert. Braze unterstützt SSE-KMS weder für Currents noch für Dashboard-Datenexporte. Um dieses Problem zu beheben, deaktivieren Sie SSE-KMS in Ihrem S3-Bucket.

Hinweis

Braze unterstützt die serverseitige Verschlüsselung mit von S3 verwalteten Schlüsseln (SSE-S3), die sowohl mit Currents als auch mit Dashboard-Datenexporten kompatibel ist.

Zusätzliche Berechtigungen überprüfen

Stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen verfügen, einschließlich s3:GetBucketLocation und s3:PutObject.