> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# 커넥터

> 외부 세계에 대한 재사용 가능한 인증 연결.

**커넥터** 는 외부 시스템에 저장된 자격증명입니다. 한 번 설정하면 워크스페이스의 어떤 파이프라인이든 사용 가능 — 파이프라인마다 재인증 불필요.

## 사용 가능한 커넥터

| 시스템                                                  | 모드                       |
| ---------------------------------------------------- | ------------------------ |
| **Google Drive**                                     | 파일·폴더 읽기, 변경 감시          |
| **Google Workspace** (Docs, Sheets, Gmail, Calendar) | 문서 읽기, 이벤트 목록, 받은편지함 감시  |
| **Microsoft 365** (OneDrive, SharePoint, Outlook)    | 파일 읽기, 변경 감시             |
| **Notion**                                           | 페이지·데이터베이스 읽기, 감시        |
| **Slack**                                            | 채널 읽기, 메시지 감시, 메시지 게시    |
| **Confluence**                                       | 스페이스 읽기, 페이지 업데이트 감시     |
| **GitHub**                                           | 리포·PR·이슈 읽기, 푸시 감시       |
| **S3 호환** (AWS S3, R2, GCS)                          | 객체 읽기, 버킷 prefix 감시      |
| **Postgres / MySQL / SQL Server**                    | 쿼리와 테이블 스트리밍             |
| **HTTP (일반)**                                        | 임의 인증 방식의 커스텀 REST 엔드포인트 |

정기적으로 추가됩니다 — 현재 세트는 앱의 커넥터 픽커에서 확인.

## 커넥터 만들기

1. **Settings → Connectors → New**.
2. 시스템 선택.
3. OAuth 인증 (대부분 시스템) 또는 자격증명 직접 붙여넣기 (DB, S3, 일반 HTTP).
4. 기억할 만한 이름 지정.
5. 옵션으로 특정 폴더·버킷·채널로 스코프 좁히기 — 좁은 스코프는 우발적 노출을 줄임.

저장되면 자격증명은 저장 시 암호화됩니다. UI 는 원본 값을 다시 보여주지 않습니다.

## 커넥터 사용

어떤 Source 블록이든 드롭다운에서 커넥터를 고릅니다. 블록은 그 시스템 특화 설정 (어느 폴더, 어느 채널, 어느 SQL 등) 을 표면화합니다.

## 테스트

모든 커넥터는 읽기 전용 프로브 (폴더 목록, 채널 메시지 카운트, `SELECT 1`) 를 실행하는 **Test** 버튼을 가집니다. 초록이면 자격증명 유효.

## 자격증명 로테이션

**Settings → Connectors → \[이름] → Rotate**. 이전 자격증명은 60분 유예 기간 동안 계속 동작 — 진행 중 파이프라인이 실패하지 않음.

## 최소 권한

* OAuth 커넥터는 읽기 전용을 만족하는 가장 좁은 스코프가 기본.
* 데이터베이스는 특정 스키마에 `SELECT` 만 있는 Nora 전용 사용자 생성.
* S3 는 단일 prefix 로 스코프된 IAM 정책 사용.

## 삭제

파이프라인이 아직 참조 중인 커넥터 삭제는 실패. 파이프라인을 먼저 업데이트한 뒤 삭제.

## 커스텀 인증

목록에 없는 시스템은 **HTTP (일반)** 커넥터를 씁니다. API 키, bearer, basic, OAuth 2.0 client-credentials 지원. 작은 pre-request 스크립트로 서명 헤더를 주입하는 것도 가능.