Citrix Gateway

VPN ユーザー用のユーザーポータルをカスタマイズする

VPNユーザーにポータルを提供するCitrix Gateway インストールには、ポータルテーマを選択して、ポータルページのカスタマイズされたルックアンドフィールを作成するオプションが含まれています。提供されているテーマのセットから選択することも、テーマをテンプレートとして使用して、カスタマイズまたはブランド設定されたポータルを構築することもできます。構成ユーティリティーを使用して、新しいロゴ、背景画像、カスタム入力ボックスラベル、および CSS ベースのポータル・デザインのその他のさまざまな属性を追加して、テーマを変更できます。組み込みのポータルテーマには、英語、フランス語、スペイン語、ドイツ語、日本語の 5 つの言語のコンテンツが含まれています。Web ブラウザーによって報告されるロケールに応じて、異なるユーザーが異なる言語で表示されます。

VPN ユーザーがサインインを許可される前に VPN ユーザーに提示されるカスタム EULA を作成できます。EULA 機能は、ロケール固有のバージョンの EULA をサポートします。これは、Web ブラウザーで報告されたロケールに基づいてユーザーに提示されます。

ポータル・テーマと EULA 構成はどちらも、VPN 仮想サーバーと VPN グローバル・レベルで個別にバインドできます。

重要:

Citrix は、コードの変更が必要なカスタマイズをサポートしていません。また、デフォルトのテーマに戻す以外の問題を解決するためのサポートも提供していません。

ポータル・テーマの適用

リリース 13.0 ビルド 67.43 以降、VPN ポータルはデフォルトで rfWebUI テーマを使用するように設定されます。以前は、 Caxton theme がデフォルトのテーマでした。緑の吹き出しと X1 のテーマを適用することもできます。

rfWebUi テーマ

キャクストンのテーマ

![Caxton テーマ] (/en-us/citrix-gateway/media/caxton-theme.png)

グリーンバブルのテーマ

グリーンバブルのテーマ

X1のテーマ

X1のテーマ

提供されているテーマは、VPN 仮想サーバーに直接適用することも、グローバル VPN バインディングとして適用することもできます。

ポータル・テーマを VPN 仮想サーバーにバインドする

ポータル・テーマは、既存の仮想サーバー上にバインドすることも、新しい仮想サーバーを作成する場合にもバインドできます。

CLI を使用してポータル・テーマを VPN 仮想サーバーにバインドする

コマンドプロンプトで次を入力します。

bind vpn vserver <name> - portaltheme <name>
<!--NeedCopy-->

GUI を使用してポータル・テーマを VPN 仮想サーバーにバインドする

  1. 構成 ]タブで、[ Citrix Gateway ]に移動し、[ 仮想サーバー]をクリックします。
  2. 仮想サーバーを選択し、[ 編集] をクリックします。
  3. ポータル・テーマがまだ仮想サーバーにバインドされていない場合は、詳細ウィンドウの [ 詳細設定 ] の下にある [ ポータル・テーマ ] をクリックします。それ以外の場合、[ ポータルのテーマ] オプションは詳細ウィンドウですでに展開されています。
  4. 詳細ウィンドウの [ ポータル・テーマ] で、[ポータル・テーマなし] をクリックして [ポータル・テーマのバインド] ウィンドウを展開します。
  5. Click クリックして選択します
  6. [ ポータルのテーマ ] ウィンドウで、テーマ名をクリックし、[ 選択] をクリックします。
  7. [バインド] をクリックします。
  8. [完了] をクリックします。

VPN 仮想サーバーを作成する場合は、[VPN 仮想サーバー] 編集ペインで手順 3 から始まる前の手順の手順に従って、ポータル・テーマをバインドできます。

ポータル・テーマを VPN グローバルにバインドする

CLI を使用してポータルテーマを VPN グローバルにバインドする

コマンドプロンプトで、; と入力します。

bind vpn global portaltheme <name>
<!--NeedCopy-->

