Connettore Amazon S3

Adobe Experience Platform fornisce connettività nativa per i provider di cloud come AWS, Google Cloud Platform, e Azure. È possibile inserire i dati da questi sistemi in Platform.

Le origini di archiviazione cloud possono inserire i tuoi dati in Platform senza dover scaricare, formattare o caricare. I dati acquisiti possono essere formattati come XDM JSON, XDM Parquet o delimitati. Ogni passaggio del processo viene integrato nel flusso di lavoro Origini. Platform consente di inserire dati da S3 tramite batch.

ELENCO CONSENTITI di indirizzo IP

Prima di utilizzare i connettori di origine, è necessario aggiungere un elenco di indirizzi IP a un elenco consentiti. La mancata aggiunta all’elenco consentiti degli indirizzi IP specifici per l’area geografica potrebbe causare errori o prestazioni non ottimali durante l’utilizzo delle origini. Consulta la ELENCO CONSENTITI di indirizzo IP per ulteriori informazioni.

Vincoli di denominazione per file e directory

Di seguito è riportato un elenco di vincoli di cui è necessario tenere conto per la denominazione del file di archiviazione cloud o della directory.

• I nomi dei componenti di directory e file non possono superare i 255 caratteri.
• I nomi di file e directory non possono terminare con una barra (/). Se fornito, verrà rimosso automaticamente.
• I seguenti caratteri URL riservati devono avere un escape corretto: ! ' ( ) ; @ & = + $ , % # [ ]
• I seguenti caratteri non sono consentiti: " \ / : | < > * ?.
• Caratteri di percorso URL non validi non consentiti. Punti di codice come \uE000, anche se valido nei nomi di file NTFS, non è costituito da caratteri Unicode validi. Inoltre, alcuni caratteri ASCII o Unicode, come i caratteri di controllo (da 0x00 a 0x1F, \u0081, ecc.), non sono consentiti. Per le regole che disciplinano le stringhe Unicode in HTTP/1.1, consulta RFC 2616, sezione 2.2: regole di base e RFC 3987.
• Non sono consentiti i seguenti nomi di file: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, carattere punto (.) e due caratteri punto (…).

Prerequisiti

Per acquisire una singola directory con S3, è necessario creare un Identity and Access Management (IAM) utente per Platform nella console S3 e assegna le autorizzazioni per le seguenti azioni:

• s3:GetObject
• s3:GetObjectVersion

Per esplorare e testare la connettività sono necessarie anche le seguenti autorizzazioni:

• s3:ListAllMyBuckets
• s3:ListBucket
• s3:GetBucketLocation

Un percorso file come myBucket/folder/subfolder/subsubfolder/abc.csv può comportare solo l'accesso subsubfolder/abc.csv. Se desideri accedere alla sottocartella, puoi specificare bucket parametro nella console S3 come myBucket e folderPath as folder/subfolder per fare in modo che l'esplorazione dei file inizi alle subfolder anziché subsubfolder/abc.csv.

Usa credenziali di sicurezza temporanee per la connessione Amazon S3

È possibile connettersi Amazon S3 con credenziali di sicurezza temporanee utilizzando s3SessionToken. Consente di connettersi Amazon S3 su Platform senza dover creare credenziali IAM permanenti con Amazon Web Services, o fornire accesso al Amazon S3 agli utenti in ambienti non attendibili.

Le credenziali di sicurezza temporanee funzionano in modo simile alle normali credenziali chiave di accesso a lungo termine, tranne per il fatto che è possibile configurare una data di scadenza più breve per le credenziali temporanee. Le scadenze possono essere impostate su pochi minuti dopo l’attivazione o su diverse ore. Inoltre, le credenziali temporanee non sono contenute con l’utente. Ciò significa che è necessario richiedere un nuovo set di credenziali temporanee alla scadenza.

Per informazioni su come generare il token di sessione temporaneo, consulta AWS documento su token di sessione temporanei
.

Connetti S3 a Platform

La documentazione seguente fornisce informazioni su come collegare S3 a Adobe Experience Platform utilizzando le API o l’interfaccia utente:

Utilizzo delle API

• Creare una connessione di base S3 utilizzando l’API del servizio Flow
• Esplorare la struttura dati e il contenuto di un’origine di archiviazione cloud utilizzando l’API del servizio Flusso
• Creare un flusso di dati per un’origine di archiviazione cloud utilizzando l’API del servizio Flusso

Utilizzo dell’interfaccia utente

• Creare una connessione sorgente Amazon S3 nell’interfaccia utente
• Creare un flusso di dati per una connessione all’archiviazione cloud nell’interfaccia utente