Notion 연동

개요

Argus의 Notion 연동은 워크스페이스 페이지, 데이터베이스, 코드 블록에서 붙여넣어진 API 키, 토큰, 자격증명을 탐지합니다. Notion 내부 통합 토큰을 사용하므로 OAuth 흐름이 필요 없습니다.

사전 요구사항

• Notion 워크스페이스 Admin 또는 Owner
• Notion에서 내부 통합 생성 권한
• Cremit Argus 계정

단계별 설정

Step 1: Notion 내부 통합 생성

• Notion > Settings > Connections > Develop or manage integrations
• New integration 클릭, 이름을 'Cremit Argus'로 설정하고 대상 워크스페이스와 연결
• Capabilities에서 Read content 활성화, Read user information은 선택
• 저장 후 Internal Integration Secret 복사

Step 2: 대상 페이지를 통합에 공유

Notion은 각 페이지 또는 데이터베이스를 통합에 명시적으로 공유해야 합니다.

• 최상위 페이지(또는 Argus가 커버할 워크스페이스 루트) 열기
• 점 3개 메뉴 > Add connections 클릭
• 목록에서 Cremit Argus 선택
• Propagation 프롬프트를 수락해 하위 페이지 전체가 연결 상속

Step 3: Argus에 Notion Scan Source 추가

• Argus > Configuration > Scan Sources > New
• 소스 타입으로 Notion 선택
• Step 1의 Internal Integration Secret 붙여넣기
• Test Connection 후 Create 클릭

Step 4: 스캔 대상 페이지와 데이터베이스 선택

Argus는 통합이 초대된 페이지만 나열합니다.

• 페이지가 계층 구조로 표시됨, 커버할 루트를 선택
• 데이터베이스는 별도 목록, 설정이나 자격증명이 저장된 것 활성화
• 커버된 루트 하위에 나중에 추가되는 페이지는 자동 스캔 상속

설정 확인

통합이 올바르게 구성되었는지 확인하는 방법:

• Scan Source가 올바른 워크스페이스 이름과 함께 Connected 표시
• 소스 페이지의 공유된 페이지 수가 Notion에서 보이는 수와 일치
• 커버된 페이지 수정 시 몇 분 내 재스캔 트리거
• 활동 로그에 'object_not_found' 또는 'unauthorized' 오류 없음

문제 해결

문제: 토큰은 유효한데 Argus가 0개 페이지를 보입니다.

• 해결: 통합에 공유된 페이지가 없습니다. Notion은 자동 접근을 허용하지 않으므로, 각 루트 페이지를 명시적으로 연결해야 합니다.

문제: 새 하위 페이지를 만들었는데 Argus가 스캔하지 않습니다.

• 해결: 부모 페이지에 통합이 연결되어 있고 propagation이 수락된 상태여야 합니다. 루트에서 다시 연결하고 'Add to all child pages'를 확인하세요.

핵심 이점

• 현대 팀에서 빠르게 커지는 문서 표면을 커버
• OAuth나 서비스 계정 관리 없이 워크스페이스 단위 토큰 하나
• Notion의 통합 공유 모델 존중, 허용한 범위만 Argus도 봄
• 코드 블록, 토글 블록, 데이터베이스 필드까지 모두 스캔