Conector Amazon S3
O Adobe Experience Platform fornece conectividade nativa para provedores de nuvem, como o AWS, Google Cloud Platform, e Azure. Você pode trazer seus dados desses sistemas para Platform.
As fontes de armazenamento na nuvem podem trazer seus próprios dados para Platform sem a necessidade de baixar, formatar ou fazer upload. Os dados assimilados podem ser formatados como XDM JSON, XDM Parquet ou delimitados. Cada etapa do processo é integrada ao fluxo de trabalho Origens. Platform O permite trazer dados do S3 por meio de lotes.
LISTA DE PERMISSÕES de endereço IP
Uma lista de endereços IP deve ser adicionada a uma lista de permissões antes de trabalhar com conectores de origem. Falha ao adicionar endereços IP específicos da região à lista de permissões pode levar a erros ou ao não desempenho ao usar origens. Consulte a LISTA DE PERMISSÕES de endereço IP para obter mais informações.
Restrições de nomenclatura para arquivos e diretórios
Veja a seguir uma lista de restrições que você deve considerar ao nomear seu arquivo ou diretório de armazenamento em nuvem.
- Os nomes dos componentes de diretório e arquivo não podem exceder 255 caracteres.
- Nomes de diretório e arquivo não podem terminar com uma barra (
/). Se fornecido, ele será removido automaticamente. - Os seguintes caracteres de URL reservados devem ter escape adequado:
! ' ( ) ; @ & = + $ , % # [ ] - Os seguintes caracteres não são permitidos:
" \ / : | < > * ?. - Caracteres de caminho de URL inválidos não permitidos. Pontos de código como
\uE000, embora sejam válidos em nomes de arquivo NTFS, não são caracteres Unicode válidos. Além disso, alguns caracteres ASCII ou Unicode, como caracteres de controle (0x00 a 0x1F, \u0081 etc.), também não são permitidos. Para obter as regras que regem strings Unicode em HTTP/1.1, consulte RFC 2616, Seção 2.2: regras básicas e RFC 3987. - Os seguintes nomes de arquivo não são permitidos: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, caractere de ponto (.) e dois caracteres de ponto (…).
Pré-requisitos prerequisites
Para assimilar um único diretório com S3, você deve criar um Identity and Access Management (IAM) para a Platform no console S3 e atribuir permissões para as seguintes ações:
s3:GetObjects3:GetObjectVersion
As seguintes permissões também são necessárias para explorar e testar a conectividade:
s3:ListAllMyBucketss3:ListBuckets3:GetBucketLocation
Um caminho de arquivo, como myBucket/folder/subfolder/subsubfolder/abc.csv pode levá-lo a acessar somente subsubfolder/abc.csv. Se quiser acessar a subpasta, especifique o bucket parâmetro no console S3 como myBucket e a variável folderPath as folder/subfolder para garantir que a exploração de arquivos comece em subfolder em vez de subsubfolder/abc.csv.
Usar credenciais de segurança temporárias para se conectar Amazon S3
Você pode se conectar Amazon S3 com credenciais de segurança temporárias usando o s3SessionToken. Isso permite conectar Amazon S3 para a Platform sem precisar criar credenciais permanentes do IAM com o Amazon Web Servicesou forneça acesso ao seu Amazon S3 bucket para usuários em ambientes não confiáveis.
As credenciais de segurança temporárias funcionam de forma semelhante às credenciais de chave de acesso comuns e de longo prazo, exceto que você pode configurar uma data de expiração mais curta para suas credenciais temporárias. As expirações podem ser definidas para alguns minutos após a ativação ou para até várias horas. Credenciais temporárias também não estão contidas com o usuário. Isso significa que você deve solicitar um novo conjunto de credenciais temporárias, quando elas expiram.
Para obter etapas sobre como gerar o token de sessão temporário, consulte esta AWS documento sobre tokens de sessão temporários
.
Conectar S3 ao Platform
A documentação abaixo fornece informações sobre como conectar o S3 ao Adobe Experience Platform usando APIs ou a interface do usuário: