Entity Enricher에 대한 프로그래밍 방식 액세스를 위한 API key를 생성하세요. 서비스 간 통합, CI/CD 파이프라인, 자동화된 워크플로에는 organization access key를 사용하세요.
Entity Enricher는 두 가지 유형의 API 키를 지원하며, 각각 서로 다른 사용 사례에 적합합니다:
사용자 계정에 연결되지 않고 자체 역할을 가진 독립 실행형 키입니다. 서비스 간 통합에 가장 적합한 선택입니다.
특정 사용자 계정에 연결된 키입니다. 생성자의 역할을 상속하며 사용자 계정 변경의 영향을 받습니다.
ent_a1b2c3d4e5f6g7h8키는 ent_ 접두사 뒤에 무작위 바이트가 붙습니다. 전체 키는 생성 시점에 한 번만 표시되며 나중에 다시 조회할 수 없습니다.
액세스 키(Entity Enricher의 API 호출용)는 데이터베이스에 SHA256 해시로 저장되므로, 데이터베이스에 접근하더라도 원래 키를 복구할 수 없습니다. 식별을 위해 처음 12자(접두사)만 평문으로 저장됩니다.
제공업체 키(Anthropic, OpenAI 같은 LLM API 키)는 Fernet 대칭 암호화(AES-128-CBC + HMAC)를 사용하여 저장 시 암호화됩니다. LLM 제공업체와 인증하려면 런타임에 복호화할 수 있어야 합니다. 마지막 4자만 일반 텍스트로 저장됩니다.
ent_ 접두사와 해시만 저장되므로, 이 화면에서 복사해 두지 않은 키는 복구할 수 없고 새로 발급받아야 합니다.애플리케이션의 API Keys 페이지에서 또는 REST API를 통해 프로그래밍 방식으로 key를 생성하세요:
| 필드 | 설명 |
|---|---|
| 이름 | 식별을 위한 설명적 이름(예: "CI/CD Pipeline", "n8n Integration") |
| 역할 | 권한 수준: owner, editor 또는 operator. 키가 액세스할 수 있는 항목을 결정합니다. |
| 범위 | 읽기, 쓰기 또는 둘 다입니다. 키가 데이터를 수정할 수 있는지 아니면 읽기만 할 수 있는지 제어합니다. |
| 만료 | 선택적 만료일입니다. 만료일이 없는 키는 폐기될 때까지 유지됩니다. |
모든 요청에 X-API-Key 헤더로 API 키를 전송하세요:
curl -H "X-API-Key: ent_your_key_here" \
https://your-instance.example.com/api/enrichment/options| 메서드 | 헤더 | 사용 사례 |
|---|---|---|
| API 키 | X-API-Key: ent_... | 서비스 간 통신, CI/CD, 자동화 |
| Bearer 토큰 | Authorization: Bearer <jwt> | 웹 클라이언트, 대화형 세션 |
| OAuth 2.1 | Authorization: Bearer <access_token> | 커넥터와 AI 클라이언트 — 공유 키가 아니라 앱별로 취소 가능한 권한 부여입니다 |
API 키의 역할에 따라 접근할 수 있는 엔드포인트가 결정됩니다:
| 엔드포인트 범주 | 최소 역할 |
|---|---|
| 보강 (단일, 배치) | 연산자 |
| 레코드(목록, 상세, 삭제) | 연산자 |
| 스키마 (읽기) | 연산자 |
| 스키마 (생성, 편집, 삭제) | 편집기 |
| 융합 | 연산자 |
| 프로바이더 정보 | 연산자 |
| 비용 분석 | 연산자 |
| API 키 관리 | 소유자 |
| 사용자 관리 | 소유자 |
API Keys 페이지는 사용 통계와 함께 모든 조직 키의 전체 목록을 제공합니다:
API Keys 페이지에는 용도가 서로 다른 다섯 개의 탭이 있습니다. 네 개는 모든 사용자용이고, Global Keys는 시스템 관리자용입니다:
독립적인 청구를 위한 조직의 LLM 제공업체 API 키(Anthropic, OpenAI 등)입니다. 제공업체당 여러 개의 키를 지원하며 LRU 순환이 자동으로 이루어집니다. 테스트에 실패한 키는 다시 테스트하거나 교체할 때까지 순환에서 제외됩니다. BYOK 시스템에 대해서는 Models & Pricing을 참조하세요.
프로바이더 키는 Fernet 대칭 암호화(HMAC 인증이 포함된 AES-128-CBC)를 사용하여 저장 시 암호화됩니다. LLM API 호출을 수행할 때 런타임에만 복호화됩니다. 표시 목적으로 마지막 4자만 평문으로 저장됩니다.
관리자가 관리하는 시스템 전체 LLM 제공자 키입니다. 사용할 수 있는 조직 키가 없을 때 대체 수단으로 사용됩니다. 제공자당 여러 키를 지원하며 LRU 방식으로 순환합니다. 사용된 지 가장 오래된 활성 키가 다음 차례가 되고, 관리자가 비활성화하거나 테스트에서 유효하지 않은 것으로 표시된 키는 순환에서 제외됩니다. 제공자에 사용할 수 있는 키가 없으면 실행이 시작되지 않고 거부됩니다.
Entity Enricher 자체 API를 위한 조직 액세스 키입니다. 외부 시스템이 보강, 스키마, 레코드 등의 엔드포인트를 프로그래밍 방식으로 호출할 때 사용합니다. 엔드포인트 문서는 API 참조를 확인하세요.
OAuth 2.1로 승인한 애플리케이션입니다 — claude.ai 커넥터 디렉터리, Claude Desktop, Make 및 n8n 연결이 여기에 해당합니다. 각 행은 공유 비밀 키가 아니라 취소 가능한 권한 부여입니다. 여기서 취소하면 다른 연동에는 영향을 주지 않고 해당 앱의 토큰만 무효화됩니다. 소유자는 자체 호스팅 n8n 인스턴스용 OAuth 클라이언트를 등록할 수도 있습니다.
포트를 열지 않고도 로컬 Ollama를 플랫폼에 노출하는 셀프서비스 Ollama 터널용 자격 증명입니다. Ollama Tunnel 가이드를 참고하세요.