GUI を使用してポータルテーマを VPN グローバルにバインドする

  1. 構成 ]タブで、[ Citrix Gateway]に移動します。
  2. メインの詳細ペインで、[ Citrix Gateway ポリシーマネージャー]をクリックします。
  3. +」アイコンをクリックします。
  4. バインドポイント 」リストで、「 リソース」を選択します。
  5. [接続タイプ] リストで、[ポータルのテーマ] を選択します。
  6. [続行] をクリックします。
  7. バインドポイント」画面で、「 バインドを追加」をクリックします。
  8. [ クリックして選択] をクリックします。
  9. [ ポータルのテーマ ] ウィンドウで、テーマ名をクリックし、[ 選択] をクリックします。
  10. [バインド] をクリックします。
  11. [ 閉じる] をクリックします。
  12. [ 完了] をクリックします。

ヒント:

変更を行った後、コマンドラインで ‘save ns config’コマンドを使用するか、構成ユーティリティの保存アイコンをクリックして、変更がCitrix ADC構成ファイルに保存されていることを確認します。

ポータル・テーマの作成

カスタム・ポータル・デザインを作成するには、提供されているポータル・テーマの 1 つをテンプレートとして使用します。選択したテンプレートテーマのコピーが、指定した名前で作成されます。

ストックポータル・テーマをカスタム・ポータル・テーマのテンプレートとして使用する

ポータル・テーマを作成するには、構成ユーティリティまたはコマンドラインを使用してテーマ・エンティティを作成します。ただし、詳細なカスタマイズコントロールは、構成ユーティリティ内でのみ使用できます。

CLI を使用したポータル・テーマの作成

コマンドプロンプトで、; と入力します。

add portaltheme <name> basetheme <name>
<!--NeedCopy-->

GUI を使用したポータル・テーマの作成

  1. 構成 ]タブで、[ Citrix Gateway] に移動し、[ ポータルのテーマ]をクリックします。
  2. メインの詳細ペインで、[ 追加] をクリックします。
  3. テーマの名前を入力し、テンプレートリストからテンプレートを選択して、 「OK」をクリックします。
  4. この時点で、ポータル・テーマの編集ウィンドウが初めて表示されます。[OK] をクリックして終了します。

初回表示で新しいポータル・テーマのカスタマイズに進むことができます。

新しいテーマを作成したら、それを VPN 仮想サーバーまたは VPN グローバルにバインドできます。新しいテーマは、作成直後またはカスタマイズの完了後にバインドできます。

ポータル・テーマのカスタマイズ

ポータル・テーマをカスタマイズするには、構成ユーティリティーの Portal Theme インターフェースを使用します。最良の結果を得るには、このインターフェイスのさまざまな要素を理解してから使用する必要があります。

ポータル・テーマ・インターフェースについて

Citrix Gateway 構成ユーティリティでポータルのテーマインターフェイスを開くには 、[ 構成 ]タブで[ Citrix Gateway ]に移動し、[ ポータルのテーマ]をクリックします。 ポータル・テーマの作成の説明に従ってテーマを作成するか、 メインの詳細ペインで既存のテーマを選択して [ 編集] をクリックします。

ポータル・テーマのカスタマイズ・ページには、ポータル・デザインを変更するための 4 つの主要コンポーネント・ペイン、「 ポータル・テーマ 」ペイン、「ルック・アンド・フィール」ペイン、「 詳細設定 」ペイン、および「 言語 」ペインがあります。

ポータル・テーマ・インターフェース

ページ上部の [ Portal Theme] ペインには、編集用にロードされているテーマと、そのベースになっているテンプレートテーマが表示されます。この表示オプションを使用すると、ユーザ接続で VPN にアクセスしなくても、カスタマイズ内容を表示できます。表示オプションを使用するには、テーマを VPN 仮想サーバーにバインドする必要があり、バインディングは表示ウィンドウを閉じた後も有効です。

