Windows用ScreenAgent

ScreenAgent閉じた NICE ScreenAgentは、画面の記録が必要なエージェントデスクトップで実行されるサービスです。は、CXone Recording Advancedと画面録画ライセンスをお持ちの場合にご利用いただけます。

ScreenAgentをコンピューターにインストールして、インタラクション中のエージェントの画面上のアクティビティを記録または監視します。ScreenAgentはバックグラウンドで実行され、記録ポリシーに従って自動的に記録します（CXone Recordingを参照）。スーパーバイザーと評価者は、対話中のエージェントのアクティビティを監視することもできます。

CXone Recordingワークフォースエンゲージメント(WEM)が最新のテクノロジーを活用したシームレスなカスタマーエクスペリエンスを提供できるよう、サポートされているScreenAgentバージョンを使用していることを確認してください：

  • Windows用ScreenAgentバージョン3.0.22以降。

  • MAC用ScreenAgentバージョン3.0.1以降。

古いScreenAgentバージョンを使用している場合は、すべてのユーザーをScreenAgent3.0.xバージョンにアップグレードする必要があります。古いバージョンはサポートされておらず、エージェントの画面が記録されない可能性があります。

ScreenAgentの最新バージョンは、ダウンロードページにあります。

ScreenAgent 3.0.xバージョンを使用するには、以下のFQDNが許可されていることを確認してください。

  • FedRamp：cxone-gov.niceincontact.com

  • その他のすべての地域：cxone.niceincontact.com

ScreenAgentは、エージェントのコンピューターにインストールすることも、仮想デスクトップインフラストラクチャ（VDI）環境にインストールすることもできます。サポートされているVDIは次のとおりです。

  • VMware Horizon

  • Citrix Virtual Desktops（旧名XenDesktop）。

  • Citrix Virtual Apps（旧名XenApp）

  • 非パーシステントVDI環境

  • マルチセッション環境

  • ターミナルサーバータイプのVDI環境

VMware Horizonは、特別な構成を必要としません。その他のVDI環境については、前提条件を参照してください。

インストールの前でも後でもScreenAgent接続の確認できます。

100%の画面録画で設定されたテナントの場合、画面録画は、エージェントのログインから最大25秒後に開始します。この25秒の間、画面録画は適切に機能しません。

 

エージェントのコンピューターにScreenAgentをインストールする概要を説明する ビデオ を見ることができます。ビデオには、前提条件とインストール手順が含まれています。

詳細については、ScreenAgentに関するFAQを参照してください。

以前のScreenAgentリリースに追加された機能のリストは、ScreenAgent：累積リリースノートを参照してください。

前提条件

