Centro de suporte da Workiva

Com o conector Amazon® S3®, você pode usar comandos em uma cadeia para interagir com o Amazon Simple Storage Service® (S3). Por exemplo, com esse conector, você pode:

• Criar e gerenciar buckets S3
• Listar e excluir objetos S3
• Fazer upload, download e copiar arquivos no S3

Observação: Esse conector foi criado pela Workiva e se conecta a um sistema de terceiros. Embora nossa equipe de suporte possa ajudar a configurar esse conector no seu espaço de trabalho, não podemos solucionar problemas ou ajudar com problemas que se originem fora da plataforma Workiva.

Pré-requisitos

Para ativar a conexão com o Amazon S3, o conector usa a interface de linha de comando (CLI) do Amazon Web Services® (AWS) para o S3. Para configurar o conector, você precisará de:

• Um usuário de integração designado criado no Amazon S3 para o conector
• O ID e o segredo da chave de acesso do usuário de integração
• O código para a região da AWS para se conectar a
• Para uma instância S3 hospedada em um endereço diferente do endpoint padrão, o URL ao qual se conectar

Crie um usuário de integração do AWS para o conector

1. Em o console da AWS, clique em IAM em Security, Identity, & Compliance.
   
2. Na guia Users, clique em Add User.
3. Em Set user details, insira um nome exclusivo para ajudar a identificar o usuário de integração, como Workiva.
   
4. Em Selecione o tipo de acesso AWS, selecione Programmatic access e clique em Next: Permissions.
5. Clique em Anexar políticas existentes diretamente, selecione uma política que ofereça suporte ao acesso ao S3, como AmazonS3FullAccess, e clique em Next: Tags.
   
6. Adicione as tags opcionais para identificar ou esclarecer melhor a intenção do usuário e clique em Next: Revise.
7. Revise os detalhes e as permissões do usuário e clique em Create user.
8. Registre o ID e o segredo da chave de acesso do usuário para a configuração do conector.

Configurar o conector do Amazon S3

Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização primeiro o habilita em Configuração.

1. Em Construtor de cadeia, clique em Conexões compare_arrows e, em seguida, Criar no canto superior direito.
2. Em Conector Conexão, selecione Amazon S3 e o CloudRunner padrão.
   
3. Em Basic Info, digite um nome e uma descrição exclusivos para ajudar a identificar o conector.
4. Em Propriedades, digite os detalhes da conexão:
   
   

   Propriedade	Detalhes
   ID da chave de acesso	Digite o ID da chave de acesso do usuário de integração.
   Chave de acesso Segredo	Digite o segredo da chave de acesso do usuário de integração.
   Região padrão	Digite o código para a região da AWS à qual deve se conectar.
   Ponto de extremidade alternativo	Para se conectar a uma instância do Amazon S3 hospedada em um endereço diferente do endpoint padrão, digite o URL do ponto de extremidade ao qual se conectar.

   Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia Advanced Encryption Standard (AES) 256.

5. Selecione os ambientes para usar a conexão e clique em Save.
6. Para testar a conexão, crie e execute uma cadeia com o comando List Buckets do conector e verifique se ele retorna uma saída válida.

Conexões S3 em conformidade com FIPS

Se você precisar de uma conexão S3 compatível com FIPS, consulte a página Amazon FIPS Endpoints by Service para localizar o endpoint necessário. Insira esse endpoint na configuração de comando do S3 no campo Alternate Endpoint.

Solução de problemas

Se a conexão com o Amazon S3 falhar:

• Verifique o ID da chave de acesso e o segredo do usuário de integração.
• Verifique o código de região AWS inserido para o conector.
• Se a sua instância do Amazon S3 estiver hospedada em um endereço diferente do ponto de extremidade padrão, verifique o URL do ponto de extremidade alternativo.