nora connectors

커넥터는 외부 시스템의 이름 붙은, 암호화된 자격증명입니다. 워크스페이스 수준에서 한 번 설정합니다. 자격증명이 필요한 파운더리 파이프라인·Tool·Trigger에서 ID로 참조합니다.

명령

명령	설명
`connectors list`	워크스페이스의 모든 커넥터 나열.
`connectors get <id>`	커넥터 설정 출력(시크릿 가림).
`connectors create`	새 api-key 커넥터 생성.
`connectors update <id>`	이름 변경 또는 키 로테이션.
`connectors delete <id>`	커넥터 제거.
`connectors invoke <id> <operation>`	커넥터로 작업 호출.

`connectors list` / `get`

nora connectors list
nora connectors get c_tavily

list는 커넥터당 한 줄입니다. get은 시크릿을 가린 설정을 출력합니다.

`connectors create`

nora connectors create \
  --provider tavily \
  --name "Tavily search" \
  --api-key ?
# --api-key ? 가 물어봄 (입력 가림)

플래그:

--provider <p>(필수) 외부 시스템. 지원: tavily, brave(늘어나는 중)
--name <n>(필수) 표시 이름
--api-key <key>(필수) API 키. 가림 프롬프트에 ?, stdin 읽기에 -, 또는 리터럴로 넘김(셸 히스토리 경고)

새 커넥터의 ID를 출력합니다. 리터럴보다 ?나 stdin을 권합니다. 리터럴 API 키는 셸 히스토리에 남습니다.

`connectors update`

# 이름 변경
nora connectors update c_tavily --set-name "Tavily (production)"

# API 키 로테이션
nora connectors update c_tavily --rotate-api-key ?

플래그:

--set-name <n> 새 표시 이름
--rotate-api-key <key> 저장된 키 교체. create와 같은 입력 모드(?, -, 리터럴)

넘긴 플래그만 바뀝니다.

`connectors delete`

nora connectors delete c_tavily

파이프라인·Tool·Trigger가 커넥터를 쓰면 실패합니다. 먼저 그것들을 고치세요.

`connectors invoke`

nora connectors invoke c_tavily search \
  --arg query="인과 그래프가 뭐야" \
  --arg limit=5

커넥터가 지원하는 작업을 호출합니다. provider마다 작업이 다릅니다. 커넥터 문서(또는 목록은 connectors get)를 참고하세요. 플래그:

<id> 커넥터
<operation> 작업 이름(예: search, list_channels)
--arg KEY=VALUE 플래그당 인자 하나, 또는:
--json <json> 전체 인자를 JSON으로

흔한 용도:

로테이션한 키가 되는지 스모크 테스트: nora connectors invoke c_tavily search --arg query=test
Flow 배선 없이 임시로 데이터 당겨오기

레시피

스크립트에서 자격증명 로테이션

# 파일에서 새 키 안전하게 읽기
cat new-key.txt | nora connectors update c_tavily --rotate-api-key -

이전 키가 60분 동안 유효해 다운타임 없이 로테이션할 수 있습니다.

모든 커넥터가 여전히 되는지 확인

for c in $(nora connectors list --json | jq -r '.[].id'); do
  echo "$c 테스트..."
  nora connectors invoke $c ping 2>&1 | grep -q "ok" && echo "  OK" || echo "  FAIL"
done

(작업은 provider마다 다릅니다. ping은 예시니, provider가 지원하는 걸 확인하세요.)

커넥터를 다른 워크스페이스로 옮기기

# 소스에서 읽기
key=$(cat ~/.nora-keys/tavily)

# 목적지에 생성
nora --workspace destination connectors create \
  --provider tavily \
  --name "Tavily" \
  --api-key "$key"

커넥터와 시크릿

커넥터는 특정 시스템(Tavily, Brave, …)용 타입 있는 연동입니다. 커넥터가 API 모양을 압니다
시크릿은 불투명한 문자열 값입니다(Tool 헤더, Trigger auth, DB URL에 씁니다). 타입 모양이 없습니다

일반 HTTP 연동에는 secrets:// 헤더를 쓴 Tool을 씁니다. 잘 알려진 provider(검색, 임베딩 등)에는 커넥터를 씁니다. 둘 다 워크스페이스 스코프고 저장 시 암호화됩니다.

커넥터 참조

커넥터 키가 필요한 Tool에서:

nora tools headers add t_search \
  --name Authorization \
  --value "secrets://connector:c_tavily/api_key"

툴이 호출 시점에 키를 보간합니다. 편집 시점에는 절대 아닙니다.

접근

워크스페이스 구성원은 커넥터를 나열하고 이름을 볼 수 있습니다. Manager와 Owner만 생성·로테이션·삭제할 수 있습니다. 실제 키 값은 CLI나 앱으로 어떤 사용자에게도 절대 돌아가지 않습니다.

삭제 감사

모든 삭제가 기록됩니다(감사 트레일 참고). 커넥터가 실수로 삭제됐으면, 참조가 깨진 Tool/파이프라인이 가장 빨리 알아채는 방법입니다. 다음 실행에 “connector not found”로 에러가 납니다.

CLI

SDK

Local App

nora connectors

명령

`connectors list` / `get`

`connectors create`

`connectors update`

`connectors delete`

`connectors invoke`

레시피

스크립트에서 자격증명 로테이션

모든 커넥터가 여전히 되는지 확인

커넥터를 다른 워크스페이스로 옮기기

커넥터와 시크릿

커넥터 참조

접근

삭제 감사

​명령

​connectors list / get

​connectors create

​connectors update

​connectors delete

​connectors invoke

​레시피

​스크립트에서 자격증명 로테이션

​모든 커넥터가 여전히 되는지 확인

​커넥터를 다른 워크스페이스로 옮기기

​커넥터와 시크릿

​커넥터 참조

​접근

​삭제 감사

명령

`connectors list` / `get`

`connectors create`

`connectors update`

`connectors delete`

`connectors invoke`

레시피

스크립트에서 자격증명 로테이션

모든 커넥터가 여전히 되는지 확인

커넥터를 다른 워크스페이스로 옮기기

커넥터와 시크릿

커넥터 참조

접근

삭제 감사