ScreenAgentをインストールする前に、次のことを確認してください。

  1. 接続要件を確認してください。ファイアウォールが自己署名証明書を生成したり、HTTPSパケットから申請ヘッダーを取り除いたりした場合、ScreenAgentは記録しないことに注意してください。

  2. サイトでVDIを使用している場合は、次のことを確認してください。

    • ScreenAgentV3.x.x以降を使用しています。

    • Citrix仮想アプリモードの場合：

      • 仮想IPループバックポリシーを有効にします。ScreenAgent.exeとChrome.exeを仮想IP仮想ループバックプログラムリストに追加します。各プログラムは別々の行に記載する必要があることに注意してください。

      • ScreenAgentをCitrix Virtual Appsサーバーにインストールします。

    • 非パーシステントVDI環境の場合:

      • ScreenAgentバージョン3.0.22以降を使用してください。

      • VDIのベースイメージにScreenAgentをインストールする。

      • ベースイメージのスナップショットを取る

      • すべてのVDIインスタンスに配布します。

    • マルチセッション環境およびターミナルサービスタイプVDI環境の場合：

      • ScreenAgentバージョン3.0.22以降を使用してください。

      • OSログインモードで動作するようにScreenAgent を設定します。

      • ユーザーはScreenAgentにOSログイン資格情報でログインする必要があります。

      各従業員プロファイルのOSログイン値は一意でなければなりません。OS Loginの値は、重複する従業員プロファイルの一部が非アクティブであっても、複数の従業員プロファイルに使用することはできません。複数の従業員プロファイルが同じOSログイン値を持つ場合、ScreenAgentはそのOSログイン値を使用するエージェントに対して実行されません。

    マルチセッションまたは非パーシステントVDI環境で作業していて問題が発生した場合は、NICEサポートに連絡して、特定の環境がサポートされているかどうかを確認してください。

    VMware HorizonおよびCitrix仮想デスクトップモードでは、特別な構成は必要ありません。

  3. エージェントのコンピューター構成を確認してください。

    • エージェントのコンピューターにインストールされているMicrosoft.NET4以降。

    • エージェント向けのソフトフォンソリューションの1つ：

      • CXone Agent.

      • ScreenAgentと同じコンピューターにインストールされているSalesforce Agentソフトフォン。

      • MAXソフトフォン。

    • プラットフォーム要件の関連するコンピュータの仕様。

      コンピューターの構成がフルHDまたは4Kに設定されていて、CPU使用率が高い場合は、より強力なCPU（i5など）が必要になる可能性があることに注意してください。

    • ポート31322が開いています。このポートは、ScreenAgentとエージェントのコンピューター上のMAX/CXone Agent/Salesforce Agentソフトフォンの間の内部通信にのみ使用されます。OSログインを使用する場合は必要ありません。

  4. ScreenAgentをインストールしているユーザー（たとえば、管理者）が、エージェントのコンピューターに対する管理者権限を持っていることを確認してください。

  5. ScreenAgentをインストールするユーザー（たとえば、管理者）に次のCXone権限があることを確認します。

    • サポートダウンロードにアクセス：オン、これにより、サポート-ダウンロードページにアクセスできます。

    • アクセスキー：作成、これは組織のアクセスキーを管理するためのものです。

  6. ScreenAgentのアクセスキーを生成します。

    同じアクセスキーを使用して、テナント内のすべてのエージェントのコンピューターにScreenAgentをインストールできます。

    アクセスキーは、権限を生成するCXoneユーザーの権限をすべて受け取ります。このユーザーが管理者の場合、アクセスキーを持っている人は誰でも管理者権限を持ちます。したがって、セキュリティ上の理由から、最初にCXoneユーザーとScreenAgentのロールを作成してから、ScreenAgentユーザーでキーを生成します。

    1. ScreenAgentサービスのロールを作成します。

      1. アプリセレクターをクリックして、選択Admin 。

      2. セキュリティ > ロールと権限に移動します。

      3. 新しいロールをクリックします。

      4. ScreenAgentアクセスキーのようなロールの名前を付けます。

      5. 役割のすべての権限(アクセスキーおよび自分のアクセスキーを除く)を削除します。

      6. プロファイルを保存してアクティブ化します。

    2. ScreenAgentサービスの従業員を作成します。

      1. アプリセレクターをクリックして、選択Admin 。

      2. 従業員をクリックします。

      3. 新入社員をクリックします。

      4. ScreenAgentのような従業員の名前を付けます。

      5. 主なロールドロップダウンリストから、作成したばかりのScreenAgentアクセスキーロールを選択します。

      6. [全般]タブで、すべての属性をクリアします。

      7. ScreenAgent従業員を作成します。アクセスキーは、アカウントの作成後にのみ生成できます。

    3. ScreenAgent従業員をもう一度開き、タブに移動します。アクセスキーを追加をクリックしてアクセスキーを生成します。

    4. アクセスキーIDとシークレットアクセスキーの両方をコピーして、安全な場所に保存します。シークレットアクセスキーをコピーしない場合、または紛失した場合は、新しいキーを作成する必要があります。ScreenAgentをすべてのエージェントのコンピューターにインストールする時は、このアクセスキーIDとシークレットアクセスキーを使用してください。

    5. 有効化メールのアカウントを有効化ボタンをクリックして、ScreenAgent従業員アカウントを有効化します。

  7. ScreenAgentMSIをダウンロードします。

    1. CXoneに移動し、サポートダウンロードにアクセス可能権限を持つユーザーとしてログインします。

    2. ユーザー名をクリックしてサポートとダウンロードを選択します。

    3. 必要なMSIをダウンロードします。MSIをダウンロードする場所に注意してください。ファイルの場所は後で必要になります。

  8. ScreenAgentは、画面録画用に、基本、ダイジェスト、Kerberos、NTLM、およびネゴシエートの5つのプロキシ認証方法をサポートしています。プロキシ認証方式を使用する場合：

    • プロキシ設定では、必ずオペレーティングシステムレベルでプロキシを設定してください。

    • 基本認証とダイジェスト認証の方法では、Windows資格情報マネージャーで視覚情報を設定する必要があります。

    • インストールに変更はありません。ただし、オペレーティングシステムでプロキシを変更せずにScreenAgentのプロキシを使用する場合は、ScreenAgentのインストールで直接プロキシを使用できます。

    • これらの認証方法は画面録画専用であり、画面監視用ではないことに注意してください。

