Módulos do AWS S3

Os módulos S3 Adobe Workfront Fusion AWS permitem executar operações em seus buckets S3.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso da funcionalidade neste artigo.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront

Qualquer pacote de fluxo de trabalho do Adobe Workfront e qualquer pacote do Adobe Workfront Automation and Integration

Workfront Ultimate

Os pacotes Workfront Prime e Select, com uma compra adicional do Workfront Fusion.

Licenças do Adobe Workfront

Padrão

Trabalho ou maior

Licença do Adobe Workfront Fusion

Baseado em operação: disponível para organizações com licenças baseadas em operação

Baseado em conector (legado): Workfront Fusion for Work Automation and Integration

Produto Se sua organização tiver um pacote Workfront Select ou Prime, ele não inclui o Workfront Automation and Integration. É necessário comprar o Adobe Workfront Fusion.

Para obter mais detalhes sobre as informações contidas nesta tabela, consulte Requisitos de acesso na documentação.

Para obter informações sobre licenças do Adobe Workfront Fusion, consulte Licenças do Adobe Workfront Fusion.

Pré-requisitos

Para usar os módulos do AWS S3, você deve ter uma conta Amazon Web Service.

Informações da API do AWS S3

O conector AWS S3 usa o seguinte:

URL básica
code language-none
https://s3.{{parameters.region}}.amazonaws.com
Tag da API
v1.5.21

Conectar o AWS ao Workfront Fusion connect-aws-to-workfront-fusion

Conectar o AWS ao Workfront Fusion usando uma conexão federada

Expanda para exibir instruções desse tipo de conexão.

Uma conexão federada permite que o Workfront Fusion acesse sua conta da AWS sem criar um usuário do IAM ou armazenar uma chave de acesso no Fusion.
Em vez disso, você registra o Workfront Fusion como um provedor de identidade confiável em sua conta do AWS e configura qual conexão única do Fusion tem permissão para usar uma função específica do IAM. Quando a conexão é executada, o Fusion apresenta uma prova de identidade de curta duração e o AWS retorna credenciais temporárias que expiram por conta própria. Nenhuma chave de vida longa é criada, armazenada ou girada.

note
NOTE
A configuração dessa conexão leva duas visitas ao console do AWS. Primeiro, você cria a função, depois cria a conexão no Workfront Fusion e, em seguida, retorna ao AWS para concluir a diretiva de confiança. Isso ocorre porque parte da diretiva de confiança identifica uma conexão específica e esse identificador não existe até que a conexão seja criada.

Pré-requisitos para conectar o AWS ao Workfront Fusion usando uma conexão federada

Para criar essa conexão, você precisa do seguinte:

  • Permissão no AWS IAM para criar um provedor de identidade e criar e editar funções. Isso geralmente significa a política ou equivalente. Se você não tiver esse acesso, pergunte a alguém na sua nuvem ou
    para concluir as etapas do AWS para você.
  • A capacidade de criar conexões no Workfront Fusion.

Adicionar o Workfront Fusion como um provedor de identidade no AWS

Essa etapa informa ao AWS que os tokens emitidos pelo Workfront Fusion podem ser confiáveis. Você faz isso uma vez por conta da AWS. Se alguém em sua organização já tiver adicionado esse provedor, pule para Criar a função IAM.

  1. Faça logon no console do AWS e acesse IAM > Provedores de identidade.

  2. Selecione Adicionar provedor.

  3. Para o tipo de Provedor, selecione OpenID Connect.

  4. Na URL do Provedor, insira o seguinte e selecione Obter impressão digital:

    code language-none
    https://oidc.automations.adobe.com
    
  5. Em Público-alvo, insira o seguinte:

    code language-none
    sts.amazonaws.com
    
  6. Selecione Adicionar provedor.

  7. Continue para Criar a função IAM.

Criar a função IAM

A função define o que a conexão tem permissão para fazer em sua conta da AWS. Você cria uma atribuição por conexão, para que cada acesso da conexão possa ser concedido e revogado independentemente.

  1. No IAM, vá para Funções e selecione Criar função.

  2. Para o tipo de entidade Confiável, selecione Identidade da Web.

  3. Em Provedor de identidade, selecione oidc.automations.adobe.com.

  4. Em Público, selecione sts.amazonaws.com.

  5. Selecione Avançar e anexe as políticas de permissões necessárias para esta conexão.
    Conceda somente as permissões que a conexão realmente usa. Por exemplo, uma conexão que só lê de
    um bucket não precisa de AmazonS3FullAccess.

  6. Dê à função um nome claro e reconhecível. Por exemplo, WorkfrontFusionFederatedConnection.

  7. Selecione Criar função.

  8. Abra a função que acabou de criar e copie seu ARN da área Resumo. Ela tem a seguinte aparência: arn:aws:iam::123456789012:role/WorkfrontFusionFederatedConnection

  9. Continue em Criar a conexão no Workfront Fusion.

