管理者キーを使用すると、権限を持つワークスペースの所有者と管理者は、対応する ChatGPT および Codex の管理 API にツールやサービスを接続できます。選択したワークスペースと権限に応じて、キーでは分析、ユーザーとグループの管理、招待、使用量上限、コンプライアンスログとアクティビティログ、またはサービスアカウント管理を利用できます。
各管理者キーは、1 つの ChatGPT ワークスペースに適用されます。他のワークスペース、テナント全体の管理、API プラットフォーム組織、広告アカウント、モデル、モデル推論へのアクセス権は付与されません。
テナントまたはワークスペースの選択については、管理コンソールでのテナント管理をご覧ください。
ワークスペースでの提供状況とアクセス権の確認
管理者キーは、ChatGPT Enterprise、ChatGPT Edu、ヘルスケア向け ChatGPT を含む、対象の管理対象 ChatGPT ワークスペースで利用できます。管理するワークスペースで、所有者または管理者のロールが割り当てられている必要があります。
アクセス権は、選択した ChatGPT ワークスペースで割り当てられている所有者または管理者のロールによって決まります。グローバル管理者、API プラットフォーム組織の所有者、またはカスタムのワークスペースロールを持つユーザーであるだけでは、管理者キーへのアクセス権は付与されません。
組み込みのワークスペースロールについて詳しくは、ChatGPT Enterprise でのメンバー、シートの種類、ロール、アクセス権の管理をご覧ください。
ロール別のアクセス権
ワークスペースの所有者は、すべて、読み取り専用、またはカスタムの権限を持つキーを作成できます。自分のワークスペースにある管理者キーをすべて編集または取り消せます。
ワークスペースの管理者は、権限カテゴリごとに利用可能なアクセスレベルを選択し、カスタムスコープのキーを作成します。作成されたキーにはカスタムと表示されます。編集または取り消せるのは自分が作成したキーのみで、かつ、そのキーの権限を現在のロールで利用できる場合に限られます。
選択したワークスペースで所有者または管理者のロールを持たないグローバル管理者は、そのワークスペースの管理者キーを作成、管理できません。
管理者キーの権限の選択
所有者向けの権限プリセット
ワークスペースの所有者は、次の権限プリセットから選択できます。
すべてでは、利用可能な場合の所有者専用権限を含め、選択したワークスペースで利用可能な管理権限が付与されます。
読み取り専用では、選択したワークスペースで利用可能な読み取り専用権限が付与されます。
カスタムでは、権限カテゴリごとに利用可能なアクセスレベルを選択できます。
カテゴリ別の管理権限
ワークスペースの管理者には、すべて、読み取り専用、カスタムのプリセット選択欄は表示されません。権限で、利用可能なカテゴリごとになし、読み取り、または書き込みを選択します。作成されたキーにはカスタムと表示されます。
ワークスペースによっては、アプリ、使用量上限、グループ管理、ユーザー、招待、Codex 分析 API、Enterprise 分析 API、ワークスペース分析、コスト、サービスアカウントなどのカテゴリを利用できます。カテゴリによっては読み取りまたは書き込みの一方のみをサポートし、関連機能が利用可能な場合にのみ表示されるものもあります。
一般的な権限の対応関係は次のとおりです。
Codex 分析 API > 読み取り：
codex.enterprise.analytics.read使用量上限 > 読み取り：
chatgpt.enterprise.usage_limit.read使用量上限 > 書き込み：
chatgpt.enterprise.usage_limit.writeおよびchatgpt.enterprise.usage_limit.readユーザー > 読み取り：利用可能な場合は
chatgpt.enterprise.user.read
広範なコンプライアンス権限、会話メッセージ、ロールと権限は、サポートされている場合に限り、ワークスペースの所有者のみが利用できます。ワークスペースの管理者も、監査ログや認証ログなど、個別のアクティビティログカテゴリを選択できる場合があります。
管理者キーの作成
管理コンソールにサインインします。
必要に応じてテナントを選択し、自分に所有者または管理者のロールが割り当てられている ChatGPT ワークスペースを選択します。
認証情報を開き、管理者キーを選択します。
新しい管理者キーを作成を選択し、用途が分かる名前を入力します。
有効期限として、なし、30 日、60 日、90 日、またはカスタムを選択します。カスタムの有効期限は、1～365 日の範囲で設定できます。
連携に必要な権限を選択します。ワークスペースの所有者はすべて、読み取り専用、またはカスタムを選択できます。ワークスペースの管理者は、カテゴリごとに利用可能な権限を選択します。
送信を選択し、シークレットをコピーして安全に保管します。このシークレットは後から再表示できません。
ワークスペースの所有者が作成するキーでは、権限のデフォルトがすべて、有効期限のデフォルトがなしに設定されている場合があります。キーを作成する前に、両方の設定を確認してください。
管理者キーの確認、編集、取り消し
管理コンソールで ChatGPT ワークスペースを開き、認証情報 > 管理者キーに移動します。各キーの名前、ステータス、追跡 ID、マスキングされたシークレット、作成者、権限、最終使用日、有効期限を確認します。
キーの名前または権限を変更するには、その他のオプションメニュー（•••）を開き、編集を選択して変更を加え、変更を保存を選択します。
キーの使用を停止するには、その他のオプションメニュー（•••）を開き、取り消すを選択して、管理者キーを取り消すで確定します。
ワークスペースの所有者は、選択したワークスペースのすべてのキーを編集または取り消せます。ワークスペースの管理者が編集または取り消せるのは自分が作成したキーのみで、かつ、そのキーの権限を現在のロールで利用できる場合に限られます。所有者専用権限を持つキーの管理は、ワークスペースの所有者に依頼してください。設定済みの有効期限は変更できません。
取り消されたキーは、変更が反映されると機能しなくなります。使用中のキーを取り消す前に、代替キーを作成し、影響を受けるすべての連携を更新してください。
コンプライアンスと機密データについて
一部の管理者キー権限では、機密性の高いワークスペースのアクティビティやコンテンツが公開される可能性があります。広範なコンプライアンスアクセス権または会話メッセージへのアクセス権を付与できるのは、ワークスペースの所有者のみです。
ワークスペースの管理者は、監査ログ、認証ログ、アプリログなど、対応する個別のログカテゴリへのアクセス権を付与できる場合があります。個別のログにも機密情報が含まれる可能性があるため、各カテゴリを慎重に確認してください。
コンプライアンス API とデータアクセスについては、Enterprise および Edu のお客様向け OpenAI コンプライアンスプラットフォームをご覧ください。
ChatGPT ワークスペースの管理 API リクエストでは、https://api.chatgpt.com/v1を使用します。たとえば、現在のワークスペースメンバーを一覧表示するには、/manage/workspaces/{workspace_id}/usersを使用します。/v1/organization/配下のエンドポイントは API プラットフォーム組織を管理するもので、API プラットフォーム組織の管理者キーが必要です。
エンドポイントのパス、リクエストとレスポンスのスキーマ、必要なスコープについては、管理 API リファレンスをご覧ください。
管理者キーと他の認証情報の違い
ワークスペース管理者キーは、1 つの ChatGPT ワークスペースに対する、対応済みの ChatGPT および Codex 管理 API の認証に使用します。モデル推論へのアクセス権は付与されません。
Codex サービスアカウントのアクセストークンは、Codex の自動化に使用する人間以外のワークスペース ID を認証します。管理 API リクエストの認証には使用できません。設定方法については、Codex サービスアカウントの作成と管理をご覧ください。
API プラットフォーム組織の管理者キーは API プラットフォームで個別に管理され、ChatGPT ワークスペースの管理には使用できません。
API プラットフォーム組織用のキーが必要な場合は、API プラットフォーム組織の管理者キーを開いてください。ワークスペース固有の ChatGPT 管理 API エンドポイントには、ワークスペース管理者キーを使用します。API プラットフォーム組織のエンドポイントには、別の認証情報が必要です。
アクセス権と不足している権限のトラブルシューティング
正しい OpenAI アカウントでサインインし、目的のテナントと ChatGPT ワークスペースを選択していることを確認してください。
ワークスペースのメンバー資格が有効で、ワークスペースロールが所有者または管理者であることを確認してください。
ChatGPT ワークスペースが管理者キーの対象であることを確認してください。提供状況は、プランや展開状況によって異なる場合があります。
権限カテゴリが表示されない場合は、選択したワークスペースで該当機能を利用でき、自分のロールにアクセスが許可されていることを確認してください。必要なカテゴリを引き続き利用できない場合は、無関係な権限を選択せず、OpenAI サポートにお問い合わせください。
キーを編集または取り消せない場合は、そのキーを自分が作成したこと、および現在のロールでその権限を利用できることを確認してください。所有者専用権限を持つキーの管理は、ワークスペースの所有者に依頼してください。
以前は機能していたキーが機能しなくなった場合は、ステータスと有効期限を確認し、期限切れまたは取り消し済みでないことに加え、作成者が必要な権限を持つ有効なワークスペースロールを引き続き保持していることを確認してください。
問題が解決しない場合は、OpenAI サポートにお問い合わせください。求められた場合はテナント ID、ワークスペースの名前または ID、スクリーンショットを添付してください。ただし、管理者キーのシークレットは絶対に共有しないでください。
管理者キーの保護
カスタム権限を選択し、連携に必要なアクセス権のみを付与してください。
可能な場合は有効期限を設定してください。なしを選択すると、キーに有効期限は設定されません。キーが取り消された場合、作成者が必要なワークスペースアクセス権を失った場合、または作成者のアカウントが無効化された場合も、キーは機能しなくなることがあります。
連携やワークフローごとに別のキーを使用してください。
シークレットは安全なシークレットマネージャーに保管してください。メール、チャット、サポートリクエストでは絶対に送信しないでください。
使用状況と有効期限を定期的に確認し、不要になったキーを取り消してください。