エンタープライズロールアウトに対する OpenAI Codex のセットアップ
このパスは、開発者フリート全体で Codex を運用し、自動的に属性付けされた一貫性のあるテレメトリを必要とし、長期的な認証情報を配布しない場合に使用します。開発者はコーポレート ID プロバイダー (IdP) を介して認証されるため、ID と組織の属性は手動で入力されるのではなく、ディレクトリから取得されます。メトリクスは引き続き Amazon CloudWatch に到達し、アイデンティティデータと組織データが OTel リソース属性として送信されるため、同じ Coding Agent Insights ダッシュボードにデータが表示されます。
このパスは、Okta、Microsoft Entra ID (Azure AD)、Auth0、AWS IAM Identity Center などのコーポレートシングルサインオン (SSO) プロバイダーをサポートします。
仕組み
エンタープライズロールアウトでは、開発者の ID は IdP から CloudWatch に到達するテレメトリに流れます。一般的なデプロイには以下のコンポーネントが含まれます。
-
ID フェデレーション — 開発者は IdP (Okta、Microsoft Entra ID、Auth0、または AWS IAM Identity Center) を通じてサインインします。IdP は、開発者の E メールと組織属性 (部門、チーム、コストセンターなど) を提供します。
-
一元化された Amazon Bedrock アクセス — フェデレーションk開発者は、推論のために Amazon Bedrock へのアクセスを許可するロールを引き受けるため、静的モデル認証情報は配布しません。
-
ローカルコレクター — 開発者ごとの OpenTelemetry コレクターは、
localhost上の Codex からメトリクスを受け取り、アイデンティティと組織のリソース属性をスタンプし、AWS Signature Version 4 (SigV4) でリクエストに署名して、CloudWatch ネイティブ OTLP エンドポイントに転送します。コレクターは開発者のフェデレーション認証情報で署名するため、ベアラートークンは配布されません。
フリートにロールアウトする
一般的なエンドツーエンドのロールアウトは、これらのステージに従います。
組織全体で Codex テレメトリをロールアウトするには
-
ID フェデレーションを設定します。IdP を AWS IAM Identity Center に接続し (または OIDC フェデレーションを直接設定し)、部門、チーム、コストセンターなど、使用状況を属性付けするディレクトリ属性をマッピングして、ロールアウトできるようにします。
-
Amazon Bedrock アクセスを一元化します。フェデレーション開発者に、Codex が必要とする Amazon Bedrock モデルの呼び出しを許可するロールを付与します。このロールは、許可した AWS リージョンとモデルに限定されます。
-
インフラストラクチャをデプロイします。提供された AWS CloudFormation テンプレートをデプロイして、フリートのロール、ポリシー、サポートリソースを作成します。
-
開発者設定を生成して配布します。提供されたセットアップスクリプトを使用して、各開発者のコレクター設定を生成します。このスクリプトは、フェデレーションセッションから
user.emailとuser.idを取得し、IdP から組織のリソース属性 (部門、チーム、コストセンター、組織など) を入力します。次に、レンダリングされたコレクター設定と、ローカルコレクターを指す Codex[otel]ブロックを書き込みます。 -
開発者が Codex を実行します。各開発者は SSO を通じてサインインし、ローカルコレクターを起動して Codex を実行します。メトリクスは Codex からローカルコレクターを経由して CloudWatch に流れ、開発者とその組織に自動的に帰属します。
注記
このパスでは、アイデンティティ属性と組織属性が OTel リソース属性として出力されます。これは、ベアラートークンパスが生成するのと同じ形です。その結果、同じ Coding Agent Insights ダッシュボードに追加設定なしでデータが表示されます。
完全なガイダンス
CloudFormation テンプレート、ID フェデレーションセットアップ、フリートセットアップスクリプトなど、継続的に更新される完全なガイダンスについては、GitHub の「Codex on Amazon Bedrock のガイダンス