소개

​

인증

​

권장: Bearer 토큰

Authorization: Bearer cbr_live_your_api_key_here

​

대안: X-Api-Key 헤더

X-Api-Key: cbr_live_your_api_key_here

​

API 키 생성

1. CaseBender 인스턴스에 로그인합니다
2. 계정 → API 키로 이동합니다
3. API 키 생성을 클릭합니다
4. 키의 이름, 설명, 등급(tier), 범위(scope)를 구성합니다
5. 키를 즉시 저장하세요 — 키는 한 번만 표시되며 이후에는 다시 확인할 수 없습니다

cbr_live_a1b2c3d4e5f6g7h8i9j0...

​

API 키 사용

​

cURL 사용

curl -X GET https://your-instance.casebender.com/api/v1/alerts \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"

​

Python 사용 (requests 라이브러리)

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY_HERE",
    "Content-Type": "application/json"
}

response = requests.get(
    "https://your-instance.casebender.com/api/v1/alerts",
    headers=headers
)

​

JavaScript/Node.js 사용 (fetch)

const response = await fetch(
  "https://your-instance.casebender.com/api/v1/alerts",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY_HERE",
      "Content-Type": "application/json",
    },
  }
);

​

API 키 등급

​

API 키 범위

• alerts:read - 알림 읽기
• alerts:write - 알림 생성 및 업데이트
• cases:read - 케이스 읽기
• cases:write - 케이스 생성 및 업데이트
• observables:read - 관찰 가능 항목 읽기
• observables:write - 관찰 가능 항목 생성 및 업데이트
• users:read - 사용자 정보 읽기
• admin:* - 관리 작업

​

일반적인 인증 오류

• 401 Unauthorized:
  • Authorization 헤더 누락
  • 잘못되었거나 만료된 API 키
  • API 키가 취소되었거나 정지됨
• 403 Forbidden:
  • API 키에 해당 작업에 필요한 범위가 없음
  • TLP/PAP 액세스 제한
• 429 Too Many Requests:
  • 등급의 속도 제한 초과

​

보안 모범 사례

• API 키를 공유하지 마세요 — 비밀번호처럼 취급하세요
• API 키를 정기적으로 교체하세요 — 오래된 키를 취소하고 주기적으로 새 키를 생성하세요
• 애플리케이션마다 다른 키를 사용하세요 — 애플리케이션별로 액세스를 취소할 수 있습니다
• 만료 날짜를 설정하세요 — 가능한 경우 API 키가 자동으로 만료되도록 구성하세요
• 필요한 최소 범위만 사용하세요 — 애플리케이션에 필요한 권한만 부여하세요

​

레거시 인증 (지원 중단)

# 지원 중단 — 새 통합에는 사용하지 마세요
curl -X GET https://your-instance.casebender.com/api/v1/alerts \
  -H "x-api-key: YOUR_ACCESS_KEY" \
  -H "x-api-secret: YOUR_SECRET_KEY"