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

• Notion
• Notion Trigger

사전 요구 사항#

관리자 수준 액세스 권한이 있는 Notion 계정을 만드세요.

지원되는 인증 방법#

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

관련 리소스#

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

API 통합 토큰 사용#

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

• 내부 통합 시크릿(Internal Integration Secret): Notion 통합을 생성하면 생성됩니다.

통합 시크릿을 생성하려면 Notion 통합을 생성하고 시크릿 탭에서 통합 시크릿을 가져옵니다:

1. Notion 통합 대시보드로 이동합니다.
2. + 새 통합 버튼을 선택합니다.
3. n8n 통합과 같이 통합의 이름을 입력합니다. 원하는 경우 로고를 추가합니다.
4. 제출을 선택하여 통합을 생성합니다.
5. 기능(Capabilities) 탭을 엽니다. 다음 기능을 선택합니다:
   • 콘텐츠 읽기
   • 콘텐츠 업데이트
   • 콘텐츠 삽입
   • 이메일 주소 없이 사용자 정보
6. 변경 사항 저장을 반드시 선택합니다.
7. 시크릿 탭을 선택합니다.
8. **내부 통합 토큰(Internal Integration Token)**을 복사하여 n8n의 **내부 통합 시크릿(Internal Integration Secret)**으로 추가합니다.

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

통합과 Notion 페이지 공유#

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

1. Notion 워크스페이스에서 해당 페이지를 방문합니다.
2. 페이지 오른쪽 상단의 점 세 개 메뉴를 선택합니다.
3. **연결(Connections)**에서 연결 대상을 선택합니다.
4. 검색창을 사용하여 드롭다운 목록에서 통합을 찾아 선택합니다.

최소 하나의 페이지를 통합과 공유하면 API 요청을 시작할 수 있습니다. 페이지가 공유되지 않으면 모든 API 요청이 오류로 응답합니다.

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

OAuth2 사용#

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

• 클라이언트 ID(Client ID): 공개 통합을 구성하면 생성됩니다.
• 클라이언트 시크릿(Client Secret): 공개 통합을 구성하면 생성됩니다.

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

1. Notion 통합 대시보드로 이동합니다.
2. + 새 통합 버튼을 선택합니다.
3. n8n 통합과 같이 통합의 이름을 입력합니다. 원하는 경우 로고를 추가합니다.
4. 제출을 선택하여 통합을 생성합니다.
5. 기능(Capabilities) 탭을 엽니다. 다음 기능을 선택합니다:
   • 콘텐츠 읽기
   • 콘텐츠 업데이트
   • 콘텐츠 삽입
   • 이메일 주소 없이 사용자 정보
6. 변경 사항 저장을 선택합니다.
7. 배포(Distribution) 탭으로 이동합니다.
8. 이 통합을 공개하시겠습니까? 제어를 켭니다.
9. 조직 정보 섹션에 회사 이름과 웹사이트를 입력합니다.
10. n8n의 OAuth 리디렉션 URL을 복사하여 Notion 통합의 OAuth 도메인 및 URL 섹션에 리디렉션 URI로 추가합니다.
11. 시크릿 탭으로 이동합니다.
12. **클라이언트 ID(Client ID)**와 **클라이언트 시크릿(Client Secret)**을 복사하여 n8n 자격 증명에 추가합니다.

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

내부 통합 vs. 공개 통합#

내부 통합의 특징:

• 단일 워크스페이스에 한정됩니다.
• 해당 워크스페이스 구성원만 접근할 수 있습니다.
• 커스텀 워크스페이스 향상에 이상적입니다.

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

공개 통합의 특징:

• 여러 관련 없는 Notion 워크스페이스에서 사용할 수 있습니다.
• 워크스페이스에 관계없이 모든 Notion 사용자가 접근할 수 있습니다.
• 광범위한 사용 사례에 이상적입니다.

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

두 통합 유형에 대한 더 자세한 비교는 Notion의 내부 vs. 공개 통합 문서를 참조하세요.