Authentication Server構成

Blue Prismアプリケーションサーバーを構成する

Authentication ServerからBlue Prismにユーザーを追加し、ユーザーデータを同期するには、Authentication Server APIへの認証リクエストを行うために作成したサービスアカウントの詳細をBlue Prismアプリケーションサーバーで構成する必要があります。 さらに、Blue Prismアプリケーションサーバーは、Authentication Serverによってメッセージキューに公開されるユーザーおよびサービスアカウントイベントを処理するように構成できるため、Authentication Serverのユーザーおよびサービスアカウントの更新が、マッピングされたBlue Prismユーザーまたはサービスアカウントに適用されます。

この設定は、Blue Prismサーバー構成の詳細画面の［Authentication Server統合］タブで行います。

1. Blue Prismアプリケーションサーバー（C:\Program Files\Blue Prism Limited\Blue Prism AutomateのBPServer.exe）を起動します。
2. サーバー構成を開くには、［現在の構成］ドロップダウンから該当する環境を選択し、［編集］をクリックします。

3. ［Authentication Server統合］タブで、次の操作を行います。

   1. Blue Prism Hubをインストールするときに構成したブローカー設定を入力します。

      • アドレス – rabbitmq://<host>:<port>/という形式のRabbitMQアドレス
      • ユーザー名 – RabbitMQのユーザー名
      • パスワード – RabbitMQのパスワード

      • 環境識別子 – 構成されたさまざまなBlue Prism環境を区別するために使用されます（該当する場合）。この値には、文字、数字、ハイフン、アンダースコア、ピリオド、コロンの文字列のみを使用できます。

        

   2. クライアントの詳細を入力します。これらはユーザーとサービスアカウントの同期や、「Hubでサービスアカウントを作成する 」で構成したBlue Prismの役割にAuthentication Serverユーザーを追加するなど、Authentication Server APIを直接呼び出すときに使用されます。

      • クライアントID – Blue PrismがAuthentication Serverと通信するために使用するサービスアカウントのクライアントID。
      • クライアントシークレット – Blue PrismがAuthentication Serverとの通信に使用する、サービスアカウントによって生成されるクライアントシークレットキー。

      Hub 4.7以降では、クライアントIDの大文字と小文字が区別されます。サービスアカウントで定義されているものと同じ大文字/小文字でクライアントIDを入力する必要があります。

   3. ［テスト接続］をクリックして、入力した詳細が有効であることを確認します。

      ユーザーマッピングが完了するまで、［接続を有効化］を選択しないでください。ユーザーマッピングが完了したら、変更を保存して接続を有効にできます。

   4. ［保存］をクリックして設定を適用します。

マッピングツールを使用してユーザーを追加する

マッピングを開始する前に、システムにBlue Prismのネイティブ管理者ユーザーが存在することを確認し、このユーザーをマッピングファイルから手動で削除してから、以下に示すマッピングプロセスを実行してください。これは、Authentication Serverまたはシステム構成に問題がある場合に、データベースへの直接接続によりログインできる管理者ユーザーが常に存在するようにするためです。

対応するHubユーザーアカウントをまだ持っていない既存のBlue PrismネイティブユーザーのアカウントをAuthentication Serverデータベースに作成する

1. 管理者としてコマンドプロンプトを開き、AutomateC.exeを含むBlue Prismインストールディレクトリ（C:\Program Files\Blue Prism Limited\Blue Prism Automateなど）に移動します。

2. 次のコマンドを実行して、マッピングに使用できるデータベース内のすべてのBlue Prismネイティブユーザーのリストを含むCSVテンプレートファイルを取得します。

   コピー

   automatec /getblueprismtemplateforusermapping <pathtooutputfile> /user <adminuser> <adminpwd> 

3. Windows Explorerから出力ファイルを開き、追加する各Blue Prismユーザーの名、姓、メールアドレスを追加します。

   追加の［名］、［姓］、［メールアドレス］フィールドは、Blue Prismに存在しないため、Authentication Serverでユーザーを作成するために追加する必要があります。