Windows用ScreenAgentをインストールする

ScreenAgentは、展開ツールを使用してインストールするか、各エージェントのコンピューターに手動でインストールすることができます。

展開ツールを使用している場合は、インストールを次のいずれかに構成します。

  • ユーザー権限（ユーザーモード/ユーザーコンテキスト）で実行-エージェントのコンピューターを再起動する必要はありません。

  • 管理者権限で実行—すべてのエージェントのコンピュータを再起動する必要があります。

インストール場所を指定できます。

  • デフォルトでは、ScreenAgentはCドライブの「\NICE-InContact\ScreenAgent」フォルダにインストールされます。インストールコマンドで別のインストールパスを指定することができます。

  • 新しいバージョンにアップグレードする場合、異なるインストールパスを定義できます。前のバージョンは削除され、後のバージョンは指定された場所にインストールされます。

  • 同じページを再インストールするScreenAgentバージョンは、同じ場所に既存のインストールを置き換えます。インストールパスを変更するには、既存のインスタンスをアンインストールし、再インストール時に必要な場所を指定します。

一部のScreenAgentパラメータはインストール後に変更できます。ScreenAgent構成の変更を参照してください。他のインストールパラメータを更新するには、ScreenAgentクライアントを再インストールします。

ScreenAgentを新しいバージョンにアップグレードするには、ScreenAgentクライアントをインストールします。旧バージョンをアンインストールする必要はありません。

ScreenAgentをアップグレードまたは再インストールする場合、異なるパラメータ設定を指定しない限り、インストールは自動的に既存の構成を使用します。現在の構成で再インストールまたはアップグレードするを参照してください。ScreenAgentをアンインストールすると、構成は保存されないため、アップグレードまたは再インストール時にインストール・パラメータを指定する必要があります。

エージェントが記録されていないと、ScreenAgentをアップグレードまたは再インストールします。インストール中にエージェントが通話中の場合、その通話の画面録画は停止します。インストールの完了後、通話は録音ポリシーとStudioスクリプトに従って録音されます。

