PythonのBoto3ライブラリでAWSセッションを作成する方法を徹底解説

Lambda関数やPythonコードからAWSの各種サービスを利用する場合、まず最初にAWSへのアクセス用セッションを確立する必要があります。セッションはデフォルト設定のまま使うこともできますし、用途に応じてカスタマイズすることも可能です。

課題

PythonのBoto3ライブラリを使用して、AWSセッションを作成することを目標とします。

解決のための手順・アルゴリズム

ステップ1：認証情報の準備

AWSセッションを作成するには、まず認証情報（クレデンシャル）をセットアップします。認証情報はIAMコンソールで確認できるほか、認証情報ファイルを手動で作成することもできます。デフォルトでは、ファイルは~/.aws/credentialsに配置されます。

認証情報ファイルの記述例：

[default]
aws_access_key_id = YOUR_ACCESS_KEY
aws_secret_access_key = YOUR_SECRET_ACCESS_KEY
aws_session_token = YOUR_SESSION_TOKEN
region = REGION_NAME

ステップ2：Boto3のインストール

以下のコマンドでBoto3をインストールします。

pip install boto3

ステップ3：Boto3ライブラリのインポート

Pythonスクリプト内でBoto3ライブラリをインポートします。

ステップ4：デフォルト認証情報でセッションを作成

デフォルトの認証情報を使ってセッションを作成する場合は、パラメータなしでSession()を呼び出すだけでOKです。

ステップ5：カスタムセッションを作成

セッションをカスタマイズしたい場合は、以下のパラメータを指定して渡します。

• aws_access_key_id（文字列）：AWSアクセスキーID

• aws_secret_access_key（文字列）：AWSシークレットアクセスキー

• aws_session_token（文字列）：AWS一時セッショントークン（STSなどで発行される場合に使用）

• region_name（文字列）：新しい接続を作成する際のデフォルトリージョン

• profile_name（文字列）：使用するプロファイル名。省略した場合は「default」プロファイルが使用されます。

実装例

以下のコードは、デフォルト認証情報とカスタム認証情報の両方について、AWSセッションを作成する例です。

import boto3

# デフォルトセッションを作成する
def create_aws_session():
    session = boto3.session.Session()
    # デフォルトセッションが作成され、任意のAWSサービスとの接続に利用できる
    return session

print(create_aws_session())

# カスタムセッションを作成する
def create_customized_session(aws_access_key, aws_secret_key, aws_token,
                              region_name=None, profile_name=None):
    session = boto3.session.Session(
        aws_access_key_id=aws_access_key,
        aws_secret_access_key=aws_secret_key,
        aws_session_token=aws_token,
        region_name=region_name,
        profile_name=profile_name
    )
    # region_name と profile_name はオプション引数で、デフォルト値は None
    print(session)
    return session

出力結果

# 認証情報ファイルや呼び出し時のパラメータに region_name が存在しない（またはNone）場合
Session(region_name=None)
Session(region_name=None)

# 認証情報ファイルまたは呼び出し時のパラメータに region_name が指定されている場合
Session(region_name=YOUR_REGION_NAME)
Session(region_name=YOUR_REGION_NAME)

まとめ

Boto3を使えば、わずか数行のコードでAWSセッションを作成できます。デフォルトの認証情報ファイル（~/.aws/credentials）を利用する方法はローカル開発環境に適しており、アクセスキーなどを明示的に渡すカスタムセッションは、一時的な認証情報や複数アカウントの切り替えが必要なケースで便利です。なお、本番環境ではアクセスキーをソースコードにハードコーディングせず、IAMロールや環境変数、AWS Secrets Managerなどの安全な認証情報管理手段を利用することを強く推奨します。