AWS IAM アウトバウンドIDフェデレーション
2025年11月19日に、AWS IAM でアウトバウンドIDフェデレーションという新機能が発表されました。
何ができるようになった?
AWSから外部サービスへの連携を、より安全な方法で実現できるようになりました。
これまでの一般的な構成では、以下のような方法が取られていました。
- APIキーやシークレットキーなど、長期的に有効な認証情報をAWS側に保存
- それらの認証情報を使って外部サービスのAPIを呼び出す
この方法は実装がシンプルである一方、
- 認証情報の漏洩リスク
- ローテーション管理の手間
といったセキュリティ上の問題を抱えていました。
一方、アウトバウンドIDフェデレーションでは、次のようなアプローチが可能になります。
- AWSが外部サービス向けに**短命のJWT(JSON Web Token)**を発行
- そのJWTを使って外部サービスにアクセス
- トークンは短時間で失効するため、万が一漏洩しても影響を最小限に抑えられる
これにより、長期的な認証情報を保持する必要がなくなり、セキュリティリスクを大きく軽減できます。
ただし、この仕組みを利用するためには、連携先の外部サービスがOIDC(OpenID Connect)に対応している必要がある点には注意が必要です。
すべての外部サービスで即座に使えるわけではありませんが、OIDC対応のサービスが増えている現在、非常に実用的な選択肢と言えるでしょう。
仕組み
Lambdaから外部サービスを利用する例で仕組みの説明をします。

- 事前準備
- 外部サービス側でIssuer登録
- OIDCの仕組みに従い、IssuerURLを登録します。
- IssuerURLの確認方法については、こちらで紹介しています。
- 外部サービス側でIssuer登録
- STSに対してGetWebIdentityToken APIを実行する
- STSからJWTが返される
- 外部サービスへのリクエストにJWTを含める
- 一般的にはAuthorizationヘッダーでBearerとして送るパターンが多いと思います。
- 外部サービスがJWKSエンドポイントにJWKSをリクエストする
- JWKSエンドポイントはOIDCの仕組みに従い、事前準備で登録したIssuerURLから解決されます。
- JWKSが返される
- 外部サービスがJWTを検証する
JWTの取得と確認
実際にLambdaでSTSからJWTを取得してみました。
アウトバウンドIDフェデレーションを有効にする
アウトバウンドIDフェデレーションを使用するにはアカウント単位でIAMの設定を変更する必要があります。

- IAMのコンソールから「アカウント設定」に進む
- STSセクション内で、アウトバウンドIDフェデレーションを有効にするボタンをクリックする(表示が
outboundFederation.enable.buttonのままの場合もある)

有効化されました。赤枠で囲っている部分がIssuerURLになります。
JWT取得のためのロール
STSでGetWebIdentityTokenを実行するため、以下の権限を付与したロールを設定します。今回はLambdaのロールです。
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": "sts:GetWebIdentityToken",
"Resource": "*",
"Condition": {
"ForAnyValue:StringEquals": {
"sts:IdentityTokenAudience": {AUDIENCE}
},
"NumericLessThanEquals": {
"sts:DurationSeconds": 300
}
}
}
]
}
- sts:IdentityTokenAudience
- JWTの送信先である外部サービスをオーディエンスとして設定します。
- NumericLessThanEquals
- トークンの最大有効期間が300秒以内であることを条件として設定しています。
- このあたりは要件によると思いますが、今回は公式ドキュメントどおりに設定してみました。
Lambdaのソースコード
Pythonのソースコードです。今回はLambdaのコンソール上で直接記述して実行しました。
import boto3
import os
sts_client = boto3.client('sts')
def lambda_handler(event, context):
# STSからトークン取得
response = sts_client.get_web_identity_token(
Audience=[os.environ['AUDIENCE']], # オーディエンスURL、ロールの条件に指定したものと同じ値
DurationSeconds=300,
SigningAlgorithm='RS256'
)
token = response['WebIdentityToken']
print(token)
return
上記の処理により、STSからJWTを取得できます。
実は、STSクライアントで get_web_identity_token を実行する際に問題が発生しました。この記事を参照するタイミングによっては、上記のソースコードをそのまま実行するとエラーが発生する可能性があります。詳しくはこちらを参照してください。
JWTの内容
取得できたJWTのペイロード部分のみ貼ります。
{
"aud": "{AUDIENCE}",
"sub": "arn:aws:iam::xxxx:role/role-iam-external-federation-test",
"https://sts.amazonaws.com/": {
"org_id": "o-xxxx",
"aws_account": "xxxx",
"ou_path": [
"o-xxxx/r-xxxx/"
],
"original_session_exp": "2025-12-25T20:44:44Z",
"source_region": "ap-northeast-1",
"principal_id": "arn:aws:iam::xxxx:role/role-iam-external-federation-test",
"lambda_source_function_arn": "arn:aws:lambda:ap-northeast-1:xxxx:function:iam-external-federation-test"
},
"iss": "https://xxxx.tokens.sts.global.api.aws",
"exp": 1766652585,
"iat": 1766652285,
"jti": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
※ セキュリティ上の配慮から、一部の値はマスクしています。
カスタムで任意の値を入れたJWTを作成することもできます。そのときは get_web_identity_token の Tags パラメータで指定します(公式ドキュメント)。
実装時に直面した課題
最初、先ほどのPythonコードを実行したときに以下のエラーが出ました。
'STS' object has no attribute 'get_web_identity_token'
get_web_identity_token メソッドがないとのこと。公式ドキュメントには載っているのに、なぜなのか疑問に思いました。
試しにSTSクライアントのメソッド一覧を出力してみます。
['__class__', '__delattr__', '__dir__', '__eq__', '__format__', '__ge__', '__getattr__', '__getattribute__', '__getstate__', '__gt__', '__hash__', '__init__', '__init_subclass__', '__le__', '__lt__', '__ne__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', '_convert_to_request_dict', '_emit_api_params', '_get_credentials', '_get_waiter_config', '_load_exceptions', '_make_api_call', '_make_request', '_register_handlers', '_resolve_endpoint_ruleset', 'assume_role', 'assume_role_with_saml', 'assume_role_with_web_identity', 'assume_root', 'can_paginate', 'close', 'decode_authorization_message', 'generate_presigned_url', 'get_access_key_info', 'get_caller_identity', 'get_federation_token', 'get_paginator', 'get_session_token', 'get_waiter']
たしかに存在しませんでした。
boto3のバージョンが古く、APIがまだ入っていないのではないかと疑いました。
boto3のバージョンを出力してみます。
1.40.4
2025年12月24日時点では、公式ドキュメント上のboto3のバージョンは1.42.16です。
今回Lambdaのコンソールで直接ソースコードを書いていたのですが、そのままboto3を使うとバージョンが最新ではない場合があるんですね。そこでこちらの記事を参考にLambdaレイヤーを使って最新のboto3を使えるようにしました。今回は最新版を利用したかったため、コマンドを少し変更して以下のように実行しました。
mkdir python
pip3 install boto3 -t ./python
zip -r ./python.zip .
その後、同じようにバージョンを出力すると 1.42.16 となり、get_web_identity_token を利用できるようになりました。
まとめ
長期に有効なAPIキーなどを保持する方式はセキュリティ上の懸念が残りやすいため、連携先がOIDCに対応している場合は、本機能の利用を検討する価値があると思います。
Discussion