Amazon S3

Adobe Experience Platform bietet native Konnektivität für Cloud-Anbieter wie AWS, Google Cloud Platform und Azure. Sie können Ihre Daten aus diesen Systemen in Experience Platform übertragen.

Cloud-Speicherquellen können Ihre eigenen Daten in Experience Platform übertragen, ohne sie herunterladen, formatieren oder hochladen zu müssen. Aufgenommene Daten können als XDM JSON, XDM Parquet oder mit Trennzeichen formatiert werden. Jeder Schritt des Prozesses wird in den Quell-Workflow integriert. Mit Experience Platform können Sie Daten von S3 über Batches importieren.

Voraussetzungen prerequisites

In diesem Abschnitt werden die Schritte beschrieben, die Sie vor dem Verbinden Ihres Amazon S3-Kontos mit Experience Platform ausführen müssen.

IP-Adressen-Zulassungsliste

Vor der Arbeit mit Quell-Connectoren muss einer Zulassungsliste eine Liste von IP-Adressen hinzugefügt werden. Wenn Sie Ihre regionsspezifischen IP-Adressen nicht zu Ihrer Zulassungsliste hinzufügen, kann dies bei der Verwendung von Quellen zu Fehlern oder Performance-Einbußen führen. Weitere Information finden Sie unter IP-Adressen-Zulassungsliste.

Namensbeschränkungen für Dateien und Verzeichnisse

Im Folgenden finden Sie eine Liste von Einschränkungen, die Sie beim Benennen Ihrer Cloud-Speicherdatei oder Ihres Verzeichnisses berücksichtigen müssen.

Konfigurieren von Berechtigungen für Amazon S3

Um ein einzelnes Verzeichnis mit S3 aufzunehmen, müssen Sie in der S3-Konsole einen Identity and Access Management (IAM)-Benutzer für Platform erstellen und Berechtigungen für die folgenden Aktionen zuweisen:

Die folgenden Berechtigungen sind ebenfalls erforderlich, um Konnektivität zu untersuchen und zu testen:

Ein Dateipfad wie myBucket/folder/subfolder/subsubfolder/abc.csv kann dazu führen, dass Sie nur auf subsubfolder/abc.csv zugreifen. Wenn Sie auf den Unterordner zugreifen möchten, können Sie den bucket-Parameter in Ihrer S3-Konsole als myBucket und den folderPath als folder/subfolder angeben, um sicherzustellen, dass die Dateiexploration bei subfolder und nicht bei subsubfolder/abc.csv beginnt.

Temporäre Sicherheitsanmeldeinformationen zur Verbindung von Amazon S3 verwenden

Sie können Amazon S3 über die s3SessionToken mit temporären Sicherheitsberechtigungen verbinden. Auf diese Weise können Sie Amazon S3 mit Platform verbinden, ohne dauerhafte IAM-Anmeldeinformationen mit Amazon Web Services erstellen zu müssen, oder Benutzern in nicht vertrauenswürdigen Umgebungen Zugriff auf Ihren Amazon S3 Bucket gewähren.

Temporäre Sicherheitsanmeldeinformationen funktionieren ähnlich wie normale, langfristige Zugriffsschlüssel-Anmeldeinformationen, mit dem Unterschied, dass Sie ein kürzeres Ablaufdatum für Ihre temporären Anmeldeinformationen konfigurieren können. Gültigkeiten können auf wenige Minuten nach der Aktivierung oder auf mehrere Stunden eingestellt werden. Temporäre Anmeldeinformationen sind ebenfalls nicht im Benutzerhandbuch enthalten. Das bedeutet, dass Sie nach Ablauf neue temporäre Anmeldeinformationen anfordern müssen.

Anweisungen zum Generieren Ihres temporären Sitzungs-Tokens finden Sie in diesem AWS Dokument zu temporären Sitzungs-Token.

Einrichten einer Amazon S3 für das Experience Platform auf Amazon Web Services aws

Gehen Sie wie folgt vor, um zu erfahren, wie Sie Ihr Amazon S3-Konto für das Experience Platform auf Amazon Web Services (AWS) einrichten können.

Voraussetzungen

Um Ihr Amazon S3-Konto mit Experience Platform auf AWS zu verbinden, benötigen Sie Folgendes:

Zugriff auf die Amazon S3 in der Benutzeroberfläche

Berechtigungen einrichten

Sie müssen die erforderlichen Berechtigungen in Ihrem Amazon S3-Bucket konfigurieren, um Daten aus einer AWS-Region erfolgreich aufzunehmen. Die Richtlinie des Buckets, auf den Sie zugreifen möchten, muss mit den von Ihnen verwendeten Anmeldeinformationen verknüpft sein.

Gehen Sie wie folgt vor, um Ihren Amazon S3 zu aktualisieren:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AEP Get Object Related Policy Prod",
            "Effect": "Allow",
            "Principal": {
                "AWS": "{IAM_ROLE_TO_ALLOW_LIST}"
            },
            "Action": "s3:Get*",
            "Resource": "arn:aws:s3:::{YOUR_BUCKET_NAME}/{YOUR_FOLDER_NAME}"
        },
        {
            "Sid": "AEP List Bucket Prod",
            "Effect": "Allow",
            "Principal": {
                "AWS": "{IAM_ROLE_TO_ALLOW_LIST}"
            },
            "Action": "s3:ListBucket",
            "Resource": "arn:aws:s3:::{YOUR_BUCKET_NAME}"
        }
    ]
}

Geben Sie Ihre Amazon S3 Verbindungsdetails an und validieren und schließen Sie die Verbindung ab

Nachdem Sie Ihre Berechtigungen eingerichtet haben, kehren Sie zum Quellkatalog in der Experience Platform-Benutzeroberfläche zurück und navigieren Sie zur Seite Amazon S3-Quelleinrichtung . Geben Sie den Namen des Amazon S3 Buckets an, mit dem Sie eine Verbindung herstellen möchten, und geben Sie gegebenenfalls den Pfad zum bestimmten Ordner innerhalb des Buckets an. Um Ihr Setup zu überprüfen, wählen Sie Verbindung testen aus. Bei Erfolg können Sie dann fortfahren und einen Datenfluss erstellen, um Cloud-Speicherdaten auf Experience Platform aufzunehmen.

Nächste Schritte

Die folgende Dokumentation enthält Informationen zum Verbinden von Amazon S3 mit Experience Platform mithilfe von APIs oder der Benutzeroberfläche:

Verbinden von Amazon S3 mit Experience Platform mithilfe der API

Verbinden von Amazon S3 mit Experience Platform über die Benutzeroberfläche