ディレクトリ連携を設定する

Microsoft Entra ID（以下 Entra ID）または アクティブ ディレクトリ（Active Directory）と BioStar X を連携し、ユーザーを同期・管理する方法を案内します。

Entra ID または Active Directory と連携すると、以下の便利な機能を利用できます。 これにより、セキュリティと利便性を向上できます。

• Entra ID が提供するシングル サインオン（SSO）機能を使用して、Entra ID アカウントで BioStar X にログインできます。

• Active Directory が提供する Lightweight Directory Access Protocol（LDAP）認証を使用して BioStar X にログインできます。

• Entra ID または Active Directory で構成したユーザーおよびグループを BioStar X と同期できます。

• Entra ID または Active Directory で使用される役職・部署・グループなどのユーザー情報を BioStar X のカスタムフィールドにマッピングできます。

情報

Entra ID または Active Directory 設定機能は、アドバンス ライセンス以上で追加オプションとして利用できます。 ライセンスポリシーの詳細は次のドキュメントを参照してください。

Entra ID と連携する

1. BioStar X に管理者 ID でログインします。

2. ランチャーページで設定をクリックします。

3. 画面左のサイドバーで ディレクトリ統合 をクリックします。

4. ディレクトリサービス 項目で Microsoft Entra ID を選択します。

   

5. 以下の案内に従って各項目を設定します。

ｱｸﾃｨﾌﾞﾃﾞｨﾚｸﾄﾘｻｰﾊﾞｰ

ｱｸﾃｨﾌﾞﾃﾞｨﾚｸﾄﾘｻｰﾊﾞｰ セクションで Entra ID のサーバー情報を入力し、接続 ボタンをクリックします。

• クライアント ID：Entra ID で登録したアプリケーションの クライアント ID（Client ID）を入力します。

• クライアントシークレット：Entra ID で登録したアプリケーションの 証明書とシークレット（Certificates & secrets）に追加した クライアント シークレット（Client secrets）を入力します。

• プライマリドメイン：Entra ID で組織を作成するときに入力した既定のドメイン名を入力します。

情報

• Entra ID でアプリケーションを登録する方法は 以下のリンク を参照してください。

• Entra ID で 証明書とシークレット を設定する方法は 以下のリンク を参照してください。

• テナント ID は Entra ID で登録したアプリケーションの 概要（Overview）で確認できます。

• プライマリドメイン の情報は Entra ID の 概要 (Overview) で確認できます。

  

ﾕｰｻﾞｰｸﾞﾙｰﾌﾟ

ｱｸﾃｨﾌﾞﾃﾞｨﾚｸﾄﾘｻｰﾊﾞｰ セクションで設定を完了し、接続 ボタンをクリックすると、ﾕｰｻﾞｰｸﾞﾙｰﾌﾟ セクションでEntra IDからユーザー グループ情報を取得します。 BioStar X に同期しないユーザー グループを選択解除します。

• 更新：ユーザー グループ情報を再読み込みするにはクリックします。

• ボタンをクリックして目的のユーザー グループを検索できます。

ﾌｨｰﾙﾄﾞの設定

BioStar X のユーザーフィールドにマッピングする Entra ID フィールドを設定できます。 ﾌｨｰﾙﾄﾞの設定 セクションで、BioStar X のユーザーフィールドとして使用する Entra ID のフィールドを選択します。

情報

BioStar X の各ユーザーフィールドは、Entra ID のユーザー情報と一致する項目にマッピングできるようデフォルト設定されています。 デフォルト設定されたフィールド値ではなく別のフィールド値を選択するには、Entra ID フィールド 列の項目をクリックして、目的のフィールド値を選択します。

注意

Entra ID と連携する場合、ﾕｰｻﾞｰID フィールドはマッピングできません。 ﾕｰｻﾞｰID は BioStar X が自動生成して適用します。

BioStar X Entra ID を使用したログイン

Entra ID SSO で BioStar X にログインできるようにするには、BioStar X Entra ID を使用したログイン 項目を 有効 に変更します。

リダイレクトURI 項目のリダイレクト URL をコピー（）し、Entra ID ポータルの SSO リダイレクト設定に貼り付けます。 ユーザーが Entra ID でのログインに成功すると、このアドレスへリダイレクトされます。

情報

