Azure AD (Entra ID) を IDP として使用して ASP.NET Framework SAML SSO を構成するためのガイド

前提条件: ダウンロードとインストール

• インストールするには miniOrange SAML SSO NuGet パッケージ .NET アプリケーションでは、アプリケーションの上に miniOrange NuGet パッケージをインストールするだけです。

• インストール後、ブラウザを開き、以下の URL でモジュール ダッシュボードを参照します。

 http(s)<your-dotnet-application-base-url>?ssoaction=config


• 登録ページまたはログイン ページがポップアップ表示されたら、アプリケーションに miniOrange SAML SSO モジュールが正常に追加されています。

• をクリックしてアカウントに登録またはログインします。 会員登録する ボタンを押してモジュールを設定します。

• 登録が完了すると、登録したメールアドレスに試用ライセンス キーが送信されます。

• モジュールをアクティブ化するには、次のいずれかを実行します。
• 入力する ライセンスキー 指定された入力フィールドに電子メールで受信されます。

OR

• ダウンロードしたライセンスファイルをアップロードするには、 詳細

• 次に、「上記の条件を読み、モジュールを有効化します」のボックスにチェックを入れ、 ライセンス認証

モジュールで SAML ID プロバイダーのメタデータを構成するには、以下に説明する 2 つの方法があります。

A] [IDP メタデータのアップロード] ボタンを使用してメタデータをアップロードします。

• ID プロバイダーからメタデータ URL またはメタデータ ファイル (.xml 形式のみ) が提供されている場合は、 IDPメタデータのアップロード オプションを選択します。

• メタデータ URL をコピーするか、メタデータ ファイルをダウンロードして、ID プロバイダー側​​で同じものを構成します。

• 以下のスクリーンショットを参照してください。

• 使用可能なメタデータ形式に応じて、オプションのいずれかを選択できます。

B] ID プロバイダーのメタデータを手動で構成します。

• を構成した後 ID プロバイダー、それはあなたに提供します IDPエンティティID、IDPシングルサインオンURL および SAML X509証明書 それぞれフィールド。

• 詳しくはこちら Save IDP の詳細を保存します。

3. SAML SSO のテスト

• メタデータの詳細をアップロードした後、 ID プロバイダーの設定 セクション。 アクションの選択 ドロップダウンをクリックして テスト構成.

• 以下のスクリーンショットは、成功した結果を示しています。 クリック SSO統合 SSO 統合をさらに続行します。

• モジュール側でエラーが発生した場合は、以下のようなウィンドウが表示されます。

• エラーのトラブルシューティングを行うには、次の手順に従います。

• 解決します タブで、プラグイン ログを受信するためのトグルを有効にします。

• 有効にすると、次の場所に移動してプラグイン ログを取得できるようになります。 プラグインの設定 タブをクリックしてクリックします テスト構成.

• ダウンロード ログファイル 解決します タブをクリックして、何が問題だったかを確認してください。

• あなたは共有することができます ログファイル 私たちと一緒に aspnetsupport@xecurify.com 私たちのチームが問題を解決するためにご連絡いたします。

4. 属性マッピング

• 構成をテストした後、アプリケーション属性をアイデンティティ プロバイダー (IdP) 属性にマップします。

• miniOrange ASP.NET SAML SSOモジュールの左側のメニューから、 属性/役割のマッピング 画像に示すようにタブをクリックします。

• IdPから追加の属性を渡したい場合は、属性名と対応する属性値を入力します。 カスタム属性マッピング.

• 注意： マップされたすべての属性はセッションに保存されるため、アプリケーションでアクセスできるようになります。

• 属性がマッピングされたら、 属性マッピングの保存 変更を適用します。

5. 統合コード

• この手順により、アプリケーション内の SSO ユーザー情報をセッションの形式で取得できます。

• 見ることもできます セットアップツアー asp.net モジュール アプリケーションで SSO 統合がどのように機能するかを理解します。

• ユーザー属性にアクセスしたい場所に、そのコード スニペットをコピーして貼り付けるだけです。

• 注意： トライアルモジュールでは、認証されたユーザーの詳細はセッション変数に保存されます。プレミアムプラグインでは、ヘッダーベース、フォームCookieベース、JWTベースの認証を使用したユーザークレームの設定がサポートされています。

6. ログイン設定

• ホバーオン アクションの選択 をクリックします。入力したコードが正しければ、MFAの設定は正常に完了します SSO リンクをコピーします。

• SSO を実行するアプリケーション内のリンクとして次の URL を使用します。

• たとえば、次のように使用できます。

7. ログアウト設定

• SLO を実行するアプリケーションへのリンクとして次の URL を使用します。

• たとえば、次のように使用できます。