Notion 자격 증명#
다음 노드를 인증하기 위해 이러한 자격 증명을 사용할 수 있습니다:
필수 조건#
관리자 수준 접근 권한이 있는 Notion 계정을 만드세요.
지원되는 인증 방법#
- API 통합 토큰: 내부 통합에 사용됩니다.
- OAuth2: 공용 통합에 사용됩니다.
통합 유형
어떤 통합 유형을 사용해야 할지 모르겠나요? 더 많은 정보는 아래의 Internal vs. public integrations를 참조하세요.
관련 리소스#
서비스에 대한 더 많은 정보는 Notion의 API 문서를 참조하세요.
API 통합 토큰 사용#
이 자격 증명을 구성하려면 다음이 필요합니다:
- Internal Integration Secret: Notion 통합을 생성하면 생성됩니다.
통합 비밀을 생성하려면, Notion 통합을 생성하고 Secrets 탭에서 통합 비밀을 가져옵니다:
- Notion 통합 대시보드로 이동합니다.
- + New integration 버튼을 선택합니다.
- 통합의 Name을 입력합니다. 예:
n8n integration
. 원하는 경우 Logo를 추가합니다. - Submit를 선택하여 통합을 생성합니다.
- Capabilities 탭을 열고 다음 권한을 선택합니다:
Read content
Update content
Insert content
User information without email addresses
- Save changes를 반드시 하세요.
- Secrets 탭을 선택합니다.
- Internal Integration Token을 복사하여 n8n Internal Integration Secret으로 추가합니다.
서비스에 대한 인증에 대한 더 많은 정보는 Internal integration auth flow setup documentation을 참조하세요.
통합과 Notion 페이지 공유#
귀하의 통합이 Notion과 상호 작용하려면, 귀하의 통합 페이지에 권한을 부여해야 합니다:
- Notion 작업 공간의 해당 페이지를 방문합니다.
- 페이지 오른쪽 상단의 삼중 점 메뉴를 선택합니다.
- Connections에서 Connect to를 선택합니다.
- 검색 표시줄에서 드롭다운 목록에서 귀하의 통합을 찾아 선택합니다.
하나 이상의 페이지를 통합과 공유하면 API 요청을 시작할 수 있습니다. 페이지가 공유되지 않으면 모든 API 요청은 오류로 응답합니다.
더 많은 정보는 Integration permissions를 참조하세요.
OAuth2 사용#
이 자격 증명을 구성하려면 다음이 필요합니다:
- Client ID: 공용 통합을 구성하면 생성됩니다.
- Client Secret: 공용 통합을 구성하면 생성됩니다.
Notion 통합을 생성하고 이를 공용 배포로 설정해야 합니다:
- Notion 통합 대시보드로 이동합니다.
- + New integration 버튼을 선택합니다.
- 통합의 Name을 입력합니다. 예:
n8n integration
. 원하는 경우 Logo를 추가합니다. - Submit를 선택하여 통합을 생성합니다.
- Capabilities 탭을 열고 다음 권한을 선택합니다:
Read content
Update content
Insert content
User information without email addresses
- Save changes를 선택합니다.
- Distribution 탭으로 이동합니다.
- Do you want to make this integration public? 컨트롤을 켭니다.
- Organization Information 섹션에 회사 이름과 웹사이트를 입력합니다.
- n8n의 OAuth Redirect URL을 복사하여 Notion 통합의 OAuth Domain & URLs 섹션의 Redirect URI로 추가합니다.
- Secrets 탭으로 이동합니다.
- Client ID와 Client Secret을 복사하여 n8n 자격 증명에 추가합니다.
서비스에 대한 인증에 대한 더 많은 정보는 Notion의 public integration auth flow setup을 참조하세요.
내부 통합 vs. 공개 통합#
내부 통합은:
- 단일 워크스페이스에 특정합니다.
- 해당 워크스페이스의 멤버만 접근할 수 있습니다.
- 맞춤형 워크스페이스 개선에 이상적입니다.
내부 통합은 더 간단한 인증 프로세스(통합 비밀)를 사용하며, 배포 전에 보안 검토가 필요하지 않습니다.
공개 통합은:
- 여러 관련 없는 Notion 워크스페이스에서 사용 가능합니다.
- 워크스페이스와 관계없이 모든 Notion 사용자가 접근할 수 있습니다.
- 폭넓은 사용 사례에 맞추는 데 이상적입니다.
공개 통합은 OAuth 2.0 프로토콜을 사용하여 인증합니다. 배포 전에 Notion 보안 검토가 필요합니다.
두 통합 유형에 대한 보다 상세한 분석은 Notion의 내부 통합 vs. 공개 통합 문서를 참조하세요.