ScreenAgentをインストールするには：

  1. すべての前提条件が整っていることを確認してください。

  2. 管理者としてコマンドプロンプトを開きます。コマンドラインで、MSIをダウンロードした場所に移動し、関連するパラメータを指定してインストールコマンドを入力します。

    1. MSIをダウンロードしたフォルダーに移動し、フォルダーへのパスをコピーします。これは通常、%UserProfile%\downloadsフォルダーです。

    2. 管理者としてコマンドプロンプトを実行します。

      1. Windowsで、 ウィンドウズボタンとタイプcmdをクリックします。

      2. コマンドプロンプトタイルを右クリックして、 管理者として実行をクリックします。

    3. cd/と入力し、Enterキーを押します。

    4. cdと入力してファイルの場所を貼り付け、Enterキーを押します。

      たとえば、cd %UserProfile%\downloadsです。

    5. コマンドをコピーしてコマンドプロンプトに貼り付け、表にリストされているパラメータを編集します。

      • ウェブプロキシがない場合、またはOSレベルでプロキシが定義されている場合は、このコマンドを使用してください。

        msiexec /i ScreenAgent-<32|64>bit-<MSI version>.msi INSTALL_PATH=<オプション：インストールパス> ACCESS_KEY_ID=<アクセスキーID> ACCESS_KEY_SECRET=<シークレットアクセスキー> REGION_TYPE=<CXone URLのサブドメイン(最初の3文字)> RESOLVE_USER=<オプション：auto|oslogin> FRAME_PER_SECOND=<オプション：1、2、3、4、または5> RESOLUTION_LEVEL=<オプション：null、low、medium、またはhigh> LOAD_CERTIFICATES=<オプション：true|false> STATISTICS=<オプション：true|false>/log install.log /quiet

      • プロキシ認証を使用していて、プロキシがOSレベルで定義されていない場合は、次のコマンドを使用します。

        msiexec /i ScreenAgent-<32|64>bit-<MSI version>.msi INSTALL_PATH=<オプション：インストールパス> ACCESS_KEY_ID=<アクセスキーID> ACCESS_KEY_SECRET=<シークレットアクセスキー> REGION_TYPE=<CXone URLのサブドメイン(最初の3文字) > WEB_PROXY=<インターネットに接続するためにプロキシサーバーを使用している場合のみ> RESOLVE_USER=<オプション：auto|oslogin> FRAME_PER_SECOND=<オプション：1、2、3、4、または5> RESOLUTION_LEVEL=<オプション：null、low、medium、またはhigh> LOAD_CERTIFICATES=<オプション：true|false> STATISTICS=<オプション：true|false> /log install.log /quiet

      インストールコマンドの例（Webプロキシがない場合、またはOSレベルでプロキシが定義されている場合）：

      msiexec /i ScreenAgent-64bit-3.0.37.msi INSTALL_PATH=d:\newdir ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1 RESOLVE_USER=oslogin FRAME_PER_SECOND=5 RESOLUTION_LEVEL=high  LOAD_CERTIFICATES=true STATISTICS=true /log install.log /quiet

    次のコマンドを使用します。

    msiexec /i ScreenAgent-<32|64>bit-<MSI version>.msi KEEP_CURRENT_CONFIG= true

    このパラメータのデフォルト値はtrueなので、KEEP_CURRENT_CONFIG= trueはオプションです。

    • 以前のインストールですべての構成が設定されていた場合、ScreenAgentは既存のすべての構成でインストールされます。

    • 以前のインストールでいくつかの設定がなかったり、設定されていなかったりした場合、ScreenAgentは既存の設定と、不足しているパラメータのデフォルト値でインストールされます。

    • インストールパスはインストール後に保存されません。インストールコマンドで指定されていない場合、KEEP_CURRENT_CONFIG=trueであっても、ScreenAgentはデフォルトの場所にインストールされます。

    いくつかのパラメータ設定を維持し、他のパラメータ設定を変更するには、上記のコマンドを使用し、必要に応じて他のパラメータを追加します。たとえば、フレーム/秒と解像度レベルのみを変更するには、次のようにします（KEEP_CURRENT_CONFIG=trueはオプションです）：

    msiexec /i ScreenAgent-64bit-2.2.18.msi KEEP_CURRENT_CONFIG=true FRAME_PER_SECOND=5 RESOLUTION_LEVEL=high

    パラメーター

    説明

    例

    msiexec /i ScreenAgent-32bit-<MSI version>.msi

    32ビットまたは64ビット

    以下を搭載したコンピュータにインストールする場合：

    • 32ビットWindowsがインストールされている場合は、32ビットと入力します

    • 64ビットWindowsがインストールされている場合は、 64ビットと入力します

    MSIバージョン

    [サポートとダウンロード]ページからダウンロードしたインストールファイルのMSIバージョンを入力します。たとえば、「3.0.22」と入力します。

    msiexec / iScreenAgent-64ビット-3.0.22.msi

     

    msiexec /i ScreenAgent-32bit-3.0.22.msi

    KEEP_CURRENT_CONFIG

    （オプション）デフォルトでは、ScreenAgentを再インストールまたはアップグレードするときに、現在の設定を使用します。現在の構成で再インストールまたはアップグレードするを参照してください。

    falseに設定すると、ScreenAgentのインストールは既存の設定を使用しません。インストールでは、指定されたすべてのパラメータと、設定のないパラメータのデフォルト値が使用されます。

    デフォルト値はtrueです。クリーンインストールの場合、設定のないパラメータにはデフォルト値が使用されます。

    KEEP_CURRENT_CONFIG=true

    INSTALL_PATH

    （オプション）インストールパスを指定できます。インストールファイルは、指定されたインストールパスの下にある「\NICE-InContact\ScreenAgent」フォルダに保存されます。

    このパラメータを追加しない場合、KEEP_CURRENT_CONFIG=trueであっても、ScreenAgentはCドライブ上のデフォルトのインストールパスでインストールされます。

    INSTALL_PATH=d:\newdir

    ACCESS_KEY_ID

    従業員アカウントで作成されたアクセスキーIDをペーストします。アクセスキーを生成するには、ScreenAgentのアクセスキーを生成します。を参照してください。

    ACCESS_KEY_ID=ABCDEF12345====

    ACCESS_KEY_SECRET

    従業員アカウントで作成された秘密のアクセスキーをペーストする

    ACCESS_KEY_SECRET=12345ABCDEF

    REGION_TYPE

    CXone URLのサブドメイン（最初の3文字）（例：na1、na2、au1、eu1）を入力する

    REGION_TYPE=na1
    STATISTICS (オプション)デフォルトでは、この値はtrueに設定され、ScreenAgentはユーザーマシン(RAM、CPU)のデータを収集できます。

    ScreenAgentでデータを収集しない場合は、この値をfalseに変更できます。

    設定できる値は、true およびfalseです。

    インストール後、この値を変更できます。

    		 STATISTICS=true

    WEB_PROXY

    プロキシサーバーを使用してインターネットに接続している場合にのみ、このパラメータを含めます。

    覚えておいてください：

    • ホストはホスト名またはIPにすることができます

    • プロキシ設定に応じてhttpまたは httpsを使用します

    • サーバーのプロキシ設定で設定されている場合usernameそしてパスワードを使用します

    例：

    • http://server_username:server_password@host:port

    • https://server_username:server_password@host:port

    • https://host:port

    プロキシpacファイルで動作するプロキシURLを使用する場合は、プロキシURLの前にpac+という接頭辞を付けます。たとえば、プロキシURLがhttps://<プロキシサーバー>.pacの場合は、次のようにします。

    WEB_PROXY=pac+https://<proxy server>.pac

    WEB_PROXY=http://admin:pwd@168.63.76.32:3128

     

     

    WEB_PROXY=https://proxyserver:8088

     

     

     

     

     

     

     

     
    RESOLVE_USER

    （オプション）エージェントのOSログインを使用するように RESOLVE_USER=osloginを設定します。このモードでは、ScreenAgentはエージェントのOSログイン情報を使ってサーバに接続し、CXone Multi-ACD (CXone Open)、マルチセッション環境などの高度な設定を行うことができます。OSログインを使用する場合、ScreenAgentはポート31322を使用しません。

    このパラメータを追加しないと、ScreenAgentはデフォルト値のautoでインストールされ、CXoneクライアント（MAX、CXone Agentなど）がサーバーに接続することに依存します。このモードでは、ScreenAgentはポート31322を使用してCXoneクライアントに接続します。

    エージェントのOSログインは、[従業員の設定]の[一般]タブでDomain\Username形式で定義されます。

    RESOLVE_USER=oslogin
    FRAME_PER_SECOND

    （オプション）出力MP4ファイルの1秒あたりの記録フレーム数を設定できます。このパラメータを追加しない場合、ScreenAgentは、デフォルト値の毎秒5フレームでインストールされます。

    許容される値は、 1、2、3、4、または 5です。毎秒あたりのフレーム数を少なくすると、では、ファイルサイズ、帯域幅、CPU、およびRAMが削減されます。

    インストール後に、この構成は変更できます。

    FRAME_PER_SECOND=3
    RESOLUTION_LEVEL

    (オプション)記録したMP4ファイルの解像度を設定してRAMとCPUの消費を最適化できます。このパラメータを追加しない場合、ScreenAgentは、デフォルトの解像度設定null (現在の画面解像度)でインストールされます。

    許可される値は、null、低、中、または高(大文字と小文字を区別しない)です。解像度を低くすると、では、ファイルサイズ、CPU、およびRAMが削減されます。

    インストール後に、この構成は変更できます。

    RESOLUTION_LEVEL=low

    LOAD_CERTIFICATES

    （オプション）Windowsの証明書ストアから自己署名証明書にアクセスして読み込まない場合は、このパラメータをfalseに設定します。

    許容値はtrueまたはfalseです。

    このパラメータを追加しない場合、ScreenAgentはWindows証明書ストアから自己署名証明書にアクセスします。

    インストール後に、この構成は変更できます。

    LOAD_CERTIFICATES=false

    /log install.log

    インストール結果をログファイルに出力します。

    /log install.log

    /quiet

    （オプション）インストール時にポップアップを抑制したい場合に含めます。インストール結果をログファイルで確認できます。

    /quiet

  3. ログファイルからインストールの成功を確認します。install.logファイルは、MSIをインストールしたフォルダーにあります。これは通常、%UserProfile%\downloadsフォルダーです。

    • インストーラーに管理者権限があることを確認します。

    • エージェントのコンピューターにMicrosoft.NET Framework 4.0以降がインストールされていない場合は、インストールします。

    設定ファイル(configFile.ini)は、インストール後に自動的に非表示になります。ファイルを表示して開くには、Windowsファイルエクスプローラーで[隠しファイル]を有効にします。

  4. エージェントにレコード可能(画面)属性があることを確認してください(CXoneで[管理] > [従業員]に移動し、エージェントをクリックします)。この属性は、画面録画、画面監視、またはその両方を有効にするために必要です。

  5. 通話を録音し、ScreenAgentログファイルを確認します。ScreenAgent.logファイルは、%appdata%\ScreenAgent\logs\ScreenAgent.logにあります。

    ScreenAgentのログも、必要に応じてNICE CXoneサポートチームがアクセスできるクラウドに自動的にアップロードされます。

    エラーが発生した場合は、録音のトラブルシューティングを参照してください。

