すべてのプロダクト
Search

このプロダクト

    Identity as a Service:SetApplicationSsoConfig

    ドキュメントセンター

    Identity as a Service:SetApplicationSsoConfig

    最終更新日:Jul 06, 2026

    EIAM アプリケーションのシングルサインオン (SSO) 構成プロパティを設定します。

    操作説明

    EIAM のアプリケーション管理では、複数のシングルサインオン (SSO) プロトコル (SAML 2.0 および OIDC) を使用するアプリケーションを追加できます。ただし、各アプリケーションは 1 つの SSO プロトコルのみをサポートしており、作成時に指定され、変更することはできません。アプリケーションがサポートする SSO プロトコルの種類に基づいて、対応する SSO 構成プロパティパラメーターを指定してください。

    今すぐお試しください

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

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    eiam:SetApplicationSsoConfig

    create

    *Application

    acs:eiam:{#regionId}:{#accountId}:instance/{#InstanceId}/application/{#ApplicationId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    InstanceId

    string

    必須

    インスタンスの ID。

    idaas_ue2jvisn35ea5lmthk267xxxxx
    ApplicationId

    string

    必須

    アプリケーションの ID。

    app_mkv7rgt4d7i4u7zqtzev2mxxxx
    SamlSsoConfig

    object

    任意

    SAML プロトコルベースのアプリケーションの SSO 構成パラメーター。

    SpSsoAcsUrl

    string

    任意

    アプリケーション (SP) の SAML アサーション消費者サービス (ACS) URL。

    https://signin.aliyun.com/saml-role/sso
    SpEntityId

    string

    任意

    アプリケーション (SP) の SAML EntityId。

    urn:alibaba:cloudcomputing
    NameIdFormat

    string

    任意

    SAML プロトコル標準で定義された NameID フォーマット。有効な値:

    • urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified: 未指定。アプリケーションが NameID の解析方法を決定します。

    • urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress: メールアドレスフォーマット。

    • urn:oasis:names:tc:SAML:2.0:nameid-format:persistent: 永続的な NameID。

    • urn:oasis:names:tc:SAML:2.0:nameid-format:transient: 一時的な NameID。

    列挙値:

    • urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified :

      未指定。デフォルト値。

    • urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress :

      メールアドレスフォーマット。

    • urn:oasis:names:tc:SAML:2.0:nameid-format:persistent :

      永続的。

    • urn:oasis:names:tc:SAML:2.0:nameid-format:transient :

      一時的。

    urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
    NameIdValueExpression

    string

    任意

    SAML プロトコルの実際の NameID 値を生成するために使用される式。

    user.email
    DefaultRelayState

    string

    任意

    デフォルトの RelayState 値。シングルサインオン (SSO) リクエストが EIAM によって開始される場合、EIAM が提供する SAML Response は RelayState としてこの値を指定します。

    https://home.console.alibabacloud.com
    SignatureAlgorithm

    string

    任意

    SAML アサーションの署名アルゴリズム。

    列挙値:

    • RSA-SHA256 :

      RSA-SHA256 アルゴリズム。

    RSA-SHA256
    ResponseSigned

    boolean

    任意

    レスポンスに署名する必要があるかどうかを指定します。ResponseSigned と AssertionSigned の両方を false に設定することはできません。

    • true: レスポンスに署名されます。

    • false: レスポンスに署名されません。

    true
    AssertionSigned

    boolean

    任意

    アサーションに署名する必要があるかどうかを指定します。ResponseSigned と AssertionSigned の両方を false に設定することはできません。

    • true: アサーションに署名されます。

    • false: アサーションに署名されません。

    true
    AttributeStatements

    array<object>

    任意

    SAML アサーションに含まれる追加のユーザー属性構成。

    object

    任意

    AttributeName

    string

    任意

    SAML アサーション内の属性の名前。

    https://www.aliyun.com/SAML-Role/Attributes/RoleSessionName
    AttributeValueExpression

    string

    任意

    SAML アサーション内の属性の値の式。

    user.username
    IdPEntityId

    string

    任意

    SAML プロトコルで IdP ID を表すエンティティ ID。URL フォーマットと URN フォーマットがサポートされています。

    https://example.com/
    OptionalRelayStates

    array<object>

    任意

    オプションの RelayState 構成。

    object

    任意

    オプションの RelayState 構成。

    RelayState

    string

    任意

    RelayState の値。

    https://ram.console.alibabacloud.com/
    DisplayName

    string

    任意

    RelayState の表示名。

    Ram
    OidcSsoConfig

    object

    任意

    OIDC プロトコルベースのアプリケーションの SSO 構成パラメーター。

    RedirectUris

    array

    任意

    アプリケーションがサポートする RedirectUris のリスト。

    string

    任意

    アプリケーションがサポートする RedirectUri。

    https://example.com/oidc/login/callback
    PostLogoutRedirectUris

    array

    任意

    アプリケーションがサポートするログアウトコールバックアドレスのリスト。

    string

    任意

    アプリケーションのホワイトリストに登録されたログアウトコールバックアドレス。アプリケーションが Logout リクエストを開始する際に post_logout_redirect_uri パラメーターを指定できます。

    https://example.com/oidc/logout/callback
    GrantTypes

    array

    任意

    サポートされている OIDC プロトコルの権限付与タイプのリスト。

    authorization_code

    string

    任意

    サポートされている OIDC プロトコルの権限付与タイプ。有効な値:

    • authorization_code: 認証コードモード。

    • implicit: インプリシットモード。

    • refresh_token: トークンリフレッシュモード。

    • urn:ietf:params:oauth:grant-type:device_code: デバイスモード。

    • password: パスワードモード。

    authorization_code
    ResponseTypes

    array

    任意

    OidcSsoConfig.GrantTypes に implicit モードが含まれる場合にアプリケーションがサポートする応答タイプ。

    token id_token

    string

    任意

    OIDC 標準パラメーター ResponseType。このパラメーターは、GrantTypes に implicit モードが含まれる場合にのみ効果が有効です。有効な値:

    • token: アクセストークンのみを返します。

    • id_token: ID トークンのみを返します。

    • token id_token: アクセストークンと ID トークンの両方を返します。

    token id_token
    GrantScopes

    array

    任意

    OIDC 標準パラメーター scope で、userinfo エンドポイントまたは ID トークンが返すことができるユーザー属性の範囲を指定します。

    profile，email

    string

    任意

    OIDC 標準パラメーター scope。userinfo エンドポイントまたは ID トークンによって返されるユーザー属性の範囲を指定します。有効な値:

    • openid: OIDC 標準パラメーター。一意のユーザー ID。

    • profile: ユーザーのプロファイル情報。

    • email: ユーザーのメール情報。

    • phone: ユーザーの電話情報。

    openid
    PasswordTotpMfaRequired

    boolean

    任意

    パスワードモードで TOTP ベースの二次認証が必須かどうかを指定します。このパラメーターは、OIDC アプリケーションの GrantTypes にパスワードモードが含まれる場合にのみ効果が有効です。

    true
    PasswordAuthenticationSourceId

    string

    任意

    パスワードモードで使用される身分認証ソースの ID。このパラメーターは、OIDC アプリケーションの GrantTypes にパスワードモードが含まれる場合にのみ効果が有効です。

    ia_password
    PkceRequired

    boolean

    任意

    アプリケーション SSO に PKCE (RFC 7636) が必要かどうかを指定します。

    true
    PkceChallengeMethods

    array

    任意

    PKCE で Code Challenge を計算するために使用されるアルゴリズム。

    S256

    string

    任意

    PKCE で Code Challenge を計算するために使用されるアルゴリズム。有効な値:

    • plain: プレーンテキスト。

    • S256: SHA-256 アルゴリズム。

    S256
    AccessTokenEffectiveTime

    integer

    任意

    発行されたアクセストークンの有効期間。単位: 秒。デフォルト値: 1200 (20 分)。

    1200
    CodeEffectiveTime

    integer

    任意

    発行されたコードの有効期間。単位: 秒。デフォルト値: 60 (1 分)。

    60
    IdTokenEffectiveTime

    integer

    任意

    発行された ID トークンの有効期間。単位: 秒。デフォルト値: 300 (5 分)。

    300
    RefreshTokenEffective

    integer

    任意

    発行されたリフレッシュトークンの有効期間。単位: 秒。デフォルト値: 86400 (1 日)。

    86400
    CustomClaims

    array<object>

    任意

    ID トークンの応答に含まれるカスタムユーザー情報。

    object

    任意

    ClaimName

    string

    任意

    返されるクレームの名前。

    "Role"
    ClaimValueExpression

    string

    任意

    返されるクレームの値の式。

    user.dict.applicationRole
    SubjectIdExpression

    string

    任意

    ID トークンで返される sub 値のカスタム式。

    user.userid
    AllowedPublicClient

    boolean

    任意

    アプリケーションがパブリッククライアントとして IDaaS EIAM 権限付与サーバーにリクエストを送信することを許可するかどうかを指定します。この特徴は、認証コードモードとデバイスモードでのみサポートされています。デフォルト値: false。

    true
    InitLoginType

    string

    任意

    初期化シングルサインオン (SSO) のメソッド。有効な値:

    • only_app_init_sso: アプリケーション開始の SSO のみ。これは OIDC プロトコルアプリケーションのデフォルト値です。SAML アプリケーションでこのメソッドを指定する場合、InitLoginUrl を指定する必要があります。

    • idaas_or_app_init_sso: IDaaS ポータルまたはアプリケーションから開始される SSO。これは SAML プロトコルアプリケーションのデフォルト値です。OIDC プロトコルアプリケーションでこのメソッドを指定する場合、InitLoginUrl を指定する必要があります。

    only_app_init_sso
    InitLoginUrl

    string

    任意

    初期化シングルサインオン (SSO) をトリガーする URL。 OIDC プロトコルアプリケーションで InitLoginType を idaas_or_app_init_sso に設定する場合、このパラメーターは必須です。 SAML プロトコルアプリケーションで InitLoginType を only_app_init_sso に設定する場合、このパラメーターは必須です。

    http://127.0.0.1:8000/start_login?enterprise_code=ABCDEF
    ClientToken

    string

    任意

    リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを使用でき、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」を参照してください。

    client-examplexxx

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエストの ID。

    0441BD79-92F3-53AA-8657-F8CE4A2B912A

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A"
}

    エラーコード

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

    変更履歴

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