🆔

AWS IAM アウトバウンドIDフェデレーション

に公開
2026/04/17

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の確認方法については、こちらで紹介しています。
  1. STSに対してGetWebIdentityToken APIを実行する
  2. STSからJWTが返される
  3. 外部サービスへのリクエストにJWTを含める
    • 一般的にはAuthorizationヘッダーでBearerとして送るパターンが多いと思います。
  4. 外部サービスがJWKSエンドポイントにJWKSをリクエストする
    • JWKSエンドポイントはOIDCの仕組みに従い、事前準備で登録したIssuerURLから解決されます。
  5. JWKSが返される
  6. 外部サービスが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