ScreenAgentを使用し、リアルタイムの画面監視によるエージェントとのインタラクション改善の概要を説明するビデオを見ることができます。

拒否リスト用のGoogleChromeレジストリキー構成

エージェントのマシンでGoogle Chromeブラウザーを使用する際、UiAutomationProviderEnabledの値がGoogle Chromeレジストリキーに存在しないと、拒否リストに指定されたURLがレコーディングから除外されない可能性があります。画面録画拒否リストの管理を参照してください。

レジストリキーに値を追加するには：

  1. エージェントのマシンがChromeブラウザー126以降を使用していることを確認してください。

  2. Windowsの管理者権限を持っていることを確認してください。

  3. HKLM:◆SOFTWARE◆Policies◆Google◆Chrome◆レジストリパスが存在することを確認してください。

  4. 以下のPowershellスクリプトを実行し、Google Chromeのレジストリに値を追加します：

    Set-ItemProperty -Path "HKLM:¥SOFTWARE¥Policies¥GoogleChrome" -Name "UiAutomationProviderEnabled" -Value 1 -Type DWord

ScreenAgent構成の変更

インストール後、一部のScreenAgent設定を変更できます。

設定ファイル(configFile.ini)は、インストール後に自動的に非表示になります。ファイルを表示して開くには、Windowsファイルエクスプローラーで[隠しファイル]を有効にします。

  1. ScreenAgentインストールフォルダ内のconfigFile.iniファイル（通常はC:\Program Files\NICE-InContact\ScreenAgent）を開きます。

  2. パラメータ値を編集する：

    • [recordingParameters]セクションのframePerSecond値を変更します。デフォルトでは、この値は5です。

      許容される値は、 1、2、3、4、または 5です。

      毎秒あたりのフレーム数を少なくすると、ファイルサイズ、CPU、およびRAMが削減されます。

      毎秒あたりのフレーム数 フレーム数の削減 ファイルサイズ/帯域幅、CPU、およびRAMへの影響(推定)

      5

      デフォルト(最大)

      なし

      4

      20%削減

      約15%削減

      3

      40%削減

      約30%削減

      2

      60%削減

      約45%削減

      1

      80%削減

      約60%削減

    • [recordingParameters]セクションのresolutionLevel値を変更します。デフォルトでは、この値は、null (現在の画面解像度)です。

      許可される値は、null、低、中、または高(大文字と小文字を区別しない)です。

      解像度を低くすると、ファイルサイズ、CPU、およびRAMが削減されます。

      解像度 解像度の低下 ファイルサイズ/帯域幅、CPUおよびRAMへの影響(推定)

      Null

      デフォルト(現在の画面解像度)

      なし

      高

      画面解像度 / 1.5

      約20%削減

      中

      画面解像度 / 2

      約40%削減

      低

      画面解像度 / 4

      約60%削減(4K画面にのみ推奨されます)

      画面の解像度にリセットするには、resolutionLevel値をnullに変更します。

    • [others]セクションのloadCertificates値を変更します。デフォルトでは、この値はtrueです。

      許容値はtrueまたはfalseです。

  3. configFile.iniファイルを保存します。

  4. 変更を適用するには、ScreenAgentアプリケーションを再起動します。

    1. Windowsタスクマネージャーで、現在のScreenAgentWatchDog.exeタスクを終了してから、ScreenAgent.exeプロセスを終了します。

    2. ScreenAgentインストールフォルダから、ScreenAgentWatchdog.exeを実行します。

