すべてのプロダクト
Search

このプロダクト

    Identity as a Service:GetApplicationSsoConfig

    ドキュメントセンター

    Identity as a Service:GetApplicationSsoConfig

    最終更新日:Sep 09, 2026

    EIAM アプリケーションのシングルサインオン (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:GetApplicationSsoConfig

    get

    *アプリケーション。

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    InstanceId

    string

    必須

    インスタンスの ID。

    idaas_ue2jvisn35ea5lmthk267xxxxx
    ApplicationId

    string

    必須

    アプリケーションの ID。

    app_mkv7rgt4d7i4u7zqtzev2mxxxx

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    ApplicationSsoConfig

    object

    アプリケーションの SSO 構成情報。

    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_コード=ABCDEF
    OidcSsoConfig

    object

    OIDC プロトコルアプリケーションの SSO 構成パラメーター。このパラメーターは、アプリケーションの SSO プロトコルが OIDC の場合にのみ返されます。

    AccessTokenEffectiveTime

    integer

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

    1200
    AllowedPublicClient

    string

    アプリケーションがパブリッククライアントとして IDaaS EIAM 権限付与サーバーにリクエストすることを許可するかどうかを指定します。このパラメーターは、認証コードモードおよびデバイスモードでのみ有効にできます。デフォルト値: false。

    true
    CodeEffectiveTime

    integer

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

    60
    CustomClaims

    array<object>

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

    object

    ClaimName

    string

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

    userOuIds
    ClaimValueExpression

    string

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

    ObjectToJsonString(user.organizationalUnits)
    GrantScopes

    array

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

    プロファイル, email

    string

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

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

    • profile: プロファイル。詳細なユーザー情報。

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

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

    openid
    GrantTypes

    array

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

    権限付与_コード

    string

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

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

    • implicit: 暗黙モード。

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

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

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

    リフレッシュ_トークン
    IdTokenEffectiveTime

    integer

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

    1200
    PasswordAuthenticationSourceId

    string

    パスワードモードで使用される身分認証ソースの ID。このパラメーターは、OIDC プロトコルアプリケーションに指定された GrantTypes にパスワードモードが含まれている場合にのみ効果があります。

    ia_password
    PasswordTotpMfaRequired

    boolean

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

    true
    PkceChallengeMethods

    array

    PKCE でコードチャレンジを計算するために使用されるアルゴリズム。

    S256

    string

    PKCE でコードチャレンジを計算するために使用されるアルゴリズム。有効な値:

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

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

    S256
    PkceRequired

    boolean

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

    true
    PostLogoutRedirectUris

    array

    アプリケーションでサポートされているログアウトコールバックアドレスのリスト。

    string

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

    https://example.com/oidc/login/logout
    RedirectUris

    array

    アプリケーションでサポートされているリダイレクト URI のリスト。

    string

    アプリケーションでサポートされているリダイレクト URI。

    https://example.com/oidc/login/コールバック
    RefreshTokenEffective

    integer

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

    86400
    ResponseTypes

    array

    OidcSsoConfig.GrantTypes に暗黙モードが含まれている場合にアプリケーションでサポートされる応答タイプ。

    トークン id_トークン

    string

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

    • token: アクセストークンのみが返されます。

    • id_token: ID トークンのみが返されます。

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

    トークン id_トークン
    SubjectIdExpression

    string

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

    user.userid
    ProtocolEndpointDomain

    object

    アプリケーションによって提供されるメタデータエンドポイント構成。

    Oauth2AuthorizationEndpoint

    string

    OAuth 2.0 権限付与エンドポイント。このパラメーターは、アプリケーションの SSO プロトコルが OIDC の場合にのみ返されます。

    https://l1seshcn.aliyunidaas.com/login/app/app_mltta64q65enci54slingvvsgq/oauth2/authorize
    Oauth2DeviceAuthorizationEndpoint

    string

    OAuth 2.0 デバイス権限付与エンドポイント。このパラメーターは、アプリケーションの SSO プロトコルが OIDC の場合にのみ返されます。

    https://eiam-api-cn-hangzhou.aliyuncs.com/v2/idaas_ue2jvisn35ea5lmthk2676rypm/app_mltta64q65enci54slingvvsgq/oauth2/デバイス/コード
    Oauth2RevokeEndpoint

    string

    OAuth 2.0 トークン失効エンドポイント。このパラメーターは、アプリケーションの SSO プロトコルが OIDC の場合にのみ返されます。

    https://eiam-api-cn-hangzhou.aliyuncs.com/v2/idaas_ue2jvisn35ea5lmthk2676rypm/app_mltta64q65enci54slingvvsgq/oauth2/revoke
    Oauth2TokenEndpoint

    string

    OAuth 2.0 トークンエンドポイント。このパラメーターは、アプリケーションの SSO プロトコルが OIDC の場合にのみ返されます。

    https://eiam-api-cn-hangzhou.aliyuncs.com/v2/idaas_ue2jvisn35ea5lmthk2676rypm/app_mltta64q65enci54slingvvsgq/oauth2/トークン
    Oauth2UserinfoEndpoint

    string

    OIDC ユーザー情報エンドポイント。このパラメーターは、アプリケーションの SSO プロトコルが OIDC の場合にのみ返されます。

    https://eiam-api-cn-hangzhou.aliyuncs.com/v2/idaas_ue2jvisn35ea5lmthk2676rypm/app_mltta64q65enci54slingvvsgq/oauth2/userinfo
    OidcIssuer

    string

    OIDC 発行者情報。このパラメーターは、アプリケーションの SSO プロトコルが OIDC の場合にのみ返されます。

    https://eiam-api-cn-hangzhou.aliyuncs.com/v2/idaas_ue2jvisn35ea5lmthk2676rypm/app_mltta64q65enci54slingvvsgq/oidc
    OidcJwksEndpoint

    string

    OIDC JWKS エンドポイント。このパラメーターは、アプリケーションの SSO プロトコルが OIDC の場合にのみ返されます。

    https://eiam-api-cn-hangzhou.aliyuncs.com/v2/idaas_ue2jvisn35ea5lmthk2676rypm/app_mltta64q65enci54slingvvsgq/oidc/jwks
    OidcLogoutEndpoint

    string

    OIDC RP 開始ログアウトエンドポイント。このパラメーターは、アプリケーションの SSO プロトコルが OIDC の場合にのみ返されます。

    https://l1seshcn.aliyunidaas.com/login/app/app_mltta64q65enci54slingvvsgq/oauth2/logout
    SamlMetaEndpoint

    string

    SAML プロトコルのメタデータエンドポイント URL。このパラメーターは、アプリケーションの SSO プロトコルが SAML 2.0 の場合にのみ返されます。

    https://l1seshcn.aliyunidaas.com/api/v2/app_mltuxdwd4lq4eer6tmtlmaxm5e/saml2/meta
    SamlSloEndpoint

    string

    IdP 側の SAML シングルサインアウト URL (SLO URL)。SP はユーザーをこの URL にリダイレクトして、シングルサインアウトを開始します。

    https://example.com/saml/slo
    SamlSsoEndpoint

    string

    SAML プロトコルの AuthnRequest 受信エンドポイント。このパラメーターは、アプリケーションの SSO プロトコルが SAML 2.0 の場合にのみ返されます。

    https://l1seshcn.aliyunidaas.com/login/app/app_mltuxdwd4lq4eer6tmtlmaxm5e/saml2/sso
    SamlSsoConfig

    object

    SAML プロトコルアプリケーションの SSO 構成パラメーター。このパラメーターは、アプリケーションの SSO プロトコルが SAML 2.0 の場合にのみ返されます。

    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
    DefaultRelayState

    string

    デフォルトの RelayState 値。EIAM によってシングルサインオン (SSO) リクエストが開始された場合、EIAM が提供する SAML 応答では RelayState としてこの値が指定されます。これは、ユーザーのログインリクエストが EIAM によって開始された場合に適用されます。

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

    string

    SAML プロトコルにおいて IdP ID を表すエンティティ ID。

    https://example.com/
    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
    NameIdValueExpression

    string

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

    user.username
    OptionalRelayStates

    array<object>

    オプションの RelayState 値。アプリケーションポータルでは、アプリケーションカードに複数のオプションのリダイレクトアドレスが表示名とともに表示されます。ユーザーがアドレスをクリックして SSO を完了すると、対応するアドレスに自動的にリダイレクトされます。オプションのリダイレクトアドレスは、デフォルトのリダイレクトアドレスを指定した後にのみ指定できます。

    object

    DisplayName

    string

    RelayState の表示名。

    Ram Account SSO
    RelayState

    string

    オプションの RelayState 値。アプリケーションポータルでは、アプリケーションカードに複数のオプションのリダイレクトアドレスが表示名とともに表示されます。ユーザーがアドレスをクリックして SSO を完了すると、対応するアドレスに自動的にリダイレクトされます。

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

    boolean

    SSO AuthnRequest の署名検証が有効かどうかを示します。

    true
    ResponseSigned

    boolean

    応答に署名する必要があるかどうかを示します。ResponseSigned と AssertionSigned の両方を false に設定することはできません。有効な値:

    • true: 署名が必須です。

    • false: 署名は必須ではありません。

    true
    SignatureAlgorithm

    string

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

    RSA-SHA256
    SpEntityId

    string

    アプリケーション (SP) の SAML エンティティ ID。

    urn:alibaba:cloudcomputing
    SpSigningCertificates

    array

    PEM フォーマットで構成された SP 署名検証証明書。コンソールまたは API 呼び出し元が読み取りおよび表示できるように、最大 2 つの証明書が返されます。

    -----BEGIN CERTIFICATE----- MIIC0jCCAbqgAwIBAgIQXXXXX -----END CERTIFICATE-----

    string

    PEM フォーマットで構成された SP 署名検証証明書。

    -----BEGIN CERTIFICATE----- MIIC0jCCAbqgAwIBAgIQXXXXX -----END CERTIFICATE-----
    SpSloResponseUrl

    string

    構成された SP SLO 応答 URL。

    https://example.com/api/slo/response
    SpSsoAcsUrl

    string

    アプリケーション (SP) の SAML アサーションコンシューマーサービス (ACS) URL。

    https://signin.alibabacloud.com/saml-role/sso
    SsoStatus

    string

    アプリケーションの SSO ステータス。有効な値:

    • enabled: 有効。

    • disabled: 無効。

    enabled
    RequestId

    string

    リクエスト ID。

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

    例

    成功レスポンス

    JSONJSON

    {
  "ApplicationSsoConfig": {
    "InitLoginType": "only_app_init_sso",
    "InitLoginUrl": "http://127.0.0.1:8000/start_login?enterprise_code=ABCDEF",
    "OidcSsoConfig": {
      "AccessTokenEffectiveTime": 1200,
      "AllowedPublicClient": "true",
      "CodeEffectiveTime": 60,
      "CustomClaims": [
        {
          "ClaimName": "userOuIds",
          "ClaimValueExpression": "ObjectToJsonString(user.organizationalUnits)"
        }
      ],
      "GrantScopes": [
        "openid"
      ],
      "GrantTypes": [
        "refresh_token"
      ],
      "IdTokenEffectiveTime": 1200,
      "PasswordAuthenticationSourceId": "ia_password",
      "PasswordTotpMfaRequired": true,
      "PkceChallengeMethods": [
        "S256"
      ],
      "PkceRequired": true,
      "PostLogoutRedirectUris": [
        "https://example.com/oidc/login/logout\n"
      ],
      "RedirectUris": [
        "https://example.com/oidc/login/callback\n"
      ],
      "RefreshTokenEffective": 86400,
      "ResponseTypes": [
        "token id_token"
      ],
      "SubjectIdExpression": "user.userid"
    },
    "ProtocolEndpointDomain": {
      "Oauth2AuthorizationEndpoint": "https://l1seshcn.aliyunidaas.com/login/app/app_mltta64q65enci54slingvvsgq/oauth2/authorize",
      "Oauth2DeviceAuthorizationEndpoint": "https://eiam-api-cn-hangzhou.aliyuncs.com/v2/idaas_ue2jvisn35ea5lmthk2676rypm/app_mltta64q65enci54slingvvsgq/oauth2/device/code",
      "Oauth2RevokeEndpoint": "https://eiam-api-cn-hangzhou.aliyuncs.com/v2/idaas_ue2jvisn35ea5lmthk2676rypm/app_mltta64q65enci54slingvvsgq/oauth2/revoke",
      "Oauth2TokenEndpoint": "https://eiam-api-cn-hangzhou.aliyuncs.com/v2/idaas_ue2jvisn35ea5lmthk2676rypm/app_mltta64q65enci54slingvvsgq/oauth2/token",
      "Oauth2UserinfoEndpoint": "https://eiam-api-cn-hangzhou.aliyuncs.com/v2/idaas_ue2jvisn35ea5lmthk2676rypm/app_mltta64q65enci54slingvvsgq/oauth2/userinfo",
      "OidcIssuer": "https://eiam-api-cn-hangzhou.aliyuncs.com/v2/idaas_ue2jvisn35ea5lmthk2676rypm/app_mltta64q65enci54slingvvsgq/oidc",
      "OidcJwksEndpoint": "https://eiam-api-cn-hangzhou.aliyuncs.com/v2/idaas_ue2jvisn35ea5lmthk2676rypm/app_mltta64q65enci54slingvvsgq/oidc/jwks",
      "OidcLogoutEndpoint": "https://l1seshcn.aliyunidaas.com/login/app/app_mltta64q65enci54slingvvsgq/oauth2/logout",
      "SamlMetaEndpoint": "https://l1seshcn.aliyunidaas.com/api/v2/app_mltuxdwd4lq4eer6tmtlmaxm5e/saml2/meta",
      "SamlSloEndpoint": "https://example.com/saml/slo",
      "SamlSsoEndpoint": "https://l1seshcn.aliyunidaas.com/login/app/app_mltuxdwd4lq4eer6tmtlmaxm5e/saml2/sso"
    },
    "SamlSsoConfig": {
      "AssertionSigned": true,
      "AttributeStatements": [
        {
          "AttributeName": "https://www.aliyun.com/SAML-Role/Attributes/RoleSessionName",
          "AttributeValueExpression": "user.username"
        }
      ],
      "DefaultRelayState": "https://home.console.alibabacloud.com",
      "IdPEntityId": "https://example.com/",
      "NameIdFormat": "urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified",
      "NameIdValueExpression": "user.username",
      "OptionalRelayStates": [
        {
          "DisplayName": "Ram Account SSO",
          "RelayState": "https://home.console.alibabacloud.com"
        }
      ],
      "RequireAuthnRequestSigned": true,
      "ResponseSigned": true,
      "SignatureAlgorithm": "RSA-SHA256",
      "SpEntityId": "urn:alibaba:cloudcomputing",
      "SpSigningCertificates": [
        "-----BEGIN CERTIFICATE----- MIIC0jCCAbqgAwIBAgIQXXXXX -----END CERTIFICATE-----"
      ],
      "SpSloResponseUrl": "https://example.com/api/slo/response",
      "SpSsoAcsUrl": "https://signin.alibabacloud.com/saml-role/sso"
    },
    "SsoStatus": "enabled"
  },
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A"
}

    エラーコード

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

    変更履歴

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