OpenConnector용 Notion OAuth 앱 생성

OpenConnector가 사용자가 OAuth를 통해 워크스페이스 페이지나 데이터베이스를 승인하도록 해야 할 때는 Notion 퍼블릭 연결을 사용하세요. Notion은 내부 통합 시크릿도 지원하지만, 사용자 승인 흐름을 원할 때는 OAuth가 적절한 방법입니다.

OpenConnector 서비스

OpenConnector의 Notion OAuth 제공자는 read_content, insert_content, update_content 등의 권한을 요청합니다.

사전 요구 사항

• 실행 중인 OpenConnector 런타임.
• Notion integrations 개발자 포털에 대한 접근.
• 퍼블릭 연결을 생성할 수 있는 권한.
• 사용자가 브라우저에서 여는 OpenConnector 오리진(예: http://localhost:3000 또는 https://connect.example.com).

1단계: OpenConnector 콜백 URL 설정

OpenConnector 오리진에 /oauth/callback를 추가하여 콜백 URL을 만듭니다. 로컬 테스트에는 http://localhost:3000/oauth/callback을 사용하세요. 퍼블릭 배포에는 OOMOL_CONNECT_ORIGIN을 설정하고 OpenConnector를 재시작한 뒤 https://connect.example.com/oauth/callback와 같은 퍼블릭 콜백 URL을 사용하세요.

2단계: Notion 퍼블릭 연결 생성

Notion integrations 개발자 포털에서:

1. 새 퍼블릭 연결을 생성합니다.
2. 연결 이름과 워크스페이스 세부 정보를 입력합니다.
3. OAuth 리디렉션 URI 구성에 정확한 OpenConnector 콜백 URL을 추가합니다.
4. 사용 사례에 맞는 설치 범위를 선택합니다.
5. OpenConnector 액션에 필요한 콘텐츠 권한을 구성합니다.
6. 연결을 저장합니다.

Notion의 공식 가이드는 Authorization입니다. Notion은 퍼블릭 연결을 생성할 때 설치 범위를 선택한다고 안내하므로 신중하게 선택하세요.

3단계: 클라이언트 자격 증명 복사

Notion 퍼블릭 연결 설정에서 다음을 복사합니다:

4단계: OpenConnector에 Notion 클라이언트 저장

OpenConnector 웹 콘솔을 사용합니다:

1. OpenConnector 웹 콘솔(예: http://localhost:3000)을 엽니다.
2. Providers를 열고 Notion을 선택합니다.
3. Configure OAuth Client 또는 Edit OAuth Client를 선택합니다.
4. Notion client ID와 client secret을 붙여넣습니다.
5. Save OAuth Client를 선택합니다.

5단계: 연결 및 테스트

OAuth 클라이언트를 저장한 뒤 Notion 제공자 페이지에서 Connect를 선택합니다. 공유할 Notion 워크스페이스 콘텐츠를 선택하고, 접근을 승인하고, OpenConnector로 돌아와 제공자 페이지에 워크스페이스가 연결된 것으로 표시되는지 확인합니다.

콘솔 액션 목록에서 notion.search 또는 notion.list_users을 위험 부담이 낮은 테스트 액션으로 사용하세요.

문제 해결