ScreenAgent接続の確認

ScreenAgent接続性チェックツールを使用して一連のテストを実行し、ネットワークアクセスをチェックして、ScreenAgentが正しく機能することを確認します。

  • ツールは、ScreenAgentのインストールする前または後に使用できます。

  • 最新バージョンの接続性チェックツールは、[ダウンロード]ページからダウンロードできます。

  • エージェントのネットワーク構成が変更された場合や、通常の構成と異なる場合は、このツールを使用することをお勧めします。すべてのエージェントに対してツールを実行する必要はありません。

  • 接続性チェックツールは、同じコマンドを使用して複数回実行できます。

  • 各テストの実行後、成功または失敗の通知が表示されます。実行の終了時に、サマリーに各テストのステータスが表示されます。

  • テストを完了した後、接続性ツールによってログファイルが作成されます。

  • 現在、接続性チェックツールには、リアルタイム画面モニタリングのネットワーキングをチェックするテストは含まれていません。

  1. 接続チェックツールのEXEファイルをダウンロードします。

    1. CXoneに移動し、サポートダウンロードにアクセス可能権限を持つユーザーとしてログインします。

    2. ユーザー名をクリックしてサポートとダウンロードを選択します。

    3. 必要なEXEファイルをダウンロードします。EXEファイルをダウンロードする場所に注意してください。ファイルの場所は後で必要になります。

  2. 接続チェックツールを実行します。

    1. 管理者としてコマンドプロンプトを実行します。

    2. コマンドをコピーしてコマンドプロンプトに貼り付け、表にリストされているパラメータを編集します。

      <exeファイルへのパス> ACCESS_KEY_ID=<アクセスキーID> ACCESS_KEY_SECRET=<シークレットアクセスキー> REGION_TYPE=<CXone URLのサブドメイン（最初3文字）> WEB_PROXY=<オプション：プロキシサーバーのURL>

      パラメーター

      説明

      例

      path to exe file

      ダウンロードしたEXEファイルの場所。

      C:%UserProfile%\downloads

      ACCESS_KEY_ID

      従業員アカウントで作成されたアクセスキーIDをペーストします。アクセスキーを生成するには、ScreenAgentのアクセスキーを生成します。を参照してください。

      ACCESS_KEY_ID=ABCDEF12345====

      ACCESS_KEY_SECRET

      従業員アカウントで作成された秘密のアクセスキーをペーストする

      ACCESS_KEY_SECRET=12345ABCDEF

      REGION_TYPE

      CXone URLのサブドメイン（最初の3文字）（例：na1、na2、au1、eu1）を入力する

      REGION_TYPE=na1

      WEB_PROXY

      プロキシサーバーを使用してインターネットに接続している場合にのみ、このパラメータを含めます。

      • ホストはホスト名またはIPにすることができます

      • プロキシ設定に応じてhttpまたは httpsを使用します

      • サーバーのプロキシ設定で設定されている場合usernameそしてパスワードを使用します

      WEB_PROXY=http://admin:pwd@168.63.76.32:3128

      WEB_PROXY=https://proxyserver:8088

       

    コマンド例：

    C:%UserProfile%\downloads ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1 WEB_PROXY=https://proxyserver:8088

  3. 接続性チェックツールがテストを開始します。各テストの実行後、成功または失敗の通知が表示されます。テストが失敗した場合は、失敗の理由が表示されます。実行の終了時に、各テストが合格、不合格、または実行する必要がなかった（N/A） かどうかのサマリが表示されます。たとえば、ScreenAgentが接続チェックツールの起動時にバックグラウンドで実行されていなかった場合、ScreenAgentを閉じて再起動するテストは実行する必要はありません。

    テストが完了すると、接続性チェックツールは、接続性チェックツールのインストールファイルと同じフォルダにログファイル(SA_Connectivity_tool_log_<runUniqueUUID>)を作成します。ログファイルには、コマンドプロンプトで表示されたすべての情報が含まれています。

接続性テスト

テスト

説明
ScreenAgentを閉じる ScreenAgentがバックグラウンドで実行されている場合は、ScreenAgent（ScreenAgent.exeおよびScreenAgentWatchdog.exe） を閉じます。これにより、接続ツールのテストが中断されることはありません。
ポート31322の確認 ポート31322との通信をテストします。
トークンの取得 トークンを取得するためにテストします。
更新トークンの取得 更新トークンを取得するためにテストします。
通知サービスからログバケットのSTSクレデンシャルの受信 通知サービスWebソケットからメッセージを送受信するテスト。
通知サービスからメディアバケットのSTSクレデンシャルの受信 通知サービスWebソケットからメッセージを送受信するテスト。
S3ログバケットへの接続ツール実行のアップロードログ S3ログバケットへのアップロードをテストします。
S3メディアバケットへのファイルのアップロード S3メディアバケットへのアップロードをテストします。
ScreenAgentの起動 以前に閉じていた場合は、ScreenAgent（ScreenAgent.exeおよびScreenAgentWatchdog.exe）を再起動します。
ポート31322でサーバを停止 ポート31322との通信テストに使用したテストサーバーを停止します。