Criar a conexão no Workfront Fusion

  1. Na tela de configuração de conexão do módulo, selecione o tipo de conexão federada.
  2. Insira o ARN de Função que você copiou em Criar a função IAM.
  3. Selecione Criar.
    O Workfront Fusion exibe três valores. Você as usa no próximo procedimento.
table 0-row-2 1-row-2 2-row-2 html-authored no-header
Central de Problemas Sempre https://oidc.automations.adobe.com. Corresponde ao provedor de identidade adicionado no AWS.
Assunto Identifica esta conexão. Parece com fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964. É diferente para cada conexão criada.
Público-alvo Sempre sts.amazonaws.com.
  1. Deixe esse painel aberto e copie o valor Subject.

    note
    NOTE
    Não feche o painel nem selecione Cancelar. A conexão não será concluída até que você conclua os procedimentos restantes. Se fechar o painel, você deverá excluir a conexão e iniciar novamente, pois uma nova conexão recebe um novo Assunto.
  2. Continue em Adicionar a conexão à diretiva de confiança da função.

Adicionar a conexão à diretiva de confiança da função

Até que você conclua esse procedimento, a função confia no Workfront Fusion em geral, mas ainda não permite que essa conexão específica a use.

  1. Em uma nova guia do navegador, retorne ao console AWS e abra a função criada.

  2. Selecione a guia Relações de confiança e selecione Editar diretiva de confiança.

  3. Substitua a política pelo seguinte, substituindo seus próprios valores:

    • Substituir 123456789012 pela ID de conta da AWS
    • Substitua o valor sub pelo Assunto copiado do Workfront Fusion.
    code language-none
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Principal": {
            "Federated": "arn:aws:iam::123456789012:oidc-provider/oidc.automations.adobe.com"
        },
        "Action": "sts:AssumeRoleWithWebIdentity", "Condition": {
         "StringEquals": {
           "oidc.automations.adobe.com:sub": "fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964",
           "oidc.automations.adobe.com:aud": "sts.amazonaws.com"
         }
        }
       }
     ]
    }
    
  4. Selecione Atualizar política.

  5. Continue em Verificar a conexão.

note tip
TIP
Para permitir que mais de uma conexão use a mesma função, liste os assuntos como uma matriz. O AWS permite que a função seja usada se o token corresponder a qualquer valor na lista:
code language-none
"oidc.automations.adobe.com:sub": [ "fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964", "fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:29011"
    ]
Não substitua o subvalor por um curinga. Isso permite que qualquer conexão em sua organização use a função, incluindo conexões criadas posteriormente por outras pessoas

Verifique a conexão

  1. Retorne à guia do navegador Workfront Fusion, onde o painel de conexão ainda está aberto.

  2. Clique em Salvar.

    O Workfront Fusion entra em contato com a AWS, que verifica a diretiva de confiança e retorna credenciais temporárias. Se tudo estiver configurado corretamente, a conexão será validada com êxito e você poderá continuar a configuração do módulo.
    Se a verificação falhar, o painel permanecerá aberto e exibirá o erro. Corrija o problema no AWS e selecione Salvar novamente. Não é necessário recriar a conexão, e o Assunto não é alterado.

A partir desse ponto, a conexão renova suas próprias credenciais. Não há chave para girar e nada expira que você precise manter.

Solução de problemas

table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored
Erro O que significa O que verificar
InvalidIdentityToken O AWS não pôde corresponder o token a um provedor de identidade registrado. Verifique se você adicionou o provedor de identidade descrito em Adicionar o Workfront Fusion como um provedor de identidade no AWS e se o URL é exatamente https://oidc.automations.adobe.com, sem a barra à direita.
Acesso Negado ao assumir a função O provedor de identidade está registrado, mas a diretiva de confiança não corresponde a esta conexão. Verifique se o subvalor na política de confiança é caractere por caractere idêntico ao Assunto mostrado no Workfront Fusion e se aud é sts.amazonaws.com. Um Assunto copiado de uma conexão diferente é a causa mais comum.
A conexão funciona, e depois falha Verifique se as políticas de permissões da função foram alteradas ou se a função foi excluída e recriada. Recriar uma função não altera seu ARN, mas redefine sua diretiva de confiança.

Conectar o AWS ao Workfront Fusion usando um usuário da API

Expanda para exibir instruções desse tipo de conexão.

