s3-presignedurl

Custom n8n node para gerar URLs pre-assinadas do Amazon S3

Package Information

Downloads: 2 weekly / 35 monthly
Latest Version: 1.0.1
Author: Abe

Available Nodes

S3 URL Pre-Assinada
Gera uma URL pre-assinada (GetObject) para um arquivo no Amazon S3

Documentation

n8n-nodes-s3-presign

Custom n8n node para gerar URLs pré-assinadas (presigned URLs) de objetos no Amazon S3, permitindo acesso temporário a arquivos privados sem expor credenciais.

Instalação no n8n

Via Interface do n8n (recomendado)

  1. Acesse Settings → Community Nodes → Install
  2. Digite o nome do pacote: n8n-nodes-s3-presignedurl
  3. Clique em Install
  4. Reinicie o n8n quando solicitado

Via linha de comando

cd ~/.n8n/custom
npm install n8n-nodes-s3-presign
# Reinicie o n8n

Via GitHub (sem publicar no npm)

cd ~/.n8n/custom
npm install github:SEU_USUARIO/n8n-nodes-s3-presign
# Reinicie o n8n

Configuração

1. Credencial AWS

Crie uma credencial do tipo AWS no n8n (Settings → Credentials → New → AWS) com:

  • Region: ex: sa-east-1
  • Access Key ID: sua chave de acesso AWS
  • Secret Access Key: sua chave secreta AWS

A IAM policy mínima necessária:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "s3:GetObject",
      "Resource": "arn:aws:s3:::SEU-BUCKET/*"
    }
  ]
}

2. Parâmetros do node

Campo Obrigatório Descrição Exemplo
Bucket Sim Nome do bucket S3 meu-bucket
Key Sim Caminho do arquivo no bucket docs/relatorio.pdf
Expira em (segundos) Não Validade da URL (padrão: 3600) 86400

Todos os campos suportam expressões n8n:

  • ={{ $json.bucket }}
  • ={{ $json.key }}

Output

{
  "presigned_url": "https://meu-bucket.s3.sa-east-1.amazonaws.com/docs/relatorio.pdf?X-Amz-Algorithm=...",
  "bucket": "meu-bucket",
  "key": "docs/relatorio.pdf",
  "expires_in": 3600,
  "expires_at": "2026-04-10T16:00:00.000Z"
}

Uso como SubWorkflow

Este node é ideal para ser chamado por outros workflows via Execute Workflow:

[Workflow Pai]
    → [Execute Workflow: S3 URL Pre-Assinada]
        input:  { bucket, key, expires_in }
        output: { presigned_url, expires_at }

Licença

MIT

Discussion