SAML

iPLAssはSAML2.0のWeb Browser SSO Profileをサポートします。 SAMLとは異なるドメイン間でのユーザ認証を行うための、XMLベースの標準規格です。 認証情報を利用するService Provider(SP)は認証情報を提供するIdentify Provider(IdP)を利用することで、シングルサインオンを実現できます。 iPLAssでは設定によりアプリケーションをSPまたはIdPとして動作させることが可能です。

SAMLを有効化するためには、SamlServiceでSAMLサービス全体に対する設定を行ったうえで、adminConsole等にてテナント単位のSAMLメタデータ定義を行います。テナント単位にIdp、SPを設定可能です。

SAML認証に関する共通の設定をSamlServiceに設定します。 SAMLメッセージに署名するための秘密鍵及び証明書ストアに関する設定などを行います。 詳細は SamlService を参照してください。

SAMLのメタデータ定義にて次の項目を設定します。

設定項目必須設定値

Enable Single Logout

シングルログアウトを有効にする場合チェック

Enable Unsolicited Response

非要求応答(他サービス契機のシングルログアウトによるログアウト要求)を有効にする場合チェック

My SAML Entity id

自身を表す固有の識別子。未指定の場合は、SAMLメタデータURLをEntity idとして設定

Base URL

テナントコンテキストまでのURL。未指定の場合は自動解決。Apache等にてサーバ名、パスの変換を行っている場合に指定

Signature Algorithm

署名アルゴリズム、未指定の場合のデフォルトは「SHA256withRSA」

iPLAssをServiceProviderとして動作させる際には次の項目を設定します。

設定項目必須設定値

Act as ServiceProvider

ServiceProviderとして動作させる場合チェック

NameID Format

NameID Formatの設定

urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress urn:oasis:names:tc:SAML:2.0:nameid-format:persistent

などSAML仕様で定義されるNameID Format。 未指定の場合のデフォルト値は

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

NameID mapping User proprety

○

NameIDに対応するUserエンティティのプロパティ名を指定

User mapping by attribute

NameIdではなく、属性値を用いてUserエンティティのマッピングする場合チェック

User mapping attributeName

(User mapping by attributeがtrueの場合)SAMLメッセージ上でのAttributeのNameを指定

User mapping propertyName

(User mapping by attributeがtrueの場合)Userエンティティのプロパティ名を指定

AutoUserProvisioningHandler

org.iplass.mtp.auth.saml.AutoUserProvisioningHandlerを実装したクラスを設定。 IdPからフェデレーションされた認証情報に基づき、自動プロビジョニング(新規ユーザの登録、ユーザ属性の更新)を行う場合に指定

RemoteIdProvider Setting

設定項目必須設定値

SAML EntityId

○

IdProvider固有の識別子

SSO Setting

SLO Setting

RedirectUrl(after logout)

ログアウト後にリダイレクトするURL

Certificate Setting

○

IdPの証明書

設定項目必須設定値

Endpoint URL

○

AssertionConsumerServiceのエンドポイントURL(Location)

Request Binding

○

リクエストの送信方式(Binding)

HTTP_REDIRECT

urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect

HTTP_POST

urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST

Request With Sign

署名付のSSOリクエストを送信する場合チェック。 自身の証明書の登録が必要。 SamlService の設定を参照。

設定項目必須設定値

Endpoint URL

SingleLogoutServiceのエンドポイントURL(Location)

Request Binding

SSO SettingのRequest Binding参照

Response Endpoint URL

ResponseLocationログアウトのレスポンスエンドポイントURL(ResponseLocation)

Response Binding

SSO SettingのRequest Binding参照

iPLAssをIdProviderとして動作させる際には次の項目を設定します。

設定項目必須設定値

Act as IdProvider

IdProviderとして動作させる場合チェック

NameID Format Setting

サポートするNameIDのFormatを指定。複数可。

RemoteServiceProvider Setting

設定項目必須設定値

SAML Entity Id

○

ServiceProvider固有の識別子

ACS Endpoint Url

○

ACS(アサーション コンシューマ サービス)のログインURL

ACS Response Binding

○

SSO SettingのRequest Binding参照

Validate SSO Request with sign

シングルサインオンリクエスト時に署名検証を行う場合チェック

NameID Format

ServiceProvider SettingのNameID Format参照

NameID mapped User property

○

NameIDに対応するUserエンティティのプロパティ名を指定

SLO Setting

Enable Impersonation

代理ログイン状態でシングルサインオンを許可するか否か

SAML attribute mapping setting

Certificate Setting

SPの証明書

設定項目必須設定値

Endpoint URL

SPのSingleLogoutServiceのエンドポイントURL(Location)

Request Binding

SSO SettingのRequest Binding参照

Response Endpoint URL

SPのResponseLocationログアウトのレスポンスエンドポイントURL(ResponseLocation)

Response Binding

SSO SettingのRequest Binding参照

Validate SLO Request with sign

シングルログアウトリクエスト時に署名検証を行う場合チェック

設定項目必須設定値

AttributeName

SAMLメッセージ上でのAttributeのName

User propertyName

Userのプロパティ名、CustomValue Scriptとどちらかを指定する

CustomValue Script

マッピング対象の項目をGroovyScriptで指定、"user"変数にUserエンティティがバインドされている

認証ポリシー単位にSAMLベースの認証を有効化することが可能です。 adminConsoleの認証ポリシー設定画面にて利用するSAML定義を指定します。

外部のIdPまたSPにiPLAssを登録するためのSAMLメタデータは、以下のURLを表示することにより取得可能です。

http(s)://[server]/[appContext]/[tenantName]/saml/md/[SAML definitionName]

定義名を"DEFAULT"として定義したSAML定義の場合、SAML definitionNameは未指定で取得できます。

ファイルとしてダウンロードし、IdPに手動で登録するか、もしくは上記URLをメタデータURLとして登録してください。 なお、メタデータURLを登録する場合は外部のIdP、SPのサイトからiPLAssが稼働するサーバへURLにて参照可能である必要があります。

SAML2.0のSP Initiated SSOを起動するURLは以下です。

http(s)://[server]/[appContext]/[tenantName]/saml/ssoar/[SAML definitionName]

定義名を"DEFAULT"として定義したSAML定義の場合、SAML definitionNameは未指定で取得できます。

当該URLを呼び出すことにより、SSO処理が開始されます。

SAML2.0のIdP Initiated SSOを起動するURLは以下です。

http(s)://[server]/[appContext]/[tenantName]/saml/sso/idpi/[SAML definitionName]?entityId=[外部SPのEntityID]

定義名を"DEFAULT"として定義したSAML定義の場合、SAML definitionNameは未指定で取得できます。

当該URLを呼び出すことにより、SSO処理が開始されます。