ファイルのインポートとエクスポート
GUI またはコマンドラインを使用して、HTML または XML エラーオブジェクト、XML スキーマ、DTD、および WSDL を Web App Firewall にインポートできます。これらのファイルは、インポート後にWebベースのテキスト領域で編集できます。これにより、コンピューターで変更してから再インポートしなくても、NetScalerで直接小さな変更を加えることができます。最後に、GUI を使用して、これらのファイルをコンピューターにエクスポートしたり、これらのファイルを削除したりできます。
注:
インポートしたファイルは、コマンドラインを使用して削除またはエクスポートすることはできません。
コマンドラインインターフェイスを使用してファイルをインポートするには
コマンドプロンプトで、次のコマンドを入力します:
import appfw htmlerrorpage <src> <name>
<save> ns config
例
次の例では、error.html という名前のファイルから HTML エラーオブジェクトをインポートし、それに HTMLError という名前を割り当てます。
import htmlerrorpage error.html HTMLError
save ns config
<!--NeedCopy-->
GUI を使用してファイルをインポートするには
XMLスキーマ、DTD、WSDLファイル、またはHTMLまたはXMLエラーオブジェクトをネットワーク上の場所からインポートする前に、NetScalerがファイルが置かれているインターネットまたはLANコンピューターに接続できることを確認してください。そうしないと、ファイルまたはオブジェクトをインポートできません。
-
[ **セキュリティ] > [NetScaler Web App Firewall] **[インポート] に移動します。
-
[ アプリケーションファイアウォール ] > [ インポート] に移動します。
-
「 アプリケーションファイアウォールのインポート 」ペインで、インポートするファイルの種類のタブを選択し、「 追加」をクリックします。
タブには、HTML エラーページ、XML エラーページ、XML スキーマ、または WSDL があります。ユーザーの観点から見ると、アップロードプロセスは4つのタブすべてで同じです。
-
ダイアログのフィールドに入力します。
-
名前-インポートされたオブジェクトの名前。
-
インポート元-インポートする HTML ファイル、XML ファイル、XML スキーマ、または WSDL の場所をドロップダウンリストから選択します。
- URL: アプライアンスにアクセスできるウェブサイト上のウェブ URL。
- ファイル: ローカルまたはネットワーク上のハードディスクまたはその他のストレージデバイス上のファイル。
- テキスト: カスタムレスポンスのテキストを GUI のテキストフィールドに直接入力または貼り付けます。
3 番目のテキストボックスが適切な値に変わります。指定できる 3 つの値を以下に示します。
-
URL—テキストボックスに URL を入力します。
-
ファイル-HTML ファイルへのパスとファイル名を直接入力するか、「ブラウズ」をクリックして HTML ファイルをブラウズします。
-
テキスト— 3 番目のフィールドが削除され、空白のスペースが残ります。
-
-
[続行] をクリックします。[ファイルの内容] ダイアログが表示されます。[URL] または [ファイル] を選択した場合、[ファイルの内容] テキストボックスには、指定した HTML ファイルが含まれます。「テキスト」を選択した場合、「ファイルの内容」テキストボックスは空です。
-
「テキスト」を選択した場合は、インポートするカスタムレスポンス HTML を入力するか、コピーして貼り付けます。
-
[完了] をクリックします。
-
オブジェクトを削除するには、オブジェクトを選択し、[ 削除] をクリックします。
GUI を使用してファイルをエクスポートするには
XML スキーマ、DTD、WSDL ファイル、または HTML または XML エラーオブジェクトをエクスポートする前に、Web App Firewall アプライアンスがファイルを保存するコンピュータにアクセスできることを確認してください。そうしないと、ファイルをエクスポートできません。
-
[ セキュリティ ] > [ Web App Firewall ] > [ インポート] に移動します。
-
Web App Firewall のインポートペインで 、エクスポートするファイルの種類のタブを選択します。
ユーザーの観点から見ると、エクスポートプロセスは 4 つのタブすべてで同じです。
-
エクスポートするファイルを選択します。
-
「アクション」ドロップダウンリストを展開し、「 エクスポート」を選択します。
-
ダイアログボックスで、「 ファイルを保存 」を選択し、「 OK」をクリックします。
-
「 ブラウズ 」ダイアログ・ボックスで、エクスポートしたファイルを保存するローカル・ファイル・システムおよびディレクトリに移動し、「 保存」をクリックします。
GUI で HTML または XML エラーオブジェクトを編集するには
HTML および XML エラーオブジェクトのテキストは、エクスポートしてから再インポートせずに GUI で編集します。
-
[ セキュリティ] > [NetScaler Web App Firewall] > [インポート] に移動し、変更するファイルの種類のタブを選択します。
-
[ アプリケーションファイアウォール ] > [ インポート] に移動し、変更するファイルの種類のタブを選択します。
-
変更するファイルを選択し、[ 編集] をクリックします。
HTML または XML エラーオブジェクトのテキストは、ブラウザのテキスト領域に表示されます。テキストは、ブラウザの標準ブラウザベースの編集ツールと方法を使用して変更できます。
注:編集ウィンドウは、HTML または XML エラーオブジェクトに小さな変更を加えることができるように設計されています。大幅な変更を行うには、エラーオブジェクトをローカルコンピューターにエクスポートし、標準の HTML または XML Web ページ編集ツールを使用することをお勧めします。
-
「 OK」をクリックし、「 閉じる」をクリックします。
CLI を使用して API 仕様ファイルを管理
受信APIトラフィックをインポートされたAPI仕様に照らして検証するには、それをプロファイルに割り当て、トラフィックをブロックまたは許可する緩和ルールを設定します。インポートした API 仕様をポリシー表現の作成に使用することもできます。API 仕様のインポートは、次の 2 つのステップで構成されます:
- API仕様のインポート-URLまたはシステムからAPI仕様をNetScalerにインポートします。
- API仕様をNetScalerに追加-API仕様をNetScalerに追加すると、ファイルが検証され、内部形式に変換され、API仕様エンティティが作成されます。作成された API 仕様エンティティは、ポリシー式と Web App Firewall プロファイルで使用されます。
CLI コマンドでは、次のパラメータが使用されます:
- 名前-アップロードされた API 仕様ファイルの名前。
- ソース- インポートされた仕様ファイルを保存する場所の URL (プロトコル、ホスト、パス、名前)。
- 仕様名 - アップロードされた API 仕様から作成されたエンティティの名前。
- タイプ-API 仕様の入力形式。 デフォルト値:OAS
API 仕様ファイルをインポートするには、次のように入力します:
import api specFile <name> <src>
例:
import apispec testapispec.json http://www.example.com/testapispec.json
API 仕様ファイルを追加するには、次のように入力します:
add api spec <Name> -File <string> -Type <string>
例:
add api spec testapispec -File testapispec.json -Type OAS
API 仕様ファイルを更新するには、更新が必要な新しい仕様ファイルをインポートします。
コマンドプロンプトで入力します:
update api spec <specName> -File <string> -Type <string>
例:
update api spec testapispec -File testapispec.json -Type OAS
注:
type 属性が指定されていない場合、OAS がデフォルトのタイプです。
すべてのエンドポイントを表示するには、次のように入力します:
show api spec <specName>
例:
show api spec testapispec
API 仕様を削除するには、次のように入力します:
rm api spec <specName>
例:
rm api spec testapispec
注:
API 仕様を削除する前に、その仕様がどのプロファイルまたはポリシーでも使用されていないことを確認してください。
GUI を使用して API 仕様ファイルを管理
- [ **セキュリティ] > [NetScaler Web App Firewall] **[インポート] に移動します。
- 「 インポート 」ページで、「 API 仕様インポートページ 」タブを選択し、「 追加」をクリックします。
-
API 仕様のインポートオブジェクトページで 、Import From パラメータに以下のオプションのいずれかを選択します:
- URL: アプライアンスにアクセスできるウェブサイト上のウェブ URL。
- ファイル: ローカルまたはネットワーク上のハードディスクまたはその他のストレージデバイス上のファイル。
- [続行] をクリックします。
-
API 仕様インポートオブジェクトページで 、次の詳細を入力します:
- API 仕様名 — アップロードされた API 仕様から作成されたエンティティの名前。 注:入力する API ファイル名と API 仕様名は同じでなければなりません。
-
API 仕様タイプ — 仕様のタイプを選択します。
タイプ:REST (OpenAPI/Swagger)、gRPC (PROTO)。
Default Type: REST (OpenAPI/Swagger)
- [完了] をクリックします。
新しく追加されたエンティティは、「 API仕様インポートページ」タブの「インポート」ページに表示されます。