ページの中央にある [ Look & Feel ] ペインを使用して、ヘッダー、背景色とイメージ、フォントプロパティ、ロゴなど、テーマの一般的なプロパティを構成します。このウィンドウが編集モードの場合、属性の凡例を使用して、ポータルページでのルックアンドフィール属性の使用場所に関するガイダンスとして使用できます。

[ 詳細設定 ] ペインには、個々のポータルページの画面上のコンテンツコントロールが含まれています。ページのコンテンツを編集用に読み込むには、一覧表示されたページの 1 つをクリックします。ページコントロールは、他の中央ペインの下に開きます。ページが変更されていない限り、ポータル・テーマの編集全体にわたって [ 詳細設定 ] ペインでページが折りたたまれたままになります。

[ 言語 ] ペインでは、[ 詳細設定 ] ペインで編集対象としてページを選択したときにロードされる言語を選択できます。デフォルトでは、英語のページが読み込まれます。

カスタマイズ可能なページ属性のタイプ

ポータル・テーマをカスタマイズする場合、ポータル・テーマ・インターフェースで属性の範囲を変更できます。編集可能なテキストとサポートされている言語に加えて、ポータルのレイアウトのグラフィカル要素をニーズに合わせて調整できます。各ページ要素タイプには、変更する前に考慮すべきパラメータまたは推奨事項があります。

[色]

ポータルのデザインは、ページの背景、ハイライト、タイトルと本文コンテンツのテキスト、ボタンコントロール、ホバー応答などの属性の色を指定します。カラー属性をカスタマイズするには、選択したアイテムのカラー値を直接入力するか、付属のカラーピッカーを使用してカラー値を生成します。このインターフェイスでは、有効な HTML カラー値を RGBA フォーマット、HTML 16 進トリプレットフォーマット、および X11 カラー名で入力できます。カラーピッカーは、属性の入力フィールドの横にあるカラーボックスをクリックすると、適用可能な任意のカラー属性でアクセスできます。

カラーピッカー

フォント

フォントの色に加えて、一部のページ属性のフォントサイズを変更できます。これらの各属性について、ポータルの設計によって決定されるように、各属性で使用できるサイズがメニューに表示されます。

画像

画像の場合、各コントロールで使用できるポップアップの説明に、推奨サイズおよびその他の要件が示されます。説明は、ページ上の属性の位置とその機能によって異なります。PNG または JPEG のイメージファイル形式を使用できます。アップロードするイメージを選択するには、アイテムのファイル名の下にあるチェックボックスをオンにし、ローカルコンピュータのドライブ上のイメージの場所を参照します。

ラベル

[ 詳細設定]セクションでは、変更する特定のポータルページのテキストを選択できます。ページのデフォルトの英語テキストを変更しても、他の言語のテキストは再翻訳されません。代替言語のページコンテンツは便宜上提供されていますが、カスタマイズを行う場合は手動で更新する必要があります。ページの別の言語バージョンを編集するには、開いているポータルページの [ X ] アイコンをクリックして、ウィンドウが開いている場合は、まずウィンドウを折りたたみます。次に、[言語]ペインで言語を選択し、[OK]をクリックします。[ 詳細設定 ] ウィンドウから開いたすべてのポータルページは、別の言語を選択するまでその言語で表示されます。

重要

高可用性展開またはクラスター展開では、ポータルテーマがプライマリまたは構成コーディネーターのCitrix ADCエンティティでそれぞれ作成された場合にのみ、共有構成全体にポータルテーマが分散されます。

古いポータルのカスタマイズ

リリース11.0より前のCitrix Gateway またはAccess Gateway で作成されたカスタムポータル設計を手動で変更してインストールする場合は、カスタマイズインターフェイスで新しいポータルテーマから開始することを強くお勧めします。それができない場合は、カスタマイズを手動で適用できますが、そのための直接的なサポートは提供されません。

手動でカスタマイズしたポータルを使用する場合は、カスタマイズしたポータルをグローバルポータル構成として設定する必要があります。ただし、そうすると、適用されたグローバルポータル構成を VPN 仮想サーバー・レベルのポータル・テーマ・バインディングで上書きすることはできません 。この場合、構成ユーティリティまたはコマンドラインを使用して VPN 仮想サーバーバインディングを作成しようとすると、エラーが返されます。