Para conectar o AWS S3 ao Workfront Fusion, você deve conectar sua conta do AWS ao Workfront Fusion. Para fazer isso, primeiro será necessário criar um usuário de API no AWS IAM.

  1. Entre na sua conta do AWS IAM.

  2. Navegue até Gerenciamento de Identidade e Acesso > Gerenciamento de Acesso > Usuários.

  3. Clique em Adicionar usuário.

  4. Insira o nome do novo usuário e selecione a opção Acesso programático na seção Tipo de acesso.

  5. Clique em Anexar diretivas existentes diretamente e procure por AmazonS3FullAccess na barra de pesquisa. Clique nela quando ela aparecer, em seguida, clique em Avançar.

  6. Prossiga pelas outras telas de diálogo e clique em Criar Usuário.

  7. Copie a ID da chave de acesso e a chave de acesso secreta fornecidas.

  8. Vá para o Workfront Fusion e abra a caixa de diálogo Criar uma conexão do módulo AWS S3.

  9. Insira a ID da chave de acesso e a chave de acesso secreta da etapa 7 para os respectivos campos e clique em Continuar para estabelecer a conexão.

A conexão foi estabelecida. Você pode prosseguir com a configuração do módulo.

Módulos do AWS S3 e seus campos

Ao configurar módulos do AWS S3, o Workfront Fusion exibe os campos listados abaixo. Junto com eles, outros campos do AWS S3 podem ser exibidos, dependendo de fatores como seu nível de acesso no aplicativo ou serviço. Um título em negrito em um módulo indica um campo obrigatório.

Se você vir o botão de mapa acima de um campo ou função, poderá usá-lo para definir variáveis e funções para esse campo. Para obter mais informações, consulte Mapear informações de um módulo para outro.

Botão de alternância Mapear

Ações

Criar bloco

Esse módulo de ação cria um bucket no AWS.

Connection
Para obter instruções sobre como conectar sua conta do AWS ao Workfront Fusion, consulte Conectar AWS ao Workfront Fusion neste artigo.
Name
Informe o nome do novo período.
Região
Selecione seu ponto de extremidade regional. Para obter mais informações, consulte pontos de extremidade regionais na documentação do AWS.

Obter arquivo

Esse módulo de ação baixa um arquivo de um bucket.

Connection
Para obter instruções sobre como conectar sua conta do AWS ao Workfront Fusion, consulte Conectar AWS ao Workfront Fusion neste artigo.
Região
Selecione seu ponto de extremidade regional. Para obter mais informações, consulte pontos de extremidade regionais na documentação AWS.
Compartimento
Selecione o bucket do qual deseja baixar o arquivo.
Path
Insira o caminho para o arquivo. Exemplo: /photos/2019/February/image023.jpg.

Fazer uma chamada de API

Esse módulo de ação faz uma chamada personalizada para a API do AWS S3.

Para obter uma discussão detalhada da API Amazon S3, consulte a Amazon S3 Introdução à API REST.

Connection
Para obter instruções sobre como conectar sua conta do AWS ao Workfront Fusion, consulte Conectar AWS ao Workfront Fusion neste artigo.
Região
Selecione seu ponto de extremidade regional. Para obter mais informações, consulte pontos de extremidade regionais na documentação AWS.
URL
Insira um URL de host. O caminho deve ser relativo a https://s3.<selected-region>.amazonaws.com/.
Method
Selecione o método de solicitação HTTP necessário para configurar a chamada à API. Para obter mais informações, consulte métodos de solicitação HTTP no Adobe Workfront Fusion.
Headers

Adicione um cabeçalho de solicitação. Para cada cabeçalho que deseja adicionar, clique em Adicionar item e insira o cabeçalho. Você pode usar os seguintes cabeçalhos de solicitação comuns. Para obter mais cabeçalhos de solicitação consulte a AWS S3 Documentação da API.

O Workfront Fusion adiciona cabeçalhos de autorização automaticamente.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto
Nome do cabeçalho Descrição
Tamanho do Conteúdo Comprimento da mensagem (sem os cabeçalhos) de acordo com RFC 2616. Este cabeçalho é necessário para PUTs e operações que carregam XML, como log e ACLs.
Tipo de Conteúdo O tipo de conteúdo do recurso, caso o conteúdo da solicitação esteja no corpo. Exemplo: text/plain.
Content-MD5 O digest MD5 de 128 bits codificado em base64 da mensagem (sem os cabeçalhos) de acordo com a RFC 1864. Esse cabeçalho pode ser usado como uma verificação de integridade da mensagem para verificar se os dados são os mesmos que foram enviados originalmente. Embora seja opcional, recomendamos usar o mecanismo Content-MD5 como uma verificação de integridade completa. Para obter mais informações sobre a autenticação de solicitação do REST, consulte Solicitações de autenticação e autenticação REST na documentação do AWS.
Data A data e a hora atuais de acordo com o solicitante. Exemplo: Wed, 01 Mar 2006 12:00:00 GMT. Ao especificar o cabeçalho Authorization , você deve especificar o cabeçalho x-amz-date ou Date .
Esperar

