커넥터

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

​

사용 가능한 커넥터

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

​

커넥터 만들기

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 스크립트로 서명 헤더를 주입하는 것도 가능.