발행일: 2026-08-04(화) 03:14
도서하루 30분 n8n ①DAY 11
챕터 2 — 핵심 노드 마스터난이도 ★★☆
DAY 11

Credentials(자격증명) 완전 정복

📖 이 DAY는 개념 학습 위주로 실습 파일이 없습니다
이론10
실습15
미션5

"우리는 정보의 홍수에 빠져 있지만 지식에는 굶주려 있다."

존 나이스비트 (John Naisbitt, 미국 미래학자)
🎯 오늘의 학습 목표
  • OAuth2 / API Key / Basic Auth 세 가지 인증 방식의 차이를 설명할 수 있다
  • Google OAuth2 Credentials를 n8n에 등록할 수 있다
  • OpenAI API Key를 n8n Credentials에 안전하게 저장할 수 있다
반드시 지켜야 할 4가지 규칙
text
규칙 1. API Key를 워크플로우 JSON에 직접 넣지 마세요
        → n8n Credentials 메뉴에 저장하면 암호화되어 안전해요

규칙 2. 서비스별로 전용 키를 발급받으세요
        → 유출 시 해당 키만 폐기하면 돼요

규칙 3. 사용하지 않는 Credentials은 주기적으로 삭제하세요
        → 왼쪽 메뉴 Credentials 페이지에서 관리

규칙 4. n8n Cloud는 Google Managed OAuth2를 먼저 시도하세요
        → Google Cloud Console 설정 없이 Sign in with Google로 연동 완료
⚠️ OAuth 앱이 테스트 모드이면 Refresh Token이 7일 후 만료되어 401 오류가 발생해요. Google Cloud Console에서 앱 상태를 프로덕션으로 전환하세요.
🛠️ 실습
실습 ① — n8n CloudGoogle OAuth2 등록 (n8n Cloud)
  1. 왼쪽 사이드바 → Credentials 클릭
  2. + Add Credential 버튼 클릭
  3. Gmail OAuth2 검색 후 선택
  4. Sign in with Google 버튼 클릭
  5. Google 계정 선택 및 권한 승인
  6. Credential 이름 지정 후 저장
실습 ① — 자체 호스팅Google OAuth2 등록 (Self-hosted)
  1. Google Cloud Console → 새 프로젝트 생성
  2. Gmail API 활성화
  3. OAuth 동의 화면 설정
  4. OAuth 클라이언트 ID(Web 유형) 생성
  5. n8n에서 제공한 Redirect URL 등록
  6. Client ID · Secret을 n8n Credentials에 입력 후 저장
실습 ②OpenAI API Key 등록
  1. platform.openai.com 접속 → API Keys 메뉴
  2. + Create new secret key 클릭 → 키 복사
  3. n8n 왼쪽 사이드바 → Credentials → + Add Credential
  4. OpenAI 검색 후 선택
  5. API Key 필드에 복사한 키 붙여넣기
  6. 저장 후 연결 성공 확인
API Key 형태 예시
text
sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
→ 이 키는 절대 GitHub 같은 공개 저장소에 올리지 마세요!
🚀 오늘의 미션
  1. Gmail OAuth2 Credentials를 등록하고 연결 성공 상태를 확인해보세요
  2. OpenAI API Key Credentials를 등록하고 연결 성공 상태를 확인해보세요
  3. 두 Credentials 등록 완료 화면을 캡처해 저장해보세요 (파일명: n8n_day11_credentials.png)
n8n 계정이 없으신가요?n8n 무료 시작하기 ↗
← DAY 10
Code 노드 : 노코드의 한계를 넘을 때
목차로DAY 12
Gmail : 이메일 자동화의 시작