SAML認証
SAML認証連携の流れ
WebPerformer-NXのアプリケーションでSAML認証の連携を行うための手順は以下の通りです。
- ユーザマネージャの画面上部の
SP情報アイコンをクリックする。 SAMLを選択します。- シングルサインオン URLとオーディエンス URIを確認し、外部IdPへ設定します。
| Oktaへ設定 | Entra IDへ設定 | ID Entranceへ設定 | |
|---|---|---|---|
| シングルサインオン URL | 英語:Single Sign on URL 日本語:シングルサインオン URL | 英語:Reply URL (Assertion Consumer URL) 日本語:応答 URL | 英語:Sign-on URL 日本語:サインオンURL |
| オーディエンス URI | 英語:Audience URI 日本語:オーディエンス URI | 英語:Identifier (Entity ID) 日本語:識別子 | 英語:Entity ID 日本語:エンティティID |
-
外部IdPからSAMLメタデータドキュメントを取得します。
• Entra IDの場合- 作成しているアプリケーションのシングルサインオンページを開く
- SAML証明書の「フェデレーションメタデータXML」のダウンロードリンクをクリックする
- ダウンロードしたXMLファイルを保存する
• Oktaの場合
- 作成しているアプリケーションのSignOnタブを開く
- SAML Signing CertificatesのActionsをクリックする
- View IdP metadataをクリックする
- 別画面でxmlファイルが開くので、ブラウザ上で右クリックをし、
[名前を付けて保存]で保存する
• ID Entranceの場合
- 管理ポータルの連携サービス管理からID Entrance情報ページを開きます
- SAMLのメタデータURLの下にある「ダウンロード」をクリックします
- ダウンロードしたXMLファイルを保存します
-
ユーザマネージャの画面上部の作成アイコンをクリックし、アイデンティティプロバイダーの登録をします。
-
アプリケーション一覧からアプリを選択し、認証UIのサインイン画面(Sign In ID)に、外部認証用のボタンとして、コンポーネント一覧からプッシュボタンを配置します。
-
手順6.で配置した外部認証用のボタンのプロパティ画面を開き、下記を設定します。
- クリックイベントから「IdP」を選択
- IdP項目に手順5.で登録したアイデンティティプロバイダーの名称を入力
-
認証UIのサインイン画面(Sign In ID)を保存します。
アイデンティティプロバイダーの登録
- 画面右上の
作成アイコンをクリックします。 SAMLを選択します。- アイデンティティプロバイダー情報を入力します。
| 項目 | 入力 | 説明 | |||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| アイデンティティプロバイダー名 | 必須 | 任意の名称は半角スペース、アンダーバー、カンマ以外を使用してください。 最大文字数は、32文字です。 | |||||||||||||||||||||||||||||||||||||||
| メタデータ | 必須 | 外部IdPから取得したメタデータドキュメントをアップロードしてください。 | |||||||||||||||||||||||||||||||||||||||
| 属性マッピング | 必須 | ユーザ属性とIDP属性のマッピングを設定してください。
ユーザ属性 [email]にマッピングするIDP属性には、必ずEメールの情報が登録されている属性をマッピングしてください。 | |||||||||||||||||||||||||||||||||||||||
| サインアウトフロー | 必須 | ONかOFFを設定してください。ONの場合にはサインアウトフローの設定が外部IdPで必要となります。 |
[追加]ボタンをクリックします。- 追加したアイデンティティプロバイダーはIdPリストに表示されます。
サインアウトフローの設定
SAML認証ではサインアウトフローを設定することが可能です。
• Entra IDの場合
- 作成しているアプリケーションのシングルサインオンページを開きます。
- 基本的なSAML構成のログアウトURLに
ログアウトURLを設定してください。
• Oktaの場合
- 作成しているアプリケーションのSignOnタブを開きます
- IdPリストのIdP名の右にある
縦三点リーダーよりダウンロードした署名証明書をアップロードします。 シングルログアウトを有効化項目をチェックします。- ログアウト後にシングルログアウトURLに
ログアウトURLを設定してください。 - SP発行者に
オーディエンスURIを設定してください。 - SAML Signing Certificates の Actionsをクリックします。
- View IdP metadata をクリックします。
- 別画面でxmlファイルが開くので、ブラウザ上で右クリックをし、[名前をつけて保存]で保存します。
- メタデータを再度アップロードしてください。