4. Authentication Server経由でログインすべきでないユーザーをファイルから削除します。少なくとも1人のネイティブ管理者ユーザーをファイルから削除し、データベースへの直接接続を使用してログインできるようにする必要があります。

   ネイティブ認証を使用してランタイムリソース、AutomateCコマンド、またはWebサービスリクエストも認証する場合は、これらの認証に必要なネイティブユーザーアカウントもファイルから削除する必要があります。

5. CSVファイルを保存します。

6. コマンドプロンプトを管理者として開き、AutomateC.exeを含むBlue Prismインストールディレクトリに移動します。

7. 次のコマンドを実行して、ユーザーマッピングを完了します。

   コピー

   automatec /mapauthenticationserverusers <input CSV> <output CSV for errors> /user <admin username> <admin password> /dbconname <Blue Prism Server connection name>

   ここでは、

   • <input CSV> – 保存したCSVファイルへのパス。
   • <output CSV for errors> – マッピングプロセスにエラーが発生した場合に、自動的に作成されるファイルのパス。
   • <admin username>および<admin password> – Blue Prismのネイティブ管理者ユーザーの認証情報。

   • <Blue Prism server connection name> – Blue Prismサーバー設定で設定されたBlue Prismサーバーの接続名。

   例：

   

   コマンドを実行するマシンがAuthentication Server Webサイトにアクセスできることを確認します。詳細については、「Authentication Serverのトラブルシューティング」を参照してください。

既存のBlue Prismユーザーを既存のAuthentication Serverユーザーにマッピングする

1. 管理者としてコマンドプロンプトを開き、AutomateC.exeを含むBlue Prismインストールディレクトリ（C:\Program Files\Blue Prism Limited\Blue Prism Automateなど）に移動します。

2. 次のコマンドを実行して、Blue Prismデータベースでマッピングに使用できるすべてのユーザーのリストを含むCSVテンプレートファイルを取得します。

   コピー

   automatec /getblueprismtemplateforusermapping <pathtooutputfile> /user <adminuser> <adminpwd> 

3. 次のコマンドを実行して、Authentication Serverデータベースでマッピングできるすべてのユーザーのリストを含むCSVテンプレートファイルを取得します。

   コピー

   automatec /getauthenticationservertemplateforusermapping {outputpath} /dbconname <Blue Prism Server connection name>

4. Windows Explorerから両方の出力ファイルを開き、マッピングする各Blue Prismユーザーに対応するAuthentication Serverユーザーを検索し、Blue Prismユーザー名をAuthentication Server出力ファイルにコピーします。

   Blue Prismユーザー名とAuthentication ServerユーザーIDは、最低限必要です。Authentication Serverデータベースに必要な追加の［名］、［姓］、［メールアドレス］フィールドは、Authentication Serverユーザーに対してすでに存在している必要があります。

5. Authentication Server出力ファイルからマッピングするべきでないユーザーを削除します。少なくとも1人のネイティブ管理者ユーザーをファイルから削除し、データベースへの直接接続を使用してログインできるようにする必要があります。また、ランタイムリソース、AutomateCコマンド、またはWebサービスリクエストの認証に必要なネイティブユーザーアカウントをファイルから削除することもできます。
6. Authentication Serverの出力ファイルを保存します。
7. コマンドプロンプトを管理者として開き、AutomateC.exeを含むBlue Prismインストールディレクトリに移動します。

8. 次のコマンドを実行して、ユーザーマッピングを完了します。

   コピー

   automatec /mapauthenticationserverusers <input CSV> <output CSV for errors> /user <admin username> <admin password> /dbconname <Blue Prism Server connection name>

   ここでは、

   • <input CSV> – 保存したCSVファイルへのパス。
   • <output CSV for errors> – マッピングプロセスにエラーが発生した場合に、自動的に作成されるファイルのパス。
   • <admin username>および<admin password> – Blue Prismのネイティブ管理者ユーザーの認証情報。

   • <Blue Prism server connection name> – Blue Prismサーバー設定で設定されたBlue Prismサーバーの接続名。

   例：

   

   コマンドを実行するマシンがAuthentication Server Webサイトにアクセスできることを確認します。詳細については、「Authentication Serverのトラブルシューティング」を参照してください。