• Entra ID にアプリケーションを登録し、リダイレクト URI を追加する方法については次のリンクを参照してください。

  • Microsoft Entra ID へのアプリケーション登録

  • アプリにリダイレクト URI を追加

• リダイレクト URL は Entra ID で登録したアプリケーションの 概要（Overview）で確認できます。

同期

Entra ID で変更されたユーザー情報を同期する機能です。

• 同期：希望する同期方式を選択し、同期間隔を設定できます。

  • 手動：今すぐ同期 ボタンをクリックするたびに Entra ID からユーザー情報を取得して同期します。

    

  • 自動：自動同期間隔 項目で設定した間隔で Entra ID からユーザー情報を取得して同期します。 同期間隔は分単位で設定できます。 最小設定値は 30 分、最大設定値は 10,080 分（7 日）です。

    

• 最終同期：直近の同期日時を確認できます。

情報

• 今すぐ同期 ボタンをクリックすると警告メッセージが表示されます。 メッセージを確認して続行する場合は 継続 ボタンを、キャンセルする場合は ｷｬﾝｾﾙ ボタンをクリックします。

  

  同期機能で連携する際に特定のユーザーを同期対象から除外するには 次のドキュメント を参照してください。

• 同期方式が 自動 の状態でも、今すぐ同期 ボタンをクリックすると即時同期できます。

ディレクトリ統合 の設定をすべて完了したら、画面最下部の 適用 ボタンをクリックして保存します。 設定結果を確認するには 次のドキュメント を参照してください。

Active Directory と連携する

1. BioStar X に管理者 ID でログインします。

2. ランチャーページで設定をクリックします。

3. 画面左のサイドバーで ディレクトリ統合 をクリックします。

4. ディレクトリサービス 項目で Microsoft Active Directory を選択します。

   

5. 以下の案内に従って各項目を設定します。

情報

• Active Directory は Windows Server 2008 R2 以降のシステム環境で使用できます。

• Active Directory サーバーを使用するには、設定 → ｻｰﾊﾞｰ メニューで ﾕｰｻﾞｰID種別 項目を 英数字 に設定する必要があります。

ｱｸﾃｨﾌﾞﾃﾞｨﾚｸﾄﾘｻｰﾊﾞｰ

ｱｸﾃｨﾌﾞﾃﾞｨﾚｸﾄﾘｻｰﾊﾞｰ セクションで Active Directory のサーバー情報を入力し、接続 ボタンをクリックします。

• ｻｰﾊﾞｰ ｱﾄﾞﾚｽ：Windows Active Directory サーバーのアドレスを入力します。

• ﾕｰｻﾞｰ名称：Windows Active Directory のログイン ID を入力します。

• ﾊﾟｽﾜｰﾄﾞ：Windows Active Directory のログインパスワードを入力します。

• ﾕｰｻﾞｰﾍﾞｰｽ DN：Windows Active Directory の既定ドメイン名を入力します。 既定ドメイン名は下記の手順で確認できます。

  1. Active Directory 管理センター を起動します。

  2. ユーザーデータが保存されているノード（Node）を右クリックし、プロパティ を選択します。

  3. プロパティ ウィンドウで 拡張 を選択し、属性エディター をクリックします。

  4. distinguishedName の値を確認します。

• 暗号化通信：Windows Active Directory サーバーと通信するときに暗号化を使用できます。 Active Directory 証明書サービスをインストールし、ｷｰｽﾄｱﾊﾟｽﾜｰﾄﾞ を設定するには 次のドキュメント を参照してください。

  • ｷｰｽﾄｱﾊﾟｽﾜｰﾄﾞ：Windows Active Directory サーバーの暗号化キー ストアのパスワードを入力します。 暗号化通信 項目を 有効 に設定すると入力できます。

ﾕｰｻﾞｰｸﾞﾙｰﾌﾟ

ｱｸﾃｨﾌﾞﾃﾞｨﾚｸﾄﾘｻｰﾊﾞｰ セクションで設定を完了し、接続 ボタンをクリックすると、ﾕｰｻﾞｰｸﾞﾙｰﾌﾟ セクションでActive Directoryからユーザー グループ情報を取得します。 BioStar X に同期しないユーザー グループを選択解除します。

• 更新：ユーザー グループ情報を再読み込みするにはクリックします。

