すべてのプロダクト
Search
ドキュメントセンター

:AssumeRoleWithSAML

最終更新日:Oct 27, 2026

AssumeRoleWithSAML 操作を呼び出して、SAML ロールベースのシングルサインオン (SSO) 中に RAM ロールを偽装するための一時的な認証情報 (STS トークン) を取得します。

操作説明

開始する前に

  • 外部 ID プロバイダー (IdP) から SAML 応答を取得していることを確認してください。

  • RAM に SAML IdP を作成していることを確認してください。詳細については、「SAML IdP の作成」または「 CreateSAMLProvider 」を参照してください。

  • RAM に、信頼できるエンティティが SAML IdP である RAM ロールを作成していることを確認してください。詳細については、「信頼できる IdP 用の RAM ロールの作成」または「 CreateRole 」を参照してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

SAMLProviderArn

string

任意

RAM に作成された SAML IdP の Amazon リソースネーム (ARN)。

フォーマット: acs:ram::<account_id>:saml-provider/<saml_provider_id>。

IdP の Amazon リソースネーム (ARN) は、Resource Access Management (RAM) コンソールまたは API 操作の呼び出しで確認できます。

acs:ram::123456789012****:saml-provider/company1

RoleArn

string

任意

偽装する RAM ロールの Amazon リソースネーム (ARN)。

このロールの信頼できるエンティティは SAML IdP です。詳細については、「信頼できる IdP 用の RAM ロールの作成」または「 CreateRole 」を参照してください。

フォーマット: acs:ram::<account_id>:role/<role_name>。

ロールの Amazon リソースネーム (ARN) は、Resource Access Management (RAM) コンソールまたは API 操作の呼び出しで確認できます。

acs:ram::123456789012****:role/adminrole

SAMLAssertion

string

任意

Base64 エンコードされた SAML アサーション。

アサーションの長さは 4 文字から 100,000 文字である必要があります。

説明

IdP から完全な SAML 応答を取得する必要があります。個別の SAML アサーションフィールドはサポートされていません。

base64_encoded_saml_assertion

Policy

string

任意

STS トークンの権限をさらに制限するために STS トークンにアタッチされる追加のアクセスポリシー。ルール:

  • このポリシーが指定されている場合、STS トークンの最終的な権限は、RAM ロールポリシーによって付与された権限とこのポリシーの交差になります。

  • このポリシーが指定されていない場合、STS トークンの最終的な権限は、RAM ロールによって付与された権限になります。

ポリシーの長さは 1 文字から 2,048 文字である必要があります。

url_encoded_policy

DurationSeconds

integer

任意

STS トークンの有効期間。単位: 秒。

最小値は 900 秒で、最大値は MaxSessionDuration の値です。デフォルト値は 3,600 秒です。

CreateRole または UpdateRole 操作を呼び出して、ロールの最大セッション期間 (MaxSessionDuration) を設定できます。詳細については、「 CreateRole 」または「 UpdateRole 」を参照してください。

3600

説明

AssumeRoleWithSAML 操作は認証に SAML アサーションを使用し、匿名アクセスをサポートしているため、Signature、SignatureMethod、SignatureVersion、AccessKeyId の共通リクエストパラメーターを指定する必要はありません。共通リクエストパラメーターの詳細については、「共通リクエストパラメーター」を参照してください。

レスポンスフィールド

フィールド

型

説明

例

object

応答要素。

RequestId

string

リクエスト ID。

6894B13B-6D71-4EF5-88FA-F32781734A7F

SAMLAssertionInfo

object

SAML アサーション内の一部の情報。

SubjectType

string

SAML アサーション内の NameID のフォーマット。プレフィックスが urn:oasis:names:tc:SAML:2.0:nameid-format: の場合、プレフィックスは削除されます。例: persistent/transient。

persistent

Subject

string

SAML アサーション内の Subject - NameID フィールドの値。

alice@example.com

Issuer

string

SAML アサーション内の Issuer フィールドの値。

http://example.com/adfs/services/trust

Recipient

string

SAML アサーションの Subject - SubjectConfirmation - SubjectConfirmationData フィールド内の Recipient 属性の値。

https://signin.alibabacloud.com/saml-role/SSO

AssumedRoleUser

object

ロールの引き受けのための一時的なエンティティ。

AssumedRoleId

string

一時的なエンティティの ID。

34458433936495****:alice

Arn

string

一時的なエンティティの Amazon リソースネーム (ARN)。

acs:sts::123456789012****:assumed-role/AdminRole/alice

Credentials

object

アクセス認証情報。

SecurityToken

string

セキュリティトークン。

説明

セキュリティトークンの長さは固定されていません。セキュリティトークンの長さの最大値を制限しないことを強く推奨します。

********

Expiration

string

STS トークンの有効期限の時間 (協定世界時 (UTC))。

2015-04-09T11:52:19Z

AccessKeySecret

string

AccessKey Secret。

wyLTSmsyPGP1ohvvw8xYgB29dlGI8KMiH2pK****

AccessKeyId

string

AccessKey ID。

STS.L4aBSCSJVMuKg5U1****

SourceIdentity

string

ソースエンティティ情報。

ロールを偽装する際、アクターのソースエンティティを会話の初期 ID 識別子として指定できます。ソースエンティティの値は、継続的なロールの引き受けのチェーン会話全体で保持され、途中で変更することはできません。これにより、操作のトレーサビリティとセキュリティが確保されます。

ソースエンティティが指定されていない場合、このフィールドは返されません。

Alice

例

成功レスポンス

JSONJSON

{
  "RequestId": "6894B13B-6D71-4EF5-88FA-F32781734A7F",
  "SAMLAssertionInfo": {
    "SubjectType": "persistent",
    "Subject": "alice@example.com",
    "Issuer": "http://example.com/adfs/services/trust",
    "Recipient": "https://signin.alibabacloud.com/saml-role/SSO"
  },
  "AssumedRoleUser": {
    "AssumedRoleId": "34458433936495****:alice",
    "Arn": "acs:sts::123456789012****:assumed-role/AdminRole/alice"
  },
  "Credentials": {
    "SecurityToken": "********",
    "Expiration": "2015-04-09T11:52:19Z",
    "AccessKeySecret": "wyLTSmsyPGP1ohvvw8xYgB29dlGI8KMiH2pK****",
    "AccessKeyId": "STS.L4aBSCSJVMuKg5U1****"
  },
  "SourceIdentity": "Alice"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

500 InternalError STS Server Internal Error happened, please send the RequestId to us. 内部エラーが発生しました。

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。