速報

Microsoft 365で接続障害|OutlookやTeams予定表に影響し復旧作業が継続

CATEGORY

CodexをAmazon Bedrockで運用する|IAM認証・経路選択・監視の設計

※本ページのリンクにはプロモーションが含まれています。

開発者のCodexから認証を通り、3つの経路でクラウド推論基盤へ接続し、監視と費用を確認する流れのイラスト

目次

は2026年11月11日、OpenAI CodexをAmazon Bedrock経由で組織展開するための実践ガイドを公開しました。Codex自体は開発者の端末で動き、モデル推論だけをBedrockへ送る構成です。AWSを標準基盤にしているチームは、別の管理を増やさず、 Identity Centerの短期認証、利用、監視、費用配賦を既存の運用へ寄せられます。

ただし「Bedrockを選べば統制が完成する」という話ではありません。導入時に決めるべきなのは、Codexからモデルへ到達する経路、設定を書き換えられる範囲、取得する証跡、停止手順です。本稿ではAWSの新しいガイドを基に、まずNative AWS Accessで小さく検証し、必要に応じてAgentCore Gatewayや Gatewayへ進む判断を整理します。

スポンサーリンク

今回示された構成と対象

AWSの例ではGPT-5.6 Solを使い、Codexのモデルプロバイダーをamazon-bedrockへ切り替えます。利用できるモデルとリージョンは組み合わせごとに異なるため、Sol、Terra、Lunaを一括りにせず、導入先アカウントと実際に使う推論経路で確認する必要があります。Codex 、拡張、デスクトップ側のクライアント設定と、Bedrock側のモデル利用許可は別の確認項目です。

この構成の価値は、開発者が使うコーディングエージェントをAWSの・請求・監視へ接続できる点です。既にIAM Identity Centerを使っている組織なら、恒久的なAPIキーを各端末へ配る代わりに、普段のIDプロバイダーから短期AWSを取得できます。一方で、ローカルの読み取り、コマンド実行、変更内容のレビューはCodexクライアント側の運用です。モデルへの接続経路を変えても、生成された変更の正しさをBedrockが保証するわけではありません。

3つの経路を要件で選ぶ

経路向く状況運用上の焦点
Native AWS AccessIAMとリージョン制御で小規模な試行を始めたい利用者グループ、権限、端末設定、証跡を最小構成で確認
AgentCore GatewayAWS管理の経路、ルーティング、Guardrailsを使いたいゲートウェイ側の設定と利用者への帰属を設計
LLM Gateway既存ゲートウェイで予算・レート・モデル選択を強制したい追加基盤の可用性、ログ、費用、障害時の切り分けを負担

AWSは最初の既定案としてNative AWS Accessを挙げています。経路が短く、問題を「AWS認証」「Bedrockのモデル呼び出し」「Codexの設定」の三段階に分けて調べやすいからです。AgentCore Gatewayは、複数チームへ共通のルーティングやAWS管理機能を提供したい場合に合います。LLM Gatewayは、リクエスト経路でハードな予算上限やなどを強制する必要がある場合の候補です。独自実装は最短経路ではなく、既存選択肢で満たせない要件が文書化できたときに検討します。

スポンサーリンク

Native AWS Accessで行う最小検証

試行は専用グループ、非本番リポジトリ、停止責任者を用意して始めます。既存の全開発者へ権限を配る前に、IAM Identity Centerから発行されたで、選んだモデルを直接呼び出せるかを確認します。ここで失敗する場合は、Codex設定を触る前に、AWSプロファイル、対象リージョン、モデルID、推論プロファイル、IAM権限を切り分けます。

aws sso login --profile codex-bedrock
export AWS_PROFILE=codex-bedrock
aws bedrock-runtime converse \
  --model-id us.openai.gpt-5.6-sol \
  --messages '[{"role":"user","content":[{"text":"Reply with OK"}]}]' \
  --region us-east-2

モデルの直接呼び出しが成功したら、ユーザー単位または管理対象のCodex設定へプロバイダー、モデル、AWSプロファイル、リージョンを記録します。リポジトリ内の設定で推論先を自由に変更できる状態にすると、案件ごとのコード取得時に意図しない接続先へ切り替わる余地が生まれます。組織展開ではユーザー設定または端末管理側へ置き、変更権限と配布方法を決めておくのが実務的です。

model_provider = "amazon-bedrock"
model = "openai.gpt-5.6-sol"

[model_providers.amazon-bedrock.aws]
profile = "codex-bedrock"
region = "us-east-2"

