Citrix Workspace app for Windows

プラグイン管理

Citrix Workspaceアプリ for Windowsは、Secure Access AgentやEnd Point Analysis (EPA) プラグインなどのエージェントをエンドポイントにインストールおよび管理するために必要とされる単一のクライアントアプリとなるプラグイン管理機能を提供します。

  • この機能により、管理者は単一の管理コンソールから必要なエージェントを簡単に展開および管理できます。

  • プラグイン管理には次のステップが含まれます。

  • 管理者は、エンドユーザーのデバイスに必要なエージェントをGlobal App Configuration Serviceで指定する必要があります。管理者はSecure Access AgentおよびEndpoint Analysis (EPA) エージェントを指定できます。
  • Citrix Workspaceアプリは、Global App Configuration Serviceからエージェントのリストを取得します。
  • Global App Configuration Serviceから取得したリストに基づいて、Citrix Workspaceアプリは自動更新サービスを通じてエージェントパッケージをダウンロードします。エージェントがエンドポイントに以前インストールされていない場合、Citrix Workspaceアプリはエージェントのインストールをトリガーします。エージェントがすでにインストールされている場合、Citrix Workspaceアプリはエージェントの更新をトリガーします(ダウンロードされたエージェントのバージョンがインストールされているバージョンよりも新しい場合)。

Citrix Workspaceアプリは、将来的に更新が利用可能になった場合、エージェントを自動的に更新することを保証します。

Citrix Workspaceアプリは、Citrix Workspaceの資格情報を使用してエージェントに自動的にサインインします。

注:

  • EPAおよびZTNAプラグインが存在しない場合、ストアまたはアカウントを初めて追加する際にプラグインがダウンロードおよびインストールされます。
  • ストアまたはアカウントとプラグインがすでに存在し、インストーラーに新しいバージョンが含まれている場合、プラグインは自動更新サイクル中に更新されます。

次の図はワークフローを示しています。

  • プラグイン管理

重要:

プラグイン管理機能を有効にするには、Global App Configuration Serviceが必要です。

  • クラウドストアの場合、Global App Configuration Service UIは、Citrix Cloud管理ポータルのWorkspace Configurationセクションでアクセスできます。詳細については、「Citrix Workspaceアプリの構成」を参照してください。
  • オンプレミスストアをオンボードする場合、またはクラウドストアのメールベースの検出を設定する必要があるお客様は、「Global App Configuration Service」ドキュメントを参照してください。

プラグイン管理機能は、次の方法を使用して有効にできます。

  • Global App Configuration Service UIを使用する - この方法を使用して、クライアントの最新バージョンを展開します。
  • Global App Configuration Service APIを使用する - この方法を使用して、バージョン、展開モード、自動更新間隔などを制御するパラメーターでインストールをカスタマイズします。

Global App Configuration Service UIを使用したプラグイン管理の有効化

この方法はクラウドストアのみに適用され、管理者はUIを使用してエージェント(EPA / Secure Access、Zoomプラグイン、またはWebExプラグイン)を展開できます。

  1. Citrix Cloudにサインインします。
  2. 画面左上のメニューから、Workspace Configurationを選択します。 Workspace Configuration Workspace Configurationページが表示されます。 Workspace Configurationページ
  3. App Configurationタブをクリックします。
  4. Updatesをクリックします。
  5. Windowsチェックボックスが選択されていることを確認します。
  6. Windowsの横にあるClient App Management Agent Settingsドロップダウンリストから、必要なエージェントを選択します。

    更新

Global App Configuration Service APIを使用したプラグイン管理の有効化

  1. APIを使用して、Global App Configuration Serviceで設定を構成およびオンボードします。詳細については、「サービスURLのマッピングと設定の構成」を参照してください。
  2. ストア/アカウントでEPAおよびZTNA/Secure Accessクライアントをオンボードするには、次のGlobal App Configuration設定をオンボードする必要があります。
{
    "serviceURL":
    {
        "url": "https://storefront.acme.com:443"
    },
    "settings":
    {
        "description": "Install and update plugins",
        "name": "Install and update plugins",
        "useForAppConfig": true,
        "appSettings":
        {
            "windows":
            [
                {
                    "assignedTo":
                    [
                        "AllUsersNoAuthentication"
                    ],
                    "category": "AutoUpdate",
                    "settings":
                    [
                        {
                            "name": "Auto Update plugins settings",
                            "value":
                            [
                                {
                                    "pluginId": "8A8AF6C0-11F6-4343-BA2D-A85A766170D4",
                                    "pluginName": "Citrix EPA Client",
                                    "pluginSettings":
                                    {
                                        "delayGroup": "Fast",
                                        "deploymentMode": "InstallAndUpdate",
                                        "detectRule": "UpgradeCode:{37A181F7-870E-4BDF-B0EA-E3B4766119FE}",
                                        "isBlocking": true,
                                        "isFTU": true,
                                        "maximumAllowedVersion": "23.8.1.24",
                                        "minimumAllowedVersion": "0.0.0.0",
                                        "stream": "Current",
                                        "upgradeToLatest": true
                                    }
                                },
                                {
                                    "pluginId": "9A8AF6C0-11F6-4343-BA2D-A85A766170D5",
                                    "pluginName": "Citrix Secure Access Client",
                                    "pluginSettings":
                                    {
                                        "delayGroup": "Fast",
                                        "deploymentMode": "InstallAndUpdate",
                                        "detectRule": "UpgradeCode:{F0ED53AB-11BE-4E9C-87E5-CD4A81DA2A4D}",
                                        "isBlocking": false,
                                        "isFTU": true,
                                        "maximumAllowedVersion": "21.8.0.0",
                                        "minimumAllowedVersion": "0.0.0.0",
                                        "stream": "Current",
                                        "upgradeToLatest": true
                                    }
                                },
                                {
                                    "pluginId": "C03BAE37-F3AC-4D63-8BC1-3C9CD2BC9E8D",
                                    "pluginName": "WebEx VDI AutoUpgrade Plugin",
                                    "pluginSettings":
                                    {
                                        "delayGroup": "Fast",
                                        "deploymentMode": "InstallAndUpdate",
                                        "detectRule": "UpgradeCode:{AA2AACDC-D30B-433F-A602-3E25975010A6}",
                                        "isBlocking": false,
                                        "isFTU": false,
                                        "maximumAllowedVersion": "3.1.0.24263",
                                        "minimumAllowedVersion": "0.0.0",
                                        "stream": "Current",
                                        "upgradeToLatest": true
                                    }
                                }
                            ]
                        }
                    ],
                    "userOverride": false
                }
            ]
        }
    }
}

