이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다:

• Notion
• Notion Trigger

사전 준비 사항#

관리자 수준 액세스 권한을 가진 Notion 계정을 생성하세요.

지원되는 인증 방식#

• API 통합 토큰: 내부 통합에 사용됩니다.
• OAuth2: 공개 통합에 사용됩니다.

관련 리소스#

서비스에 대한 자세한 내용은 Notion API 문서를 참고하세요.

API 통합 토큰 사용하기#

이 자격 증명을 구성하려면 다음이 필요합니다:

• Internal Integration Secret: Notion 통합을 생성하면 한 번 생성됩니다.

통합 시크릿을 생성하려면 Notion 통합을 생성하고 Secrets 탭에서 통합 시크릿을 가져오세요:

1. Notion 통합 대시보드로 이동합니다.
2. + New integration 버튼을 선택합니다.
3. 통합의 Name을 입력합니다(예: n8n integration). 필요하면 Logo도 추가합니다.
4. Submit을 선택하여 통합을 생성합니다.
5. Capabilities 탭을 엽니다. 다음 기능을 선택합니다:
   • Read content
   • Update content
   • Insert content
   • User information without email addresses
6. 반드시 Save changes를 선택합니다.
7. Secrets 탭을 선택합니다.
8. Internal Integration Token을 복사하여 n8n의 Internal Integration Secret으로 추가합니다.

서비스 인증에 대한 자세한 내용은 내부 통합 인증 흐름 설정 문서를 참고하세요.

Notion 페이지를 통합과 공유하기#

통합이 Notion과 상호 작용하려면 Notion 워크스페이스의 페이지와 상호 작용할 수 있도록 통합에 페이지 권한을 부여해야 합니다:

1. Notion 워크스페이스에서 페이지를 엽니다.
2. 페이지 우측 상단의 세 개 점 메뉴를 선택합니다.
3. Connections에서 Connect to를 선택합니다.
4. 검색창을 사용하여 드롭다운 목록에서 통합을 찾아 선택합니다.

통합과 페이지를 최소 하나 이상 공유하면 API 요청을 시작할 수 있습니다. 페이지가 공유되지 않은 경우, API 요청은 오류로 응답합니다.

자세한 내용은 통합 권한을 참고하세요.

OAuth2 사용하기#

이 자격 증명을 구성하려면 다음이 필요합니다:

• Client ID: 공개 통합을 구성하면 한 번 생성됩니다.
• Client Secret: 공개 통합을 구성하면 한 번 생성됩니다.

Notion 통합을 생성하고 공개 배포로 설정해야 합니다:

1. Notion 통합 대시보드로 이동합니다.
2. + New integration 버튼을 선택합니다.
3. 통합의 Name을 입력합니다(예: n8n integration). 필요하면 Logo도 추가합니다.
4. Submit을 선택하여 통합을 생성합니다.
5. Capabilities 탭을 엽니다. 다음 기능을 선택합니다:
   • Read content
   • Update content
   • Insert content
   • User information without email addresses
6. Save changes를 선택합니다.
7. Distribution 탭으로 이동합니다.
8. Do you want to make this integration public? 컨트롤을 켭니다.
9. Organization Information 섹션에 회사 이름과 웹사이트를 입력합니다.
10. n8n의 OAuth Redirect URL을 복사하여 Notion 통합의 OAuth Domain & URLs 섹션에 Redirect URI로 추가합니다.
11. Secrets 탭으로 이동합니다.
12. Client ID와 Client Secret을 복사하여 n8n 자격 증명에 추가합니다.

서비스 인증에 대한 자세한 내용은 Notion의 공개 통합 인증 흐름 설정을 참고하세요.

내부 통합 vs. 공개 통합#

내부(Internal) 통합은 다음과 같습니다:

• 단일 워크스페이스에 한정됩니다.
• 해당 워크스페이스의 구성원만 액세스할 수 있습니다.
• 맞춤형 워크스페이스 개선에 적합합니다.

내부 통합은 더 간단한 인증 프로세스(통합 시크릿)를 사용하며, 게시 전 보안 검토가 필요하지 않습니다.

공개(Public) 통합은 다음과 같습니다:

• 서로 관련 없는 여러 Notion 워크스페이스에서 사용할 수 있습니다.
• 워크스페이스와 관계없이 모든 Notion 사용자가 액세스할 수 있습니다.
• 광범위한 사용 사례를 충족하는 데 적합합니다.

공개 통합은 인증에 OAuth 2.0 프로토콜을 사용합니다. 게시 전 Notion 보안 검토가 필요합니다.

두 통합 유형에 대한 더 자세한 설명은 Notion의 내부 통합 vs. 공개 통합 문서를 참고하세요.