AWS Access Key 발급 및 N8n S3 노드 사용 가이드 (1)

AWS Access Key 발급 및 N8n S3 노드 사용 가이드 (1)

AWS S3를 N8n 워크플로우에서 사용하기 위해 필요한 Access Key를 발급받고, N8n의 AWS S3 노드를 설정하는 방법을 단계별로 안내합니다. 이를 통해 N8n에서 S3 버킷에 파일을 업로드하거나 다운로드하는 자동화 워크플로우를 구축할 수 있습니다.

1. 사전 준비사항

1.1 필요한 서비스

✅ AWS 계정: 활성화된 AWS 계정 (무료 티어 가능)
✅ S3 버킷: 파일을 저장할 S3 버킷 (기존 또는 신규)
✅ N8n 인스턴스: 설치되고 실행 중인 N8n 환경

2. IAM 사용자 생성

IAM(Identity and Access Management)에서 N8n 전용 사용자를 생성합니다.

2.1 IAM 서비스 접속

  1. AWS 콘솔 로그인
      • AWS Management Console에 접속
      • 상단 검색창에 'IAM' 입력 후 서비스 선택
      notion image
  1. IAM 대시보드 확인
      • IAM 대시보드가 열리면 왼쪽 메뉴에서 '사용자' 클릭

2.2 사용자 생성 시작

  1. 사용자 추가
      • '사용자 추가' 또는 '사용자 생성' 버튼 클릭
      notion image
  1. 사용자 세부 정보 입력
      • 사용자 이름: n8n-s3-user (또는 원하는 이름)
          • notion image
      • AWS 액세스 유형: 'AWS 액세스 키 - 프로그래밍 방식 액세스' 선택

2.3 권한 설정 방법 선택

다음 단계에서 권한 설정 방법을 선택합니다:
  1. 권한 설정 옵션
      • '직접 정책 연결' 선택
      • 권한 정책 검색창에 “s3full” 입력 후 목록에서 “AmazonS3FullAccess’ 를 확인하고 체크
      notion image

2.4 사용자 생성 완료

  1. 검토 및 생성
      • 설정 내용을 검토한 후 '사용자 생성' 클릭
      notion image
  1. 생성 완료 확인
      • 사용자가 성공적으로 생성되었다는 메시지 확인
      notion image

3. Access Key 생성 및 다운로드

3.1 Access Key 생성

  1. 보안 자격 증명 탭
      • 사용자 상세 페이지에서 '보안 자격 증명' 탭 클릭
  1. 액세스 키 생성
      • '액세스 키 만들기' 버튼 클릭
notion image

3.2 사용 사례 선택

  1. 액세스 키 사용 사례
      • '서드 파티 서비스' 또는 '기타' 선택
      notion image
  1. 설명 태그 추가 (선택사항)
      • 설명: N8n S3 Integration Access Key
      notion image

3.3 Access Key 다운로드

  1. 키 정보 확인
      • 액세스 키 ID: AWS가 생성한 공개 키
      • 비밀 액세스 키: 보안이 중요한 비밀 키
      notion image
  1. 안전하게 저장
      • '.csv 파일 다운로드' 클릭하여 키 정보 저장
      • 또는 화면의 키 정보를 안전한 곳에 복사
      ⚠️ 경고: 비밀 액세스 키는 이 화면에서만 확인 가능합니다!
  1. 완료
      • '완료' 버튼 클릭

4. N8n에서 AWS S3 노드 설정

4.1 N8n 워크플로우 생성

  1. N8n 접속
      • N8n 웹 인터페이스에 로그인
      • '새 워크플로우' 생성
  1. AWS S3 노드 추가
      • 노드 추가 버튼(+) 클릭
      • 검색창에 'AWS S3' 입력
      • 'AWS S3' 노드 선택
      notion image
 

4.2 S3 노드 기본 설정

  1. 작업 유형 선택
      • Operation: 원하는 작업 선택 (Upload, Download, List 등)
      • 예시로 'Download a file' 선택
      notion image
  1. 버킷 이름 설정
      • Bucket Name: 사용할 S3 버킷 이름 입력
      notion image

4.3 AWS 자격 증명 설정

  1. Credentials 설정
      • 'Credential for AWS' 드롭다운에서 '+ Create New' 선택
      notion image
  1. 자격 증명 정보 입력
      • Credential Name: Test AWS account (원하는 이름)
      • Access Key ID: 앞서 생성한 액세스 키 ID 입력
      • Secret Access Key: 앞서 생성한 비밀 액세스 키 입력
      • Region: S3 버킷이 있는 리전 선택 ( ap-northeast-2)
      notion image
  1. 자격 증명 저장
      • '저장' 버튼 클릭하여 자격 증명 정보 저장
      notion image

4.4 다운로드 설정 (Download 작업 예시)

  1. 파일 다운로드 설정
      • Bucket Name: 위에서 작성함
      • File key: S3에 저장되어 있는 파일 경로 및 이름 설정
      • Additional Fields: 필요한 추가 옵션 설정
  1. 다운로드 실행
      • [Execute step] 버튼 클릭
      • 다운로드된 파일 확인
      notion image

4. CloudFront 배포 CDN 주소로 다운로드하기 (읽기 전용)

이 과정은 CloudFront CDN 배포 설정을 하신분만 가능합니다.

4.1 AWS CloudFront CDN 도메인 주소 확인

  1. AWS CloudFront 콘솔 접속
      • 배포 메뉴 > 배포 목록 에서 Domain 주소 확인 및 복사
      notion image

4.2 Http Request Node 구성 및 실행

  1. Http Request 노드 추가
      • 노드 메뉴에서 “http” 검색하여 HTTP Request 노드를 찾아 클릭
      notion image
  1. Http Request 노드 설정
      • GET 메서드 지정
      • URL에 https:// [CloudFront 배포 도메인 주소] / [파일경로(버킷명 제외)] 형식으로 입력 (빈칸 없음)
      • [Execute step] 버튼 클릭
      • 다운로드된 파일내용 확인
      notion image