次のリンク先より入手した「Office 365（Microsoft Entra ID※）用認証プロバイダー」を登録することによって、Office 365の認証情報を使用したForguncyアプリケーションに対するシングルサインオンができるようになります。なお、Office 365の認証情報を使用する場合、ForguncyアプリケーションはHTTPSを有効にして発行されたアプリケーションである必要があります。これはOffice 365の認証（Microsoft Entra ID）においてHTTPSによる暗号化通信が必須となっているためです。
本プロバイダーはOIDC認証で実装されています。

※ Azure ADは、Microsoft Entra IDに名称が変更されました。

ダウンロードリンク

※利用しているバージョンによって対応する認証プロバイダーはが異なります。以下より該当するバージョンをお選びください。

Forguncy Builder / Forguncy Serverのバージョン	プロバイダー
10.0.10.0以降の10.x.x.x	office365securityprovider_10_0_10_0.zip

認証プロバイダーの登録

1. サーバー管理ポータルにログインします。

   Office 365の認証（Microsoft Entra ID）はHTTPSによる暗号化通信が必須となるため、Forguncy Builderのデバッグ実行では動作を確認することができません。HTTPSを有効化してForguncy Serverにアプリケーションを発行する必要があります。

2. ［認証連携］-［プロバイダーの登録］をクリックしてダウンロードしたZIPファイルを選択します。

   

3. 登録が完了すると、以下のように表示されます。

   

   ［認証設定の追加］をクリックします。次の図のようにOffice 365（Microsoft Entra ID）の認証を使用するために設定が必要な項目が表示されます。以降の手順にて、これらの設定値の取得方法を説明します。

   

必要となるMicrosoft Entra IDの設定と設定値の確認

1. Azure Portal の左側のメニューから [Microsoft Entra ID] をクリックします。

   

2. 左側のメニューから [アプリの登録］をクリックします。

   

3. 上部にある［新規登録］をクリックします。

   

4. ［名前］に任意の名前を入力し、［登録］ボタンをクリックします。

   本ページの例では「forguncyapp1」と入力しています。

   

5. 作成したアプリの左側のメニューから［証明書とシークレット］をクリックします。

   

6. ［新しいクライアント シークレット］ボタンをクリックします。

   

7. 必要に応じて［説明］を入力し、任意の［有効期限］を選択して［追加］ボタンをクリックします。

   

8. ［値］列に設定値として必要となるクライアントシークレットの値が表示されます。

   本値を設定するために値の右側の［クリップボードにコピー］をクリックして、値をクリップボードへとコピーしておきます。本値はこのタイミングでしか取得できません。ページを遷移してしまった場合、再度同じ値を取得することはできなくなるため注意してください。

   

9. Forguncyの「Office 365（Microsoft Entra ID）用認証プロバイダー」における［その他の設定］ページにある［クライアント シークレット］にクリップボードにコピーした値を入力します。

   

10. 作成したアプリの左側のメニューから［APIのアクセス許可］をクリックします。

    

11. ［***** に管理者の同意を与えます］をクリックし、その後表示される警告ダイアログの［はい］をクリックしてアクセス許可に対する同意を付与します。

    

12. 作成したアプリの概要ページを表示し、［アプリケーション (クライアント) ID］と［ディレクトリ (テナント) ID］の2つの値が表示されていることを確認します。

    

13. 1つ前の手順で確認した［アプリケーション (クライアント) ID］と［ディレクトリ (テナント) ID］の2つの値をコピーし、Forguncyの「Office 365（Microsoft Entra ID）用認証プロバイダー」における［その他の設定］ページにある［アプリケーション (クライアント) ID］と［ディレクトリ (テナント) ID］にそれぞれ入力し、［設定の保存］ボタンをクリックします。

    

リダイレクトURIの設定

1. 作成したアプリの概要ページを表示し、［リダイレクトURIを追加する］をクリックします。

   

2. ［プラットフォームを追加］をクリックします。

   

3. ［Web］をクリックします。

   

4. ［リダイレクト URI］に対象のアプリケーションのURLに「/signin-oidc」を付けた文字列を設定し、［構成］ボタンをクリックします。

   複数のForguncyアプリケーションで本認証プロバイダーによる認証を使用する場合には、それぞれのリダイレクトURLを追加してください。1つのMicrosoft Entra IDアプリに対して複数のリダイレクトURLを設定することが可能です。

   

5. 対象のアプリケーションへのアクセスにドメイン名を使用している場合、サーバー管理ポータルの対象のアプリケーションの設定ページおいて［ドメイン名］を設定し、［設定の保存］ボタンをクリックします。

   ホスト名やIPアドレスを使用してアクセスしているアプリケーションの場合、本設定は不要です。

   

ローカルログアウト

Forguncyが提供する「Office 365（Microsoft Entra ID）用認証プロバイダー」はローカルログアウトをサポートしています。シングルログアウトはサポートしていないことに注意してください。

ローカルログアウトとは、Forguncyアプリケーション上だけでログアウトする動作を意味します。そのため、ログアウト後に遷移するスタートページがログイン認証を要求するページの場合、自動的にIdP側との認証処理が行われ、再度ログインしてしまいます。「ページ表示権限の管理」にて、スタートページを誰でもアクセス可能にすることで、自動の認証処理が行われなくなるためForguncyからのログアウトが可能となります。