チュートリアル: Microsoft Entra シングル サインオン (SSO) と FiscalNote の統合
このチュートリアルでは、FiscalNote を Microsoft Entra ID と統合する方法について説明します。 FiscalNote を Microsoft Entra ID と統合すると、次のことができるようになります。
- FiscalNote にアクセスできるユーザーを Microsoft Entra ID で制御する。
- ユーザーが自分の Microsoft Entra アカウントを使用して FiscalNote に自動的にサインインできるようにする。
- 1 つの場所でアカウントを管理します。
SaaS アプリと Microsoft Entra ID の統合の詳細については、Microsoft Entra ID を使ったアプリケーション アクセスとシングル サインオンに関する記事を参照してください。
前提条件
開始するには、次が必要です。
- Microsoft Entra サブスクリプション。 サブスクリプションがない場合は、無料アカウントを取得できます。
- FiscalNote (SSO) でのシングル サインオンが有効なサブスクリプション。
シナリオの説明
このチュートリアルでは、テスト環境で Microsoft Entra の SSO を構成してテストします。
FiscalNote では、SP Initiated SSO がサポートされます
FiscalNote では、Just-In-Time ユーザー プロビジョニングがサポートされます
ギャラリーからの FiscalNote の追加
Microsoft Entra ID への FiscalNote の統合を構成するには、ギャラリーから管理対象 SaaS アプリの一覧に FiscalNote を追加する必要があります。
- クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
- [ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[新しいアプリケーション] に移動します。
- [ギャラリーから追加する] セクションで、検索ボックスに「FiscalNote」と入力します。
- 結果のパネルから [FiscalNote] を選択し、アプリを追加します。 お使いのテナントにアプリが追加されるのを数秒待機します。
または、Enterprise App Configuration ウィザードを使用することもできます。 このウィザードでは、SSO の構成に加えて、テナントへのアプリケーションの追加、アプリへのユーザーとグループの追加、ロールの割り当てを行うことができます。 Microsoft 365 ウィザードの詳細をご覧ください。
FiscalNote の Microsoft Entra シングル サインオンの構成とテスト
B.Simon というテスト ユーザーを使用して、FiscalNote に対する Microsoft Entra SSO を構成してテストします。 SSO が機能するためには、Microsoft Entra ユーザーと FiscalNote の関連ユーザーとの間にリンク関係を確立する必要があります。
FiscalNote に対して Microsoft Entra SSO を構成してテストするには、次の構成要素を完了します。
- Microsoft Entra SSO を構成する - ユーザーがこの機能を使用できるようにします。
- Microsoft Entra のテスト ユーザーの作成 - B.Simon を使用して Microsoft Entra シングル サインオンをテストします。
- Microsoft Entra テスト ユーザーを割り当てる - B.Simon が Microsoft Entra シングル サインオンを使用できるようにします。
- FiscalNote の SSO の構成 - アプリケーション側でシングル サインオン設定を構成します。
- FiscalNote のテスト ユーザーの作成 - FiscalNote で B.Simon に対応するユーザーを作成し、Microsoft Entra のこのユーザーにリンクさせます。
- SSO のテスト - 構成が機能するかどうかを確認します。
Microsoft Entra SSO の構成
次の手順に従って Microsoft Entra SSO を有効にします。
クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
[ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[FiscalNote]>[シングル サインオン] に移動します。
[シングル サインオン方式の選択] ページで、 [SAML] を選択します。
[SAML でシングル サインオンをセットアップします] ページで、 [基本的な SAML 構成] の編集 (ペン) アイコンをクリックして設定を編集します。
[基本的な SAML 構成] セクションで、次のフィールドの値を入力します。
a. [サインオン URL] ボックスに、次のパターンを使用して URL を入力します。
https://<InstanceName>.fiscalnote.com/login?client=<ClientID>&redirect_uri=https://app.fiscalnote.com/saml-login.html&audience=https://api.fiscalnote.com/&connection=<CONNECTION_NAME>&response_type=id_token%20token
b. [識別子 (エンティティ ID)] ボックスに、次のパターンを使用して URL を入力します。
urn:auth0:fiscalnote:<CONNECTIONNAME>
注意
これらは実際の値ではありません。 実際のサインオン URL と識別子でこれらの値を更新します。 これらの値を取得するには、FiscalNote クライアント サポート チームに問い合わせてください。 [基本的な SAML 構成] セクションに示されているパターンを参照することもできます。
FiscalNote アプリケーションでは、特定の形式の SAML アサーションを使用するため、カスタム属性マッピングを SAML トークン属性の構成に追加する必要があります。 次のスクリーンショットには、既定の属性一覧が示されています。
その他に、FiscalNote アプリケーションでは、いくつかの属性が SAML 応答で返されることが想定されています。それらの属性を次に示します。 これらの属性も値が事前に設定されますが、要件に従ってそれらの値を確認することができます。
名前 ソース属性 familyName User.surname email User.mail [SAML でシングル サインオンをセットアップします] ページの [SAML 署名証明書] セクションで、[証明書 (未加工)] を見つけます。[ダウンロード] を選択して証明書をダウンロードし、お使いのコンピューターに保存します。
[FiscalNote のセットアップ] セクションで、要件に基づいて適切な URL をコピーします。
Microsoft Entra テスト ユーザーを作成する
このセクションでは、B.Simon というテスト ユーザーを作成します。
- Microsoft Entra 管理センターにユーザー管理者以上でサインインしてください。
- [ID]>[ユーザー]>[すべてのユーザー] の順に移動します。
- 画面の上部で [新しいユーザー]>[新しいユーザーの作成] を選択します。
- [ユーザー] プロパティで、以下の手順を実行します。
- "表示名" フィールドに「
B.Simon
」と入力します。 - [ユーザー プリンシパル名] フィールドに「username@companydomain.extension」と入力します。 たとえば、「
B.Simon@contoso.com
」のように入力します。 - [パスワードを表示] チェック ボックスをオンにし、 [パスワード] ボックスに表示された値を書き留めます。
- [Review + create](レビュー + 作成) を選択します。
- "表示名" フィールドに「
- [作成] を選択します。
Microsoft Entra テスト ユーザーを割り当てる
このセクションでは、B.Simon に FiscalNote へのアクセスを許可することで、このユーザーがシングル サインオンを使用できるようにします。
クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
[ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[FiscalNote] に移動します。
アプリの概要ページで、 [管理] セクションを見つけて、 [ユーザーとグループ] を選択します。
[ユーザーの追加] を選択し、 [割り当ての追加] ダイアログで [ユーザーとグループ] を選択します。
[ユーザーとグループ] ダイアログの [ユーザー] の一覧から [B.Simon] を選択し、画面の下部にある [選択] ボタンをクリックします。
SAML アサーション内に任意のロール値が必要な場合、 [ロールの選択] ダイアログでユーザーに適したロールを一覧から選択し、画面の下部にある [選択] をクリックします。
[割り当ての追加] ダイアログで、 [割り当て] をクリックします。
FiscalNote の SSO の構成
FiscalNote 側でシングル サインオンを構成するには、ダウンロードした証明書 (未加工) とアプリケーション構成からコピーした適切な URL を FiscalNote サポート チームに送信する必要があります。 サポート チームはこれを設定して、SAML SSO 接続が両方の側で正しく設定されるようにします。
FiscalNote のテスト ユーザーの作成
このセクションでは、B.Simon というユーザーを FiscalNote に作成します。 FiscalNote では、Just-In-Time ユーザー プロビジョニングがサポートされています。この設定は既定で有効になっています。 このセクションでは、ユーザー側で必要な操作はありません。 FiscalNote にユーザーがまだ存在していない場合は、認証後に新規に作成されます。
注意
ユーザーを手動で作成する必要がある場合は、FiscalNote サポート チームにお問い合わせください。
SSO のテスト
このセクションでは、アクセス パネルを使用して Microsoft Entra シングル サインオン構成をテストします。
アクセス パネル上で [FiscalNote] タイルをクリックすると、SSO を設定した FiscalNote に自動的にサインインします。 アクセス パネルの詳細については、アクセス パネルの概要に関する記事を参照してください。