Supabase 자격 증명
n8n v2.42요약
이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다. MCP 서버 레지스트리의 Supabase MCP 서버를 연결할 때도 OAuth2 자격 증명을 사용할 수 있습니다. 이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다.
- Supabase: 시크릿 키 또는 OAuth2를 사용합니다.
- Supabase Vector Store: 시크릿 키를 사용합니다.
MCP 서버 레지스트리의 Supabase MCP 서버를 연결할 때도 OAuth2 자격 증명을 사용할 수 있습니다.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
필수 조건#
Supabase 계정을 만드세요.
지원되는 인증 방법#
- API 키
- OAuth2
관련 리소스#
서비스에 대한 자세한 내용은 Supabase의 API 문서를 참고하세요.
시크릿 키 사용하기#
이 자격 증명을 구성하려면 다음이 필요합니다.
- Host
- Secret Key
이 자격 증명은 Supabase Data API를 사용하여 프로젝트에 연결하며, Data API가 활성화되어 있어야 합니다. 프로젝트의 Data API 설정에서 활성화 여부를 확인하고 설정할 수 있습니다.
시크릿 키를 생성하려면:
- Supabase 계정에서 Dashboard로 이동하여 API 키를 생성할 프로젝트를 만들거나 선택합니다.
- Integrations > Data API로 이동하여 Project URL을 복사합니다. 끝에 있는
/rest/v1경로는 제외하고 n8n Host에 입력합니다(https://your_project.supabase.co/rest/v1이 아니라https://your_project.supabase.co를 사용). - Project Settings > API Keys로 이동하여 프로젝트의 API 키를 확인합니다.
- secret key를 생성하거나 표시하여 n8n Secret Key에 입력합니다. 자세한 내용은 Understanding API keys를 참고하세요.
레거시 service_role 시크릿을 사용하는 기존 자격 증명은 계속 작동하지만, Supabase는 레거시 API 키를 단계적으로 폐지하고 있습니다. 레거시 키가 2026년 말에 비활성화되기 전에 새로운 시크릿 키로 교체하세요.
OAuth2 사용하기#
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
관리형 OAuth2는 권한 표에 표시된 Supabase node and MCP server 권한을 사용합니다. 사용자 지정 OAuth2의 경우 Supabase OAuth 앱을 만들고 해당 클라이언트 자격 증명을 n8n에 입력하세요.
OAuth2 필수 조건#
시작하기 전에 다음을 확인하세요.
- Supabase node에서 사용하는 프로젝트에 Supabase Data API가 활성화되어 있습니다.
- 사용자 지정 OAuth2의 경우, Supabase 계정이 조직의 Owner 또는 Administrator 역할을 가지고 있습니다. Supabase는 OAuth 앱을 게시하려면 이 역할 중 하나가 필요합니다.
- 연결하는 각 프로젝트에서 Supabase 계정이 Owner 또는 Administrator 역할을 가지고 있습니다. n8n이 관리형 시크릿 키를 생성하려면 이 접근 권한이 필요합니다.
조직 및 프로젝트 역할에 대한 자세한 내용은 Supabase의 접근 제어 문서를 참고하세요.
OAuth 자격 증명을 사용하는 방식에 따라 애플리케이션 권한을 구성하세요.
| 스코프 | Supabase node만 사용 | Supabase node 및 MCP server |
|---|---|---|
| Analytics | 접근 불가 | 읽기 전용 |
| Database | 접근 불가 | 읽기 및 쓰기 |
| Edge Functions | 접근 불가 | 읽기 및 쓰기 |
| Environment | 접근 불가 | 읽기 및 쓰기 |
| Organizations | 접근 불가 | 읽기 전용 |
| Projects | 읽기 전용 | 읽기 및 쓰기 |
| Secrets | 읽기 및 쓰기 | 읽기 및 쓰기 |
| Storage | 접근 불가 | 읽기 및 쓰기 |
표에 나열되지 않은 모든 스코프는 No access로 설정해 두세요. Supabase node and MCP server 열의 추가 권한은 Supabase node가 아니라 Supabase MCP 도구에서 필요합니다.
사용자 지정 OAuth2를 구성하려면:
- n8n에서 Supabase OAuth2 API 자격 증명을 만들고 OAuth Redirect URL을 복사합니다.
- Supabase 대시보드에서 조직을 선택하고 Organization Settings > OAuth Apps로 이동합니다.
- Publish OAuth app을 선택합니다.
- Application name과 Website URL을 입력합니다.
- Authorization callback URLs에 n8n의 OAuth Redirect URL을 입력합니다.
- 자격 증명을 사용하는 방식에 맞는 열을 기준으로 애플리케이션 권한을 설정합니다.
- Confirm을 선택합니다.
- Client ID와 Client Secret을 복사합니다. Supabase는 클라이언트 시크릿을 한 번만 표시합니다.
- n8n 자격 증명에 Client ID와 Client Secret을 입력합니다.
- Connect my account를 선택한 다음 Supabase 조직을 선택하고 승인합니다.
n8n은 Data API에 접근하기 위해 n8n_managed_data_api라는 전용 Supabase 시크릿 키를 생성하거나 재사용합니다. Supabase node가 계속 작동하게 하려면 이 키를 삭제하지 마세요.
OAuth 앱 권한을 변경하면 n8n 자격 증명을 다시 연결하여 새 권한을 적용하세요.
자세한 내용은 Supabase의 OAuth 앱 가이드와 OAuth 스코프 문서를 참고하세요.