Módulos do AWS S3
Os módulos S3 Adobe Workfront Fusion AWS permitem executar operações em seus buckets S3.
Requisitos de acesso
| 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:
Conectar o AWS ao Workfront Fusion connect-aws-to-workfront-fusion
Conectar o AWS ao Workfront Fusion usando uma conexão federada
- Pré-requisitos para conectar o AWS ao Workfront Fusion usando uma conexão federada
- Adicionar o Workfront Fusion como um provedor de identidade no AWS
- Criar a função IAM
- Criar a conexão no Workfront Fusion
- Adicionar a conexão à diretiva de confiança da função
- Verifique a conexão
- Solução de problemas
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.
-
Faça logon no console do AWS e acesse IAM > Provedores de identidade.
-
Selecione Adicionar provedor.
-
Para o tipo de Provedor, selecione OpenID Connect.
-
Na URL do Provedor, insira o seguinte e selecione Obter impressão digital:
code language-none https://oidc.automations.adobe.com -
Em Público-alvo, insira o seguinte:
code language-none sts.amazonaws.com -
Selecione Adicionar provedor.
-
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.
-
No IAM, vá para Funções e selecione Criar função.
-
Para o tipo de entidade Confiável, selecione Identidade da Web.
-
Em Provedor de identidade, selecione
oidc.automations.adobe.com. -
Em Público, selecione
sts.amazonaws.com. -
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 deAmazonS3FullAccess. -
Dê à função um nome claro e reconhecível. Por exemplo,
WorkfrontFusionFederatedConnection. -
Selecione Criar função.
-
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 -
Continue em Criar a conexão no Workfront Fusion.
Criar a conexão no Workfront Fusion
- Na tela de configuração de conexão do módulo, selecione o tipo de conexão federada.
- Insira o ARN de Função que você copiou em Criar a função IAM.
- 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. |
-
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. -
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.
-
Em uma nova guia do navegador, retorne ao console AWS e abra a função criada.
-
Selecione a guia Relações de confiança e selecione Editar diretiva de confiança.
-
Substitua a política pelo seguinte, substituindo seus próprios valores:
- Substituir
123456789012pela ID de conta da AWS - Substitua o valor
subpelo 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" } } } ] } - Substituir
-
Selecione Atualizar política.
-
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: | ||
|
||
| 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
-
Retorne à guia do navegador Workfront Fusion, onde o painel de conexão ainda está aberto.
-
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
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.
-
Entre na sua conta do AWS IAM.
-
Navegue até Gerenciamento de Identidade e Acesso > Gerenciamento de Acesso > Usuários.
-
Clique em Adicionar usuário.
-
Insira o nome do novo usuário e selecione a opção Acesso programático na seção Tipo de acesso.
-
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.
-
Prossiga pelas outras telas de diálogo e clique em Criar Usuário.
-
Copie a ID da chave de acesso e a chave de acesso secreta fornecidas.
-
Vá para o Workfront Fusion e abra a caixa de diálogo Criar uma conexão do módulo AWS S3.
-
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.
Ações
Criar bloco
Esse módulo de ação cria um bucket no AWS.
Obter arquivo
Esse módulo de ação baixa um arquivo de um bucket.
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.
https://s3.<selected-region>.amazonaws.com/.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 é 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:
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. |
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.
Pesquisas
Listar Arquivos
Retorna uma lista de arquivos de um local especificado.
Listar pastas
Retorna uma lista de pastas de um local especificado.