最後に、非本番リポジトリで読み取り中心の安全なタスクを実行します。確認するのは回答が返ることだけではありません。想定したIAMロールが使われたか、承認したモデルとリージョンへ到達したか、必要なログとメトリクスが残ったか、権限を外した後に新しい呼び出しが拒否されるかまでを一組にします。稼働確認と確認を同じ試行で終えると、拡大時に「止め方が分からない」状態を避けられます。

監視データの役割を混同しない

AWSのガイドは、CodexのOpenTelemetry、Bedrockのサービスメトリクス、AWSのID記録、モデル呼び出しログ、Cost and Usage Reportを分けています。Codex側のメトリクスでは、ターン数、トークン量、要求、処理時間、などを追えます。しかし、その数値だけで「誰が請求を発生させたか」や「請求額はいくらか」を確定できるとは限りません。

  • クライアントの動作傾向はCodex OpenTelemetryで確認する
  • Bedrock側の呼び出し・遅延・エラーはサービスメトリクスで確認する
  • 利用者の帰属は採用した経路のAWS ID・監査記録で確認する
  • 実際の費用は請求データを根拠にし、推計値には推計方法を付ける

OpenTelemetry設定では、をログへ残すかどうかも判断が必要です。AWSの例はlog_user_prompt = falseとし、ローカルのADOT Collectorを通してCloudWatchへメトリクスを送ります。開発用リポジトリには未公開コードや顧客固有情報が含まれ得ます。観測性を高めるために入力内容を広く収集すると、監視基盤自体へデータが複製されます。必要な運用指標と、収集しない内容を先に定義してください。

スポンサーリンク

本番展開前の判断項目

第一に、対象モデルとリージョンの可用性を実際のアカウントで確かめます。記事中の例をそのままコピーしても、モデルアクセスや推論経路が異なれば動きません。第二に、Codexが送信し得るコード、プロンプト、ファイル、ツール出力の範囲を決めます。機密情報を扱う場合は、対象リポジトリと利用タスクを制限し、レビューとテストを条件へ残します。

第三に、予算超過や異常を検知する仕組みと、実際に止める仕組みを分けます。CloudWatchのアラームは変化を知らせますが、それだけでモデル呼び出しを遮断するわけではありません。停止にはIAM Identity Centerの割り当て解除、権限変更、クライアント設定の回収、ゲートウェイ側の制御など、採用経路に合った操作が必要です。短期セッションが残る場合の扱いも手順へ含めます。

第四に、モデル利用費だけで比較しないことです。Native AWS Accessは経路が簡潔ですが、端末ごとの設定配布やコレクター運用が必要です。Gatewayを置けば統一制御を増やせる一方、可用性、ログ、更新、障害対応の責任も増えます。小規模パイロットで得た認証、遅延、利用量、障害切り分けの証拠を基に、追加基盤が解決する具体的な課題があるかを判断します。

失敗時は三層に分けて調べる

接続できない場合は、最初からCodex全体を入れ直すのではなく、認証、Bedrock、Codexの三層に分けます。まずaws sts get-caller-identityで想定したセッションかを確認し、次にAWS CLIから同じリージョンとモデルIDで直接呼び出します。ここまで成功してCodexだけが失敗するなら、プロファイル名、設定ファイルの読込位置、クライアント再起動、IDE拡張がを継承しているかを確認します。

呼び出しは成功するのに運用記録が不足する場合は、CodexのOpenTelemetry出力、ADOT Collectorの受信、CloudWatchへの送信、Bedrock側ログの有効化を順に分けます。請求の帰属が期待と違う場合も、トークン数から推測せず、使ったAWSセッションとCURの明細を照合します。経路を一つずつ確定すると、権限不足とクライアント設定ミス、観測基盤の欠落を混同せずに済みます。

導入手順を一つのチェックリストにする

  1. パイロット利用者、非本番リポジトリ、停止責任者を決める
  2. 利用モデル、リージョン、推論経路、必要権限を確認する
  3. AWS CLIでBedrock Runtimeを直接呼び出し、認証とモデルアクセスを切り分ける
  4. Codexの管理対象設定へプロバイダー、モデル、プロファイル、リージョンを保存する
  5. 読み取り中心のタスクを実行し、期待するクライアント・AWS側の記録を確認する
  6. 利用者の帰属、請求データ、アラーム、停止操作を別々に検証する
  7. 権限を解除し、新しい呼び出しが拒否されることを確かめてから対象を広げる

今回のAWSガイドが示す重要な点は、CodexをBedrockへつなぐ設定そのものより、認証・経路・監視・請求・停止を一続きの運用として検証することです。既存のAWS運用を生かせる組織はNative AWS Accessから始め、共通ポリシーや強制制御が必要になった段階でGatewayを追加すると、初期負担と統制のバランスを取りやすくなります。

