このセクションでは、Expressway Web ユーザ インターフェイスと CLI および API について概要を説明します。

システム構成は通常、Web インターフェイスを通じて実行されます。 Web インターフェイスを使用するには:

1. ブラウザ ウィンドウを開き、アドレス バーにシステムの IP アドレスまたは FQDN を入力します。

2. 有効な管理者「ユーザー名」と「パスワード」を入力し、[ログイン（Login）] をクリックします (管理者アカウントの設定の詳細については、ユーザーアカウントのセクションを参照してください)。 概要 ページが表示されます。

Expressway のセキュリティ証明書に関する警告メッセージが表示された場合は、システムのセキュリティ保護の準備ができるまでこれを無視できます。

フィールドマーカー

• 赤い星印 は必須項目です

• オレンジ色のシンボル は、クラスタ内の各ピアで設定する必要があるフィールドを示します。

サポートされるブラウザ

Expressway Web インターフェイスは、Microsoft Edge、Firefox、Chrome 向けに設計され、テストされています。 ユーザ インターフェイスにアクセスするために他のブラウザーを使用することは、公式にはサポートされていません。

Expressway Web インターフェイスを使用するには、JavaScript と Cookie を有効にする必要があります。

HTTP メソッド

Expressway Web サーバでは、次の HTTP メソッドが許可されます。

API へのユーザアクセスを無効にする方法

管理者はデフォルトで API にアクセスできます。 これは次の 2 つの方法で無効にできます。

• Expressway が高度なアカウント セキュリティ モードで実行されている場合、すべてのユーザに対して API アクセスが自動的に無効になります。

• 個々の管理者の API アクセスは、ユーザ設定オプションを通じて無効にすることができます。

コマンド ライン インターフェイス (CLI) は、デフォルトで SSH 経由、およびアプライアンス ベースのシステムのシリアル ポート経由で利用できます。 これらの設定は、 システム管理 ページで制御されます。

Expressway が高度なアカウント セキュリティ モードになっているか、管理者のユーザー設定オプションで個別のアクセスが無効になっている場合を除き、管理者はデフォルトで Expressway REST API にアクセスできます。

API は、RESTful API モデリング言語 (RAML) を使用して自己文書化されています。 "『Expressway コンフィギュレーション ガイド』"ページでは、『REST API 概要ガイド』 が提供されており、ベース URL と RAML 定義にアクセスする方法がまとめられており、いくつかの要求と応答の例が示されています。

クロスサイトリクエストフォージェリ保護ヘッダー

クロスサイト リクエスト フォージェリ (CSRF) は、認証されたユーザに、現在認証されている Web アプリケーションにリクエストを送信するよう強制する攻撃です。 CSRF 攻撃は、Web アプリケーションが認証されたユーザに対して持つ信頼を悪用します。

このような攻撃を防ぐために新しいヘッダーが追加され、CSRF 保護が 有効になっているときは常に、XML Put、SOAP、および CDB Rest API リクエストとともにこのヘッダーを送信する必要があります。 CSRF ヘッダー: X-CSRF-Header を有効または無効にするコマンドについては、「リファレンス マテリアル - xConfiguration コマンド」の章を参照してください。

（注）	CDB Rest、SOAP、または XMLPut API を呼び出すすべてのスクリプト/コードは、CSRF が有効になると、リクエスト ヘッダーの一部として「X-CSRF-Header」を送信する必要があります。

X14.2 リリース以降、これらの RAML API のいずれかを使用している場合は、POST リクエストを行うときに X-CSRF-Header というカスタム ヘッダーを追加する必要があります。 ヘッダーの値は重要ではありません。

/api/プロビジョニング/再起動

/api/プロビジョニング/共通/デフォルトリンク

/api/provisioning/controller/b2bua/microsoftinterop/restartservice

/api/provisioning/domaincerts/domain/<domain>

/api/provisioning/certs/acme/pendingcert

/api/provisioning/certs/acme/pendingcert/deploy

/api/provisioning/domaincerts/domain/<domain>/acme/pendingcert/deploy

X15.0 リリースから、CDB、XMLPut、SOAP API に CSRF 保護ヘッダーが導入されました。

クロスサイト リクエスト フォージェリ保護の無効化または有効化: X15.0.3 以降のリリースでは、CSRF 保護はデフォルトで 有効 になっています。 次のコマンドを実行して、カスタム ヘッダーを有効または無効にすることができます。

• xConfiguration セキュリティ CSRFProtection の状態:「無効」

  詳細については、 リンクを参照してください。

• xConfiguration セキュリティ CSRFProtection 状態: "有効"

  詳細については、 リンクを参照してください。

（注）	上記以外の RAML API を使用する場合は、スクリプトに変更を加える必要はありません。 クライアント アプリケーション接続を受け入れるすべてのホスト API リソース (Web サービス) は、API の機能を保護し、API のデータ機密性に応じたデータへのアクセスを保護するために、認証と承認を使用する必要があります。 以前の API アクセスはデフォルトで「有効」でしたが、現在は「無効」になっています。