はじめに

​

認証

​

推奨: 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"