OpenAI と Anthropic
CloudFlow は OpenAI と Anthropic 向けの Admin API 接続をサポートしています。これらの接続により、フローからプロバイダの管理 API を呼び出して、API キーの管理、ユーザーやプロジェクトの一覧取得、利用状況の分析情報のクエリ、その他の組織レベルのオペレーションを実行できます。
OpenAI と Anthropic の Admin API 接続はアーリープレビューとして提供されています。アクセスをリクエストするには、サポートリクエストを送信してください。
Admin API 接続は、Integrations catalog で利用可能な OpenAI および Anthropic の請求インテグレーションとは独立しています。請求インテグレーションはコストと利用データを Cloud Intelligence に取り込みますが、Admin API 接続は CloudFlow のフローに、プロバイダの管理エンドポイントを直接呼び出す機能を提供します。
Admin API 接続は、破壊的な操作や平文の認証情報を返す操作を含む、組織全体に対する管理アクションを実行できます。接続を作成する前 に、各キーによって付与される権限を確認してください。
必要な権限
Admin API 接続を作成するには、お使いの DoiT アカウントに CloudFlow Manager 権限が必要です。既存の接続で認証情報をテスト、ローテーション、追加、削除するには、その接続に対する Owner または Editor アクセスも必要です。CloudFlow permissions と connection access levels を参照してください。
サポートされるプロバイダ
| Provider | Credential slots | 接続時に検証される機能 |
|---|---|---|
| OpenAI | Admin API key（必須） | Admin API キーの管理、ユーザーの一覧、プロジェクトの一覧 |
| Anthropic | Claude Code / Admin API key と Enterprise Analytics API key（いずれか 1 つ以上が必須） | API キーの管理、ユーザーの一覧、ワークスペースの一覧、分析コストレポートの読み取り |
これらの機能は、CloudFlow が認証情報を検証する際に確認されます。CloudFlow ビルダーでは、保存されたキーに十分な権限がある場合、アクションノードからプロバイダの Admin API オペレーションカタログ全体を呼び出すことができます。
Admin API 接続を作成する
接続ウィザードは 1 ステップのフォームです。フィールドは OpenAI と Anthropic で少し異なります。
-
DoiT コンソール にサインインし、上部ナビゲーションのメガメニューから オートメーション と オペレーション を選択し、CloudFlow を選択します。
-
サイドバーから 接続 を選択します。
-
接続したいプロバイダに応じて OpenAI または Anthropic タブを選択します。
-
接続を作成 を選択します。
-
Connection name に、この接続の一意の名前を入力します。
-
プロバイダの API 認証情報を入力します。
-
OpenAI: OpenAI Admin key に OpenAI Admin API key を入力します。この項目は必須です。
-
Anthropic: 次のいずれか 1 つ以上のキーを入力します。
- Claude Code / Admin API key: API キーの管理、ユーザーの一覧、ワークスペースの一覧などの組織管理オペレーションへのアクセスを付与します。
- Enterprise Analytics API key:
read:analyticsスコープを使用した読み取り専用アクセスを付与します。
-
-
Admin API key を入力した場合（OpenAI では必須、Anthropic では任意）、CloudFlow で使用するオペレーションに必要な書き込み権限がキーに付与されていることを確認するチェックボックスを選択します。
-
接続を作成 を選択します。CloudFlow がプロバイダの API に対して認証情報を検証し、成功すると接続の詳細が表示されます。
-
接続の詳細を確認します。確認ビューには次の内容が表示されます。
- Organization: プロバイダ組織の名前
- Organization ID: プロバイダの組織 ID
- Capabilities: キーに付与された権限に基づいて、この接続を通じて利用可能なオペレーション
-
Done を選択して接続リストに戻ります。
認証情報を管理する
Admin API 接続を作成した後は、接続の概要画面から認証情報をテスト、ローテーション、追加、および削除できます。
-
DoiT コンソール にサインインし、上部ナビゲーションのメガメニューから オートメーション と オペレーション を選択し、CloudFlow を選択します。
-
サイドバーから 接続 を選択します。
-
OpenAI または Anthropic タブを選択します。
-
管理したい接続を選択します。接続の概要には、各 Credential slot ごとにカードが表示されます。
各認証情報カードには、認証情報のステータス、組織名、Organization ID、Capabilities、最後に認証情報が検証されたタイムスタンプが表示されます。
保存済み認証情報をテストする
保存済み認証情報が有効であることを確認するには、認証情報カードで Test stored key を選択してください。CloudFlow がプロバイダの API を呼び出し、結果を表示します。
認証情報をローテーションする
既存の認証情報を新しいキーに置き換えるには、次の手順を実行してください。
-
認証情報カードで Rotate key を選択します。
-
ダイアログで新しいキーを入力します。
-
Admin API key をローテーションする場合は、CloudFlow で必要とされる書き込み権限がキーに付与されていることを確認するチェックボックスを選択します。
-
Rotate key を選択します。CloudFlow が新しい認証情報を検証し、保存済みキーを置き換えます。
認証情報を追加する（Anthropic のみ）
Anthropic 接続は 2 つの独立した Credential slot をサポートしています。接続を 1 つのキーだけで作成した場合、後からもう 1 つを追加できます。
-
Not configured と表示されている認証情報カードで Add key を選択します。
-
ダイアログで API key を入力します。
-
Admin API key を追加する場合は、必要な書き込み権限がキーに付与されていることを確認するチェックボックスを選択します。
-
Add key を選択します。
認証情報を削除する（Anthropic のみ）
もう一方の Credential slot が構成済みである場合、Anthropic 接続から単一の認証情報を削除できます。Anthropic 接続には常に少なくとも 1 つの有効な認証情報が必要です。
-
認証情報カードで Remove key を選択します。
-
確認ダイアログで 削除 を選択します。認証情報が削除され、それに依存する CloudFlow のオペレーションは利用できなくなります。
1 つの認証情報のみが構成されている場合、Remove key ボタンは無効化されます。既存の認証情報を削除する前に、もう一方の認証情報を追加してください。
フローで Admin API 接続を使用する
Admin API 接続を作成した後、CloudFlow ビルダーで OpenAI または Anthropic のアクションノードを設定する際に、その接続を選択できます。ノードに接続を割り当てる一般的な方法については、Use connections を参照してください。