APIキー管理

​

APIキーの仕組み

Authorization: Bearer jtb_xxxxxxxxxxxx

​

APIキーの作成

​

APIキー一覧

​

APIキーの失効

• キーは即座に無効化されます。
• このキーを使用するすべてのAPIリクエストは401 Unauthorizedエラーを返します。
• この操作は永続的で元に戻すことはできません。

​

認証スコープ

​

APIキーの使用

​

REST API

curl -X POST \
  https://toolbox-api.jinba.dev/v1/orgs/{orgId}/toolsets/{slug}/tools/{toolSlug}/run \
  -H "Authorization: Bearer jtb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice"}'

​

TypeScript SDK

import { createClient } from "@jinba-toolbox/sdk";

const client = createClient({
  apiKey: process.env.JINBA_TR_API_KEY,
  organizationId: "your-org-id",
});

const result = await client.run("slack-tools", "post-message", {
  channel: "#general",
  text: "Hello from Jinba Toolbox!",
});

​

MCP Endpoint

​

個人キーと組織APIキー

​

ベストプラクティス

• 分かりやすい名前を付ける — 用途と環境でキーに名前を付けます（例：「Production API Server」、「Staging CI」）。必要な場合にどのキーを失効させるべきか特定しやすくなります。
• 定期的にキーをローテーションする — 漏洩の影響を限定するために、定期的に新しいキーを作成し、古いキーを失効させます。
• キーをソースコードにコミットしない — キーは環境変数またはシークレット管理ツールに保存します。
• 環境ごとに別々のキーを使用する — 開発、ステージング、本番環境ごとに個別のキーを作成します。
• 未使用のキーを失効させる — キーが不要になったら、すぐに失効させます。「Last Used」カラムを確認して、使用されていないキーを特定します。
• 組織キーを優先する — アプリケーション統合には、個人キーではなく組織スコープのキーを使用します。