Quando seu aplicativo usa 100-continue, ele não envia o corpo da solicitação até que receba uma confirmação. Se a mensagem for rejeitada com base nos cabeçalhos, o corpo da mensagem não será enviado. Esse cabeçalho só poderá ser usado se você estiver enviando um corpo.

Valores Válidos: 100-continue

Host

Para solicitações de estilo de caminho, o valor é s3.amazonaws.com. Para solicitações de estilo virtual, o valor é BucketName.s3.amazonaws.com. Para obter mais informações, consulte Hospedagem virtual na documentação do AWS.

Esse cabeçalho é necessário para HTTP 1.1 (a maioria dos kits de ferramentas adiciona esse cabeçalho automaticamente); opcional para solicitações HTTP/1.0.

x-amz-content-sha256 Ao usar a assinatura versão 4 para autenticar a solicitação, este cabeçalho fornece um hash da carga da solicitação. Ao carregar um objeto em partes, defina o valor como STREAMING-AWS4-HMAC-SHA256-PAYLOAD para indicar que a assinatura cobre apenas cabeçalhos e que não há carga útil. Para obter mais informações, consulte Cálculos de assinatura para o cabeçalho de autorização na documentação do AWS.
data-x-amz A data e a hora atuais de acordo com o solicitante. Exemplo: Wed, 01 Mar 2006 12:00:00 GMT. Ao especificar o cabeçalho Authorization , você deve especificar o cabeçalho x-amz-date ou Date . Se você especificar ambos, o valor especificado para o cabeçalho x-amz-date terá prioridade.
x-amz-security-token

Esse cabeçalho pode ser usado nos seguintes cenários:

  • Forneça tokens de segurança para Amazon DevPay operações. Cada solicitação que usa Amazon DevPay requer dois cabeçalhos x-amz-security-token: um para o token do produto e um para o token do usuário. Quando Amazon S3 recebe uma solicitação autenticada, ele compara a assinatura computada com a assinatura fornecida. Cabeçalhos multivalores formatados incorretamente usados para calcular uma assinatura podem causar problemas de autenticação.
  • Forneça um token de segurança ao usar credenciais de segurança temporárias. Ao fazer solicitações usando credenciais de segurança temporárias obtidas do IAM, você deve fornecer um token de segurança usando esse cabeçalho. Para saber mais sobre credenciais de segurança temporárias, acesse Fazer solicitações.

Este cabeçalho é necessário para solicitações que usam Amazon DevPay e solicitações que são assinadas usando credenciais de segurança temporárias.

Query String
Adicione as cadeias de caracteres de consulta desejadas, como parâmetros ou campos de formulário.
Body

Adicione o conteúdo do corpo para a chamada de API na forma de um objeto JSON padrão.

Observação:

Ao usar instruções condicionais, como if em seu JSON, coloque as aspas fora da instrução condicional.

Carregar arquivo

Esse módulo de ação faz upload de um arquivo para um bucket do AWS S3.

Connection
Para obter instruções sobre como conectar sua conta do AWS ao Workfront Fusion, consulte Conectar AWS ao Workfront Fusion neste artigo.
Região
Selecione seu ponto de extremidade regional. Para obter mais informações, consulte pontos de extremidade regionais na documentação AWS.
Folder
Especifique a pasta de destino para a qual você deseja fazer upload de um arquivo.
Source file
Selecione um arquivo de origem de um módulo anterior ou mapeie o nome e os dados do arquivo de origem.
Cabeçalhos (opcional)

Para cada cabeçalho que você deseja adicionar, clique em Adicionar item e insira a chave e o valor do cabeçalho.

Para os cabeçalhos disponíveis, consulte PutObject na documentação do AWS.

Pesquisas

Listar Arquivos

Retorna uma lista de arquivos de um local especificado.

Connection
Para obter instruções sobre como conectar sua conta do AWS ao Workfront Fusion, consulte Conectar AWS ao Workfront Fusion neste artigo.
Região
Selecione seu ponto de extremidade regional. Para obter mais informações, consulte pontos de extremidade regionais na documentação AWS.
Compartimento
Selecione o bucket Amazon S3 que você deseja pesquisar arquivos.
Prefixo
Insira um caminho para uma pasta na qual pesquisar arquivos, como workfrontfusion/work.

Listar pastas

Retorna uma lista de pastas de um local especificado.

Connection
Para obter instruções sobre como conectar sua conta do AWS ao Workfront Fusion, consulte Conectar AWS ao Workfront Fusion neste artigo.
Região
Selecione seu ponto de extremidade regional. Para obter mais informações, consulte pontos de extremidade regionais na documentação AWS.
Compartimento
Selecione o bucket Amazon S3 que deseja pesquisar pastas.
Prefixo (opcional)
Caminho para uma pasta na qual pesquisar pastas, como workfrontfusion/work.
recommendation-more-help
workfront-fusion-help-workfront-fusion