また、高可用性およびクラスタ構成の場合、Citrix ADCファイルシステム上の基礎となるファイルは自動共有構成で配布されないため、展開内のすべてのノードで手動カスタマイズを実行する必要があります。

カスタムポータル構成を手動で作成する

Citrix Gateway 11.0へのアップグレード後に古いカスタマイズされたポータル構成を手動で適用するには、既存のポータルページのコピーを変更し、カスタマイズされたポータルファイルをCitrix ADCファイルシステムに配置し、 **UITHEMEパラメーターとしてCUSTOMを選択する必要があります** 。

WinSCPまたはその他のセキュアコピープログラムを使用して、Citrix ADCファイルシステムにファイルを転送できます。

  1. Citrix Gateway コマンドラインにログオンします。
  2. コマンドプロンプトでshellと入力します。
  3. コマンドプロンプトで、 mkdir /var/ns_gui_custom; cd /netscaler; tar-cvzf /var/ns_gui_custom/customtheme.tar.gz ns_gui/* と入力します。
  4. コマンドプロンプトで、 cd /var/netscaler/ログオン/テーマ/と入力します。
    • 緑の泡のテーマをカスタマイズする場合は、cp-r Greenbubble Custom と入力して、緑の泡のテーマのコピーを作成します。
    • 既定のテーマ (Caxton) をカスタマイズする場合は、 cp-r 既定のカスタムと入力します。
    • X1 テーマをカスタマイズするには、cp-r X1 カスタムと入力します。
  5. **/var/netScaler/Logon/Themes/Custom** の下にコピーしたファイルに必要な変更を加えて、テーマを手動でカスタマイズします。
    • css/base.cssに必要な編集を行います。
    • カスタムイメージを /var/ns_gui_custom/ns_gui/vpn/media ディレクトリにコピーします。
    • resources/ ディレクトリにあるファイルのラベルを変更します。これらのファイルは、ポータルでサポートされるロケールに対応しています。
    • HTML ページまたは JavaScript ファイルへの変更も必要な場合は、 /var/ns_gui_custom/ns_gui/内のファイルに関連するものを作成できます。
  6. すべてのカスタマイズの変更が完了したら、プロンプトで次のように入力します。 tar —cvzf /var/ns_gui_custom/customtheme.tar.gz /var/ns_gui_custom/ns_gui/*

重要

前の手順でテーマディレクトリをコピーする場合、Citrix ADCシェルインターフェイスではディレクトリ名の大文字と小文字が区別されるため、コピーしたフォルダー名は「カスタム」と正確に入力する必要があります。ディレクトリ名を正確に入力しないと、 UITHEME 設定が CUSTOMに設定されているときにフォルダは認識されません。

カスタマイズしたテーマを VPN グローバルパラメータとして選択します

手動でカスタマイズされたポータル構成が完了し、Citrix ADCファイルシステムにコピーされたら、Citrix Gateway 構成に適用する必要があります。これは、UITHEME パラメーターを CUSTOM に設定することで実行され、コマンドラインまたは構成ユーティリティで完了できます。

コマンドラインを使用するには、次のコマンドを入力して UIPHEME パラメーターを設定します。

set vpn parameter UITHEME CUSTOM
<!--NeedCopy-->

構成ユーティリティを使用して UITHEME パラメーターを設定するには、以下の手順に従います。

  1. 構成 ]タブで、[ Citrix Gateway]>[グローバル設定]に移動します。
  2. [ グローバル設定の変更] をクリックします。
  3. [ クライアントエクスペリエンス ] タブをクリックします。
  4. 画面の下部までスクロールし、[ UI テーマ ] リストメニューから [ カスタム ] を選択します。
  5. [OK] をクリックします。

手動でカスタマイズしたポータルが、VPN ユーザーに提示されるポータル設計になりました。

EULA を作成する

VPN ポータルシステムには、ポータル構成に EULA を適用するオプションが用意されています。EULAがVPNグローバルスコープまたは関連するVPN仮想サーバーのいずれかでCitrix Gateway構成にバインドされると、VPNユーザーはVPNへの認証を許可される前に、利用規約としてのEULAに同意する必要があります。

ポータルのテーマと同様に、ユーザーには、Web ブラウザーによって報告されるロケールに基づいて、言語固有の EULA が提供されます。ロケールがサポートされている言語のいずれとも一致しない場合、提供されるデフォルトの言語は英語です。EULA ごとに、サポートされている各言語でカスタムメッセージを入力できます。翻訳済みのコンテンツは、ポータル・テーマのような EULA 構成には提供されません。ユーザーの報告されたロケールが、EULA コンテンツが入力されていない言語と一致する場合、ユーザーは VPN ログインページの [利用規約] リンクをクリックすると、空白のページが返されます。

EULAを作成するには、構成ユーティリティの[ 構成 ]タブの[Citrix Gateway] >[グローバル設定]>[EULA]または[Citrix Gateway][リソース]>[EULA]のいずれかのコントロールを使用できます。[ Global Settings ] ペインのコントロールは、VPN グローバル EULA バインディングの管理に使用され、[ リソース] > [EULA ] ノードのコントロールは、EULA 設定に関する一般的な操作に使用されます。VPN仮想サーバーのEULAバインディングを管理するには、[Citrix Gateway]>[仮想サーバー]でVPN仮想サーバーを編集します。一部のコマンドは、EULA エンティティを管理するためのコマンドラインでも使用できます。ただし、完全な EULA 管理コントロールは、構成ユーティリティでのみ使用できます。

CLI を使用して EULA エンティティを作成する

コマンドプロンプトで次を入力します。

add vpn eula <name>
<!--NeedCopy-->

GUI を使用して EULA エンティティを作成する

  1. Citrix Gateway >[リソース]>[EULA]に移動します
  2. [ 追加 ] をクリックして、エンティティを作成します。
  3. エンティティの名前を入力します。
  4. 各言語について、関連するタブの下にコンテンツを貼り付けます。プレーンテキストまたは HTML タグを使用して、 改行を追加する<br>タグを含め、コンテンツの書式を設定することができます。
  5. [作成] をクリックします。

EULA エンティティが作成されると、VPN 設定にグローバルにバインドすることも、VPN 仮想サーバーにバインドすることもできます。

CLI を使用して EULA を VPN グローバルにバインドする

コマンドプロンプトで、; と入力します。

bind vpn global eula <name>
<!--NeedCopy-->

GUI を使用して EULA を VPN グローバルにバインドする

  1. 構成 ]タブで、[ Citrix Gateway]>[グローバル設定]に移動します。
  2. メインの詳細ウィンドウで、[ エンドユーザー使用許諾契約書の構成] をクリックします。
  3. [バインドを追加]をクリックします。
  4. [ クリックして選択] をクリックします。
  5. EULA エンティティを選択し、[ 選択] をクリックします。
  6. [バインド] をクリックします。
  7. [ 閉じる] をクリックします。

CLI を使用して EULA を VPN 仮想サーバーにバインドする

コマンドプロンプトで、; と入力します。

bind vpn vserver <name> eula <name>
<!--NeedCopy-->

GUI を使用して EULA を VPN 仮想サーバーにバインドする

  1. 構成 ]タブで、[ Citrix Gateway]>[仮想サーバー]の順に選択します。
  2. メインの詳細ペインで、VPN 仮想サーバーを選択し、[ 編集] をクリックします。
  3. ページの右側にある [ 詳細設定 ] ペインで、[ EULA] をクリックします。
  4. 新しく追加された EULA ペインで、[ EULA なし] をクリックします。
  5. Click クリックして選択します
  6. EULA エンティティを選択し、[ 選択] をクリックします。
  7. [バインド] をクリックします。
  8. [完了] をクリックします。