存在しないBlue PrismユーザーにAuthentication Serverユーザーをマッピングすることはできません。管理者がCSVファイルにBlue Prismユーザー名を入力せず、Authentication ServerユーザーIDを入力すると、エラーメッセージが表示されます。

例：

メッセージングサーバーへの接続を有効にする

1. Blue Prismアプリケーションサーバー（C:\Program Files\Blue Prism Limited\Blue Prism AutomateのBPServer.exe）を起動します。

2. サーバー構成画面で、［停止］をクリックしてBPServerを停止します。

3. サーバー構成の詳細画面の［Authentication Server統合］タブで、接続［接続を有効化］を選択し、［保存］をクリックします。
4. サーバー構成画面に戻り、［開始］をクリックしてBPServerを起動します。

5. メッセージバスが実行中であることを確認します。次の行が表示されます。

   ［日付スタンプ］: メッセージバス開始

   ［日付スタンプ］: メッセージバス開始

   Blue Prismサーバーが正常に実行され、接続が有効になっている場合、Hubで編集または削除されたユーザー、またはHubで作成、編集または削除されたサービスアカウントもBlue Prismで更新されます。Blue Prismサーバーがオフラインになるか、後でオンラインになった場合は、接続が回復すると同期が完了します。

6. メッセージキューが作成されたことを確認するには、「Blue Prism Hubのインストール」で構成したRabbitMQ URLをブラウザーで起動します（この例ではrabbitmq://localhost:15672/）。

7. ［キュー］タブで、上記のAuthentication Server統合の設定で作成したばかりのキュー（blue-prism-app-server.user-synchronization.fresh-installなど）を探します。

ユーザーとサービスアカウントの手動同期

ユーザーとサービスアカウントの更新は、サービスが中断した場合に、Blue Prismインタラクティブクライアントの［セキュリティ - ユーザー］画面のメニューボタンから利用できる［ユーザーをAuthentication Serverと同期］オプションを使用して、RabbitMQ更新スケジュール外でBlue PrismとAuthentication Serverデータベース間で、手動で同期できます。

このオプションを使用するには、Authentication Server APIへの認証済みリクエストを行うために使用されるサービスアカウントのクライアント詳細で構成されたBlue Prismアプリケーションサーバーを介して、インタラクティブクライアントを接続する必要があります。

選択すると、次の更新が行われます。

• 新しいAuthentication ServerサービスアカウントがBlue Prismデータベースに追加されます。

  Authentication Serverと同期すると、HubでBlue Prism API許可で設定されたサービスアカウントのみが［セキュリティ - ユーザー］画面に表示されます。

  このオプションを使用する場合、Authentication ServerユーザーはBlue Prism環境に追加されないため、［役割メンバーシップ］画面でBlue Prismの役割に手動で割り当てる必要があります。詳細については、「新しいBlue Prism環境」を参照してください。この仕組みにより、Blue Prismへのアクセスを必要としない多数のAuthentication Serverユーザー（Interactユーザーなど）がBlue Prismデータベースに追加されないようにします。

• Authentication Serverデータベースで廃止されたユーザーおよびサービスアカウントは、Blue Prismデータベースでも廃止されます。
• Authentication Serverデータベースで廃止されていないユーザーおよびサービスアカウントは、Blue Prismデータベースでも廃止されません。

手動同期のみを使用するよう選択し、メッセージングサーバーへの接続を有効にしない場合、ユーザーアカウントがBlue Prismで削除されているがHubで廃止されていない場合は、手動で同期してユーザーアカウントを再アクティブ化してから、Authentication Serverを介してBlue Prismにログインする必要があります。