<!--NeedCopy-->

次の表に、プラグイン管理設定のスキーマ、値、および説明を示します。

スキーマ設定 説明
isBlocking True or False isBlockingパラメーターがtrueに設定されている場合、プラグインは必須と見なされ、サインインページは必要なプラグインがインストールされている場合にのみ表示されます。Citrixは、EPAを必須プラグインとして設定することを推奨します。
pluginName プラグインのフレンドリ名。pluginNameは変更できます。
pluginId   プラグインのIDであり、変更してはなりません。
delayGroup Fast, Medium, Slow プラグインを更新する必要がある自動更新間隔。
deploymentMode InstallAndUpdate/Update InstallAndUpdate:プラグインは新規インストールされ、新しいバージョンに更新できます。Update:更新のみが許可され、新規インストールはできません。
None このプラグインにはアクションは不要です。
detectRule Value must not be modified. プラグインがすでにインストールされているかどうかを確認します。
maximumAllowedVersion   プラグインの最大許容バージョン。
minimumAllowedVersion   プラグインの最小許容バージョン。
upgradeToLatest True or False maximumAllowedVersionおよびminimumAllowedVersionをサポートするにはfalseに設定する必要があります。True:更新中にプラグインの最新バージョンが考慮されます。
Stream Current プラグインのインストールまたは自動更新を受信するには、Currentに設定する必要があります。

ユーザーワークフロー

  1. Citrix Workspaceアプリ for Windowsをダウンロードしてインストールします。
  2. インストール完了時にAdd Accountをクリックします。
  3. アプリ構成設定がオンボードされているストア/アカウントを追加します。

    必須プラグインのインストール中に、次のメッセージが表示されます。

    インストール保留中

  4. インストールが完了すると、次のトースト通知が表示されます。

    プラグイン管理の成功

  5. インストールされているプラグインを確認するには、Know moreをクリックします。

    詳細

Zoomプラグインのプラグイン管理

Zoomプラグインのダウンロード、インストール、および自動更新もサポートされており、EPAおよびZTNAプラグインと同様に処理されます。

この機能を活用するために、ストア/アカウントで次のGlobal App Configuration設定をオンボードする必要があります。


{
    "serviceURL":
    {
        "url": "https://storefront.acme.com:443"
    },
    "settings":
    {
        "description": "Install and update plugins",
        "name": "Install and update plugins",
        "useForAppConfig": true,
        "appSettings":
        {
            "windows":
            [
                {
                    "assignedTo":
                    [
                        "AllUsersNoAuthentication"
                    ],
                    "category": "AutoUpdate",
                    "settings":
                    [
                        {
                            "name": "Auto Update plugins settings",
                            "value":
                            [
                                {
                                    "pluginId": "1A4BB471-022C-4C87-BDCD-0B64FB42869C",
                                    "pluginName": "Zoom VDI AutoUpgrade Plugin",
                                    "pluginSettings":
                                    {
                                        "delayGroup": "Fast",
                                        "deploymentMode": "InstallAndUpdate",
                                        "detectRule": "UpgradeCode:{34225638-14F3-4059-BE34-175AC9B35435}",
                                        "isBlocking": false,
                                        "isFTU": false,
                                        "maximumAllowedVersion": "5.11.2872",
                                        "minimumAllowedVersion": "0.0.0",
                                        "stream": "Current",
                                        "upgradeToLatest": true
                                    }
                                }
                            ]
                        }
                    ],
                    "userOverride": false
                }
            ]
        }
    }
}

<!--NeedCopy-->
プラグイン管理