• ボタンをクリックして目的のユーザー グループを検索できます。

ﾌｨｰﾙﾄﾞの設定

BioStar X のユーザーフィールドにマッピングする Active Directory フィールドを設定できます。 ﾌｨｰﾙﾄﾞの設定 セクションで、BioStar X のユーザーフィールドとして使用する Active Directory のフィールドを選択します。

情報

BioStar X の各ユーザーフィールドは、Active Directory のユーザー情報と一致する項目にマッピングできるようデフォルト設定されています。 デフォルト設定されたフィールド値ではなく別のフィールド値を選択するには、Active Directory フィールド 列の項目をクリックして、目的のフィールド値を選択します。

BioStar X Active Directory を使用したログイン

Active Directory サーバーのユーザー ID でログインできるようにするには、BioStar X Active Directory を使用したログイン 項目を 有効 に変更します。 Active Directory サーバーの sAMAccountName フィールドの値が BioStar X のログイン ID にマッピングされます。

注意

sAMAccountName フィールドには特殊文字を含めることはできません。 BioStar X のログイン ID ポリシーに合致しない場合、ログインに失敗することがあります。

同期

Active Directory で変更されたユーザー情報を同期する機能です。

• 同期：希望する同期方式を選択し、同期間隔を設定できます。

  • 手動：今すぐ同期 ボタンをクリックするたびに Active Directory からユーザー情報を取得して同期します。

    

  • 自動：自動同期間隔 項目で設定した間隔で Active Directory からユーザー情報を取得して同期します。 同期間隔は分単位で設定できます。 最小設定値は 30 分、最大設定値は 10,080 分（7 日）です。

    

• 最終同期：直近の同期日時を確認できます。

情報

• 今すぐ同期 ボタンをクリックすると警告メッセージが表示されます。 メッセージを確認して続行する場合は 継続 ボタンを、キャンセルする場合は ｷｬﾝｾﾙ ボタンをクリックします。

  

  同期機能で連携する際に特定のユーザーを同期対象から除外するには 次のドキュメント を参照してください。

• 同期方式が 自動 の状態でも、今すぐ同期 ボタンをクリックすると即時同期できます。

ディレクトリ統合 の設定をすべて完了したら、画面最下部の 適用 ボタンをクリックして保存します。 設定結果を確認するには 次のドキュメント を参照してください。

設定結果を確認する

Entra ID または Active Directory との連携設定を完了したら、画面下部の 適用 ボタンをクリックします。 以下の項目を参考に同期された設定を確認します。

• ﾕｰｻﾞｰ メニューで同期されたユーザーの一覧を確認します。

• Entra ID または Active Directory のログイン設定を完了した後、BioStar X にログインするときに Microsoft Entra IDでログイン ボタンが表示されます。

  

ディレクトリ連携を除外する

ディレクトリ統合 機能を使用して Entra ID または Active Directory と連携する場合、ディレクトリサービスに存在しないユーザーは BioStar X から削除されることがあります。 削除したくないユーザーがいる場合、次の方法で連携から除外できます。

1. BioStar X に管理者 ID でログインします。

2. ﾕｰｻﾞｰ メニューに移動します。

3. すべてのﾕｰｻﾞｰ 一覧で連携から除外するユーザーをクリックします。

4. 選択したユーザーの詳細画面が表示されたら、ｱﾄﾞﾊﾞﾝｽﾄﾞ セクションで ディレクトリ統合から除外する 項目のチェックボックスをクリックします。

   

5. 適用 ボタンをクリックします。

選択したユーザーは ディレクトリ統合 機能を使用するときに連携から除外されます。

ディレクトリ連携を解除する

ディレクトリサービス 機能を無効にする場合、次の手順に従います。

1. BioStar X に管理者 ID でログインします。

2. 設定 → ディレクトリ統合 をクリックします。

3. ディレクトリサービス 項目で 未使用 を選択します。

   

4. 注意 メッセージが表示されたら、継続 ボタンをクリックします。

   

5. 画面下部の 適用 ボタンをクリックします。

注意

ディレクトリサービス 機能を 未使用 に設定すると、BioStar X で Entra ID または Active Directory と連携しているすべての設定が解除されます。 連携されたユーザーおよびグループ情報は削除されませんが、以降は同期されません。 連携を解除する前に必ず確認してください。