AssumeRoleWithSAML 操作を呼び出して、SAML ロールベースのシングルサインオン (SSO) 中に RAM ロールを偽装するための一時的な認証情報 (STS トークン) を取得します。
操作説明
開始する前に
外部 ID プロバイダー (IdP) から SAML 応答を取得していることを確認してください。
RAM に SAML IdP を作成していることを確認してください。詳細については、「SAML IdP の作成」または「 CreateSAMLProvider 」を参照してください。
RAM に、信頼できるエンティティが SAML IdP である RAM ロールを作成していることを確認してください。詳細については、「信頼できる IdP 用の RAM ロールの作成」または「 CreateRole 」を参照してください。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| SAMLProviderArn |
string |
任意 |
RAM に作成された SAML IdP の Amazon リソースネーム (ARN)。 フォーマット: IdP の Amazon リソースネーム (ARN) は、Resource Access Management (RAM) コンソールまたは API 操作の呼び出しで確認できます。
|
acs:ram::123456789012****:saml-provider/company1 |
| RoleArn |
string |
任意 |
偽装する RAM ロールの Amazon リソースネーム (ARN)。 このロールの信頼できるエンティティは SAML IdP です。詳細については、「信頼できる IdP 用の RAM ロールの作成」または「 CreateRole 」を参照してください。 フォーマット: ロールの 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 トークンにアタッチされる追加のアクセスポリシー。ルール:
ポリシーの長さは 1 文字から 2,048 文字である必要があります。 |
url_encoded_policy |
| DurationSeconds |
integer |
任意 |
STS トークンの有効期間。単位: 秒。 最小値は 900 秒で、最大値は CreateRole または UpdateRole 操作を呼び出して、ロールの最大セッション期間 ( |
3600 |
AssumeRoleWithSAML 操作は認証に SAML アサーションを使用し、匿名アクセスをサポートしているため、Signature、SignatureMethod、SignatureVersion、AccessKeyId の共通リクエストパラメーターを指定する必要はありません。共通リクエストパラメーターの詳細については、「共通リクエストパラメーター」を参照してください。
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答要素。 |
||
| RequestId |
string |
リクエスト ID。 |
6894B13B-6D71-4EF5-88FA-F32781734A7F |
| SAMLAssertionInfo |
object |
SAML アサーション内の一部の情報。 |
|
| SubjectType |
string |
SAML アサーション内の |
persistent |
| Subject |
string |
SAML アサーション内の |
alice@example.com |
| Issuer |
string |
SAML アサーション内の |
http://example.com/adfs/services/trust |
| Recipient |
string |
SAML アサーションの |
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. | 内部エラーが発生しました。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。