Amazon S3 origem

IMPORTANT
Agora você pode usar a origem Amazon S3 ao executar o Adobe Experience Platform no Amazon Web Services (AWS). O Experience Platform em execução no AWS está disponível atualmente para um número limitado de clientes. Para saber mais sobre a infraestrutura do Experience Platform compatível, consulte a visão geral da nuvem múltipla do Experience Platform.

O Adobe Experience Platform fornece conectividade nativa para provedores de nuvem, como AWS, Google Cloud Platform e Azure. Você pode trazer seus dados desses sistemas para a Experience Platform.

As fontes de armazenamento na nuvem podem trazer seus próprios dados para a Experience Platform sem a necessidade de baixar, formatar ou carregar. Os dados assimilados podem ser formatados como XDM JSON, XDM Parquet ou delimitados. Cada etapa do processo é integrada ao fluxo de trabalho Origens. O Experience Platform permite trazer dados do S3 por meio de lotes.

Configure sua origem Amazon S3 para o Experience Platform no Azure azure

Siga as etapas abaixo para saber como configurar sua conta do Amazon S3 para o Experience Platform no Azure.

INCLUI NA LISTA DE PERMISSÕES de endereço IP para conexão no Azure

Você deve adicionar endereços IP específicos da sua região ao incluo na lista de permissões antes de conectar suas fontes à Experience Platform no Azure. Para obter mais informações, leia o manual sobre sobre como ler os endereços IP de incluir na lista de permissões para se conectar ao Experience Platform no Azure 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 um 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 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 regras que regem cadeias de caracteres 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 (…).

Configurar permissões em Amazon S3

Para assimilar um único diretório com S3, você deve criar um usuário Identity and Access Management (IAM) para o Experience Platform no console S3 e atribuir permissões para as seguintes ações:

  • s3:GetObject
  • s3:GetObjectVersion

As seguintes permissões também são necessárias para explorar e testar a conectividade:

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

Um caminho de arquivo como myBucket/folder/subfolder/subsubfolder/abc.csv pode levá-lo a acessar apenas subsubfolder/abc.csv. Se quiser acessar a subpasta, você pode especificar o parâmetro bucket no console S3 como myBucket e o folderPath como folder/subfolder para garantir que a exploração do arquivo comece em subfolder, e não em subsubfolder/abc.csv.

Usar credenciais de segurança temporárias para conectar Amazon S3

Você pode conectar Amazon S3 com credenciais de segurança temporárias usando o s3SessionToken. Isso permite que você conecte o Amazon S3 ao Experience Platform sem ter que criar credenciais permanentes do IAM com Amazon Web Services ou fornecer acesso ao seu bucket do Amazon S3 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 este AWS documento sobre tokens de sessão temporários.

Configure sua origem do Amazon S3 para o Experience Platform no Amazon Web Services aws

AVAILABILITY
Esta seção se aplica às implementações do Experience Platform em execução no Amazon Web Services (AWS). O Experience Platform em execução no AWS está disponível atualmente para um número limitado de clientes. Para saber mais sobre a infraestrutura do Experience Platform compatível, consulte a visão geral da nuvem múltipla do Experience Platform.

Siga as etapas abaixo para saber como configurar sua conta do Amazon S3 para o Experience Platform no Amazon Web Services (AWS).

Pré-requisitos

Para conectar sua conta do Amazon S3 ao Experience Platform no AWS, você deve ter o seguinte:

  • Uma conta da AWS com acesso ao bucket ou pasta Amazon S3 que você deseja conectar.
  • As permissões IAM necessárias que permitem s3:GetObject e s3:ListBucket ações.

INCLUI NA LISTA DE PERMISSÕES de endereço IP para conexão no AWS

Você deve adicionar endereços IP específicos da sua região à inclui na lista de permissões antes de conectar suas fontes à Experience Platform no AWS. Para obter mais informações, leia o manual sobre sobre como ler os endereços IP de incluir na lista de permissões para se conectar ao Experience Platform no AWS para obter mais informações.

Acessar a origem Amazon S3 na interface do usuário

  • Navegue até o catálogo de origens na interface do usuário do Experience Platform.
  • Selecione Amazon S3 e depois selecione Nova conta.
  • Incluir na lista de permissões Copie a Função IAM listada em Adicionar Função IAM à. Posteriormente, você usará essa função do IAM para configurar permissões para o bucket do Amazon S3.

A página de autenticação da nova conta do Amazon S3.

Configurar permissões

Você deve configurar as permissões necessárias no bucket Amazon S3 para assimilar dados com êxito de uma região do AWS. A política do bucket que você deseja acessar deve estar associada às credenciais que você está usando.

Siga as etapas abaixo para atualizar a classificação Amazon S3:

  • Faça logon em sua conta no Console de Gerenciamento do AWS.
  • Navegue até o bucket Amazon S3 e selecione Permissions.
  • Edite a política de bucket e adicione as seguintes permissões:
TIP
Atualize o valor de AWS com sua função de IAM e o valor de Resource com seu bucket ou pasta Amazon S3.
{
    "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}"
        }
    ]
}

Forneça os detalhes da conexão do Amazon S3 e valide e finalize a conexão

Depois de configurar suas permissões, retorne ao catálogo de origens na interface do usuário do Experience Platform e navegue até a página de configuração de origem Amazon S3. Forneça o nome do bucket Amazon S3 ao qual você deseja se conectar e, se aplicável, forneça o caminho para a pasta específica do bucket. Para verificar sua configuração, selecione Testar conexão. Se tiver êxito, você poderá continuar e criar um fluxo de dados para assimilar dados de armazenamento na nuvem para o Experience Platform.

Próximas etapas

A documentação abaixo fornece informações sobre como conectar o Amazon S3 ao Experience Platform usando APIs ou a interface do usuário:

Conectar o Amazon S3 ao Experience Platform usando a API

Conectar o Amazon S3 ao Experience Platform usando a interface

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089