外部システムとのユーザー管理統合

この機能は、Incredibuild のEnterprise Plan でのみ利用可能です。

Incredibuildのユーザー管理は、Active Directoryのような外部のユーザー管理システムと統合できます。これを有効化すると、外部システムで定義されたユーザーで Incredibuild にログインでき、Incredibuild はそのシステムと直接通信してユーザーを認証します。

統合を有効化した後、Incredibuild でローカルに定義されたユーザーを使用することもできますが、それは Grid Admin ロールを持つユーザに限られます。

Active Directoryとの統合を有効化する

以下の手順は、Active Directory 2022を使用して作成されました。バージョンによって手順が異なる場合があります。

  1. Active Directoryで、Incredibuildにおける3つのレベルのユーザー権限に対応する3つのセキュリティグループを作成します。

    • IB-Grid-Admins

    • IB-Group-Managers

    • IB-Viewers

  2. Active Directory で、Incredibuild に付与する権限に応じて、ユーザー アカウントをセキュリティ グループに追加してください。

  3. Incredibuild が外部ユーザー管理システムでユーザーを検証するために使用する専用ユーザーを定義します。このユーザーには特別な権限やロールは必要ありません。このユーザーは、定期的に期限切れにならないパスワードを持つ必要があります。

  4. Incredibuildで[Settings] >[General] >[User Authentication] と進み、[Disabled] をクリックします。

  5. この統合に使用するプロトコルに応じて、Active DirectoryとLDAPまたはLDAPSのいずれかを選択します。

  6. LDAPSを選択した場合：

    • ldapサーバーの形式は 「ldaps」で始まる必要があります（例：ldaps://1.2.3.4:1234###）\

    • LDAPS証明書を発行したCAのルート証明書を入力する必要があります。証明書チェーンをお持ちの場合は、証明書を1つのファイルにコピー/ペーストして、ここに入力してください。

  7. Active Directoryアカウントの設定を入力します。

    • LDAP(S)サーバーとポートは、「ldap://<server>:<port>」のフォーマットと一致する必要があります。例：ldap://localhost:389

    • [Bind DN] (LDAP 形式のユーザー名) と[Bind Password]フィールドに、Incredibuild が他のユーザーを検証するための専用ユーザー (上記のステップで作成) の認証情報を入力します。

    • User SearchのDNは、Incredibuildがユーザを検証するために検索するフォルダです。LDAP形式である必要があります。

Microsoft Entra IDの統合を有効化する

Microsoft Entra IDは、以前はAzure Active Directoryと呼ばれていました。以下の手順は、Microsoft Entra IDの2023年12月リリースを使用して作成されました。今後のバージョンでは手順が若干異なる可能性があります。

  1. Microsoft Entra ID で、Incredibuildにおけるユーザー権限の3つのレベルに対応する3つのセキュリティグループを作成します。

    • IB-Grid-Admins

    • IB-Group-Managers

    • IB-Viewers

  2. Microsoft Entra ID で、Incredibuild に持たせる権限に応じてユーザーアカウントをセキュリティグループに追加します。

  3. Microsoft Entra ID で、[App Registrations] >[New Registration] に進みます。

    1. 「Name」 を指定し、」[Accounts in this organization directory only] を選択します。

    2. [Redirect URI]で、「Web」 を選択し、[https://localhost:8000/azureCallback] を入力してください。

    3. Register をクリックします。

    4. 「Application (クライアント)ID」と「Directory(テナント)ID」をコピーし、将来の使用のために保存します。

  4. [Authentication]エリアに、2つの「Redirect URI」を追加します。

    1. https://<coordinator IP>:8000/azureCallback

    2. https://<coordinator DNS name>:8000/azureCallback

  5. 「API Permissions」のエリアで、[Microsoft Graph] 権限をクリックし、[GroupMember.Read.All] 権限を追加します。

  6. [Grant admin consent for <your organization account>] をクリックしてください。

  7. 「Certificates and Secrets」「のエリアで、「New client secret」を作成します。

  8. 「Secret」 の値をコピーして保存してください。コピーせずにこの画面を離れると、この値は非表示になります。

  9. Incredibuildで[Settings] >[General] >[User Authentication] と進み、[Disabled] をクリックします。

  10. Microsoft Entra IDアカウントの設定を入力します。

統合の設定を編集する

統合を有効化した後に設定を変更する場合は、以下の手順で統合を無効化し、再度有効化する必要があります。

  1. Incredibuildで、[Settings] >[General] >[User Authentication] と進み、「User Authentication」エリアをクリックします。

  2. 設定ウィンドウで、[Disable] をクリックします。

  3. 統合を再度有効化し、必要に応じて設定を変更してください。

Incredibuildへのログイン

Active Directoryユーザーの場合、Incredibuildのログイン画面が標準のログイン画面となります。ユーザーは、Active Directoryユーザー、またはGrid Admin権限を持つ Incredibuild ユーザーの認証情報を入力します。

同じ名前のユーザーが2人で、1つは Active Directory に、もう1つは Incredibuild に Grid Admin 権限を持つ場合、Incredibuild はローカル ユーザーを使用します。認証情報がローカルユーザーと一致しない場合、Incredibuild は外部ユーザー管理システムで定義されたユーザーをチェックします。

Microsoft Entra ID ユーザーの場合は、[Login with Azure AD] ボタンをクリックし、ポップアップに認証情報を入力します。標準のログインボタンは、グリッド管理者権限を持つローカルのIncredibuildユーザー用です。

対応ユーザー管理システム

  • Microsoft Entra ID（旧名称：Azure Active Directory）

  • LDAPプロトコルによるActive Directory

トラブルシューティング

ユーザー管理システムに接続できない

外部のユーザー管理システムに接続できない場合、Incredibuild はユーザーを検証できず、ログインを許可できません。グリッド管理者権限を持つローカルの Incredibuild ユーザーでログインできます。これらの認証情報がない場合は、Forgot Username or Password をご覧ください。

必要であれば、統合を無効にしてIncredibuildで直接ユーザーを管理できます。