Platform For AI:LLM インテリジェントルーティングワークベンチ

7.1 新規ユーザーのプロビジョニング

リクエスト： POST /api/provision

例：

curl -X POST "https://gateway.example.com/api/provision" \
  -H "Authorization: Bearer <admin_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "田中太郎",
    "email": "taro.tanaka@company.com",
    "employee_id": "12345",
    "department": "Engineering"
  }'

7.2 プロビジョニングによるキーのリセット

ユーザーが既に存在するが、新しい API キーが必要な場合にこの方法を使用します。

リクエスト： POST /api/provision/reset

例：

curl -X POST "https://gateway.example.com/api/provision/reset" \
-H "Authorization: Bearer <admin_api_key>" \
-H "Content-Type: application/json" \
-d '{"employee_id":"12345"}'

7.3 プロビジョニングリンクの検証

ユーザーが provision_url を開くと、Web ページがこのエンドポイントを呼び出してトークンを検証し、ユーザー情報と API キーを取得します。

リクエスト： GET /api/provision/verify?token={token}

新規ユーザー登録 (プロビジョニング)

プロビジョニング方式では、API キーをワンタイムリンクで配布できるため、より安全です。

# 1. ユーザーを作成し、プロビジョニングリンクを取得します。
curl -X POST "https://gateway.example.com/api/provision" \
-H "Authorization: Bearer <admin_api_key>" \
 -H "Content-Type: application/json" \
 -d '{"name":"田中太郎","email":"taro.tanaka@company.com","employee_id":"12345","department":"Engineering"}'
# 2. 返された provision_url をユーザーに送信します (例：メールやインスタントメッセージ)。

# 3. ユーザーがリンクを開くと、ページが自動的に /api/provision/verify を呼び出して API キーを取得します。

新規ユーザー登録 (直接作成)

# 1. ユーザーが既に存在するかどうかを確認します。
curl -X GET "https://gateway.example.com/api/users/check?employee_id=12345" \
-H "Authorization: Bearer <admin_api_key>"

# 2. ユーザーが存在しない場合は、ユーザーを作成します。
curl -X POST "https://gateway.example.com/api/users" \
-H "Authorization: Bearer <admin_api_key>" \
-H "Content-Type: application/json" \
-d '{"name":"田中太郎","employee_id":"12345","department":"Engineering"}'

# 3. 返された api_key をユーザーに送信します。

ユーザーのオフボーディング (無効化または削除)

# ユーザーを無効化します (推奨)。
curl -X PUT "https://gateway.example.com/api/users/user_xxx" \
-H "Authorization: Bearer <admin_api_key>" \
-H "Content-Type: application/json" \
-d '{"enabled": false}'

# または、ユーザーを削除します。
curl -X DELETE "https://gateway.example.com/api/users/user_xxx" \
-H "Authorization: Bearer <admin_api_key>"

API キーの復旧 (プロビジョニング)

# 従業員IDでキーをリセットし、新しいプロビジョニングリンクを送信します。
curl -X POST "https://gateway.example.com/api/provision/reset" \
-H "Authorization: Bearer <admin_api_key>" \
-H "Content-Type: application/json" \
-d '{"employee_id":"12345"}'

# 返された provision_url をユーザーに送信します。

API キーの復旧 (直接リセット)

# 従業員IDでユーザーを確認します。
curl -X GET "https://gateway.example.com/api/users/check?employee_id=12345" \
-H "Authorization: Bearer <admin_api_key>"

# 返された user_id を使用して API キーをリセットします。
curl -X POST "https://gateway.example.com/api/users/user_xxx/regenerate-key" \
-H "Authorization: Bearer <admin_api_key>"