関連記事

スポンサーリンク

参考資料

この記事を書いた人

Ryohei

Webエンジニア / アプリ開発者 / 技術ブログ運営者

福岡のWeb制作会社に勤務するWebエンジニアです。10年以上にわたりWeb制作・開発に携わり、ヒアリングや進行管理から、コーディング、CMSの構築、システム開発、サーバーの構築・保守・運用まで、Webサイト制作の工程を幅広く担当しています。Webサイトは、これまでに100以上の構築・保守を手がけてきました。

個人でもWebサイトの制作・改修やWebアプリの開発・運用を行い、AIを活用した開発にも取り組んでいます。近年はWebセキュリティにも注力しています。

2015年から技術メディア「Into the Program」を運営し、実務や開発で得た知識をもとに、プログラミングの実装方法やWebサイトの運用・セキュリティ情報を発信しています。

主な分野
Webサイト構築・保守・運用 / HTML/CSS / JavaScript / PHP / WordPress / サーバー構築・保守・運用 / アプリ開発 / セキュリティ対策
資格・試験合格
情報セキュリティマネジメント試験
基本情報技術者試験
AWS認定ソリューションアーキテクト アソシエイト
PHP8技術者認定ウィザード
メディア運営
2015年〜

記事の作成・更新について

セキュリティ記事は、ベンダーの公式アドバイザリやCVE・JVNなどの一次情報を参照し、出典と情報確認日を記載します。実環境での検証を行った場合は、その環境と確認範囲を明示します。重要な追加情報や誤りを把握した場合は、内容を確認して追記・訂正します。

関連する記事

おすすめの書籍

キーワードから探す

スポンサーリンク

環境変数

OSや実行環境に設定しておき、プログラムから読み取って使う値。環境ごとの設定や秘密の値を渡すのに使う。

詳しく見る

マージ

Gitなどで、あるブランチの変更を別のブランチに取り込んで一つにまとめること。

詳しく見る

プロンプト

生成AIに入力する指示や質問の文章。内容や書き方によって、AIの出力が大きく変わる。

詳しく見る

ツール呼び出し

LLMが、用意された外部の関数やAPIを使うべきと判断し、その呼び出し内容を出力する仕組み。AIエージェントの基本になる機能。

詳しく見る

API

ソフトウェアやサービスの機能を、ほかのプログラムから決まった方法で呼び出して使えるようにした窓口。

詳しく見る

ロールバック

更新や変更で問題が起きたときに、システムやデータを変更前の状態に戻すこと。

詳しく見る

セッション

利用者とシステムの一連のやり取りを、ひとまとまりとして扱う単位。Webでは、ログイン状態などをページをまたいで保つために使う。

詳しく見る

レート制限

一定の時間に受け付けるリクエストの回数を制限する仕組み。サービスの過負荷や、総当たりなどの悪用を防ぐ。

詳しく見る

リポジトリ

ソースコードなどのファイルと、その変更の履歴をまとめて保管する場所。Gitで管理し、GitHubなどで共有する。

詳しく見る

認証情報

本人であることを証明するための情報。IDとパスワード、APIキー、アクセストークン、秘密鍵など。

詳しく見る

認証

アクセスしてきた相手が本人であることを確かめる仕組み。パスワードや生体情報、電子証明書などを使う。

詳しく見る

IDE

統合開発環境。コードの編集、実行、デバッグ、テストなど、開発に必要な機能をひとまとめにしたソフトウェア。

詳しく見る

CLI

コマンドラインインターフェース。文字のコマンドを入力してコンピューターやツールを操作する方法、またはそのためのツール。

詳しく見る

LLM

大規模言語モデル。大量の文章から学習し、文章の理解や生成ができるAIのモデル。ChatGPTやClaudeなどの基盤。

詳しく見る

リージョン

クラウドのデータセンターが置かれている地域の単位。東京・大阪など、どこでサービスを動かしデータを保存するかを選ぶ。

詳しく見る

IAM

ID・アクセス管理。誰が、どの資源に、どんな操作ができるかを管理する仕組み。AWSなどクラウドの権限管理を指すことも多い。

詳しく見る

APIキー

APIを利用するときに、利用者やアプリケーションを識別・認証するための文字列。漏えいすると不正利用につながる。

詳しく見る

AWS

Amazonが提供するクラウドサービス(Amazon Web Services)。仮想サーバーやストレージ、データベースなど多くのサービスがある。

詳しく見る