高度なAccess Gatewayポリシーを作成する

コメント

コメントは常に#から始まります。

#This is a comment
#This comment, preceded by a space
set $TEST "some value"; #this is also a valid comment

埋め込みまたは事前定義された変数

埋め込み変数にはすべてのHTTP セッション、Cookie、クエリおよびリクエストヘッダーフィールドと、50以上の名前付き変数が含まれます。通常、これらの変数はプレフィックスを使用してアクセスされます。一般的なプレフィックスを以下に示します。

プレフィックス	用途	例
arg_	クエリ引数にアクセス	arg_name、ここで、nameはクエリ変数を表します。
cookie_	Cookieフィールドにアクセス	cookie_name、ここで、nameはCookieフィールドを表します。
http_	任意のヘッダーフィールドにアクセス	http_email、ここで、emailはヘッダーのフィールドを表します。
sent_http_	ヘッダーフィールドに応答	sent_http_email、ここで、emailは応答ヘッダーのフィールドを表します。

一部の変数リストには以下が含まれます。

• $args - リクエスト内のすべての引数。
• $request_uri - 完全なオリジナルリクエストURI（引数付き）。
• $uri - リクエスト内のコンテンツURI 。
• $request_body - リクエストの本文。

埋め込み変数のすべてのリストについては、 「埋め込み変数」を参照してください。

ユーザー変数

カスタム構成内で変数を定義し、それらを割り当てや条件(if)文で使用できます。

一般的な形式：

set $variablename value;

例：

#create a variable TEST, containing the value "test value"
set $TEST "test value";

条件分岐

条件分岐を使用すると、変数の状態に基づいて決定を行い、条件に応じてコードブロックを実行することができます。

一般的な形式：

if (condition) { statement1; statement2; . . . statementn; }

ここで、conditionは：

• 変数名、空白または0の場合はfalse、それ以外の場合はtrue。
• =（等しい）および!= （等しくない）演算子を使用した2つの変数間の比較。
• 変数と正規表現との照合。

例：

# If the query parameter 'test' contains the value 'demo' # then no authorization required.
if ($arg_test = "demo") { set $policy_type "NO_AUTH";}

さらに、breakディレクティブは以降のステートメントの実行を停止します。
例：

 if ($arg_test = "demo") { set $policy_type "NO_AUTH"; break; } #Statements after break not executed if condition is true

if文について詳しくは、if文を参照してください。

リターンコード

処理を停止し、指定されたコードをクライアントに返します。

一般的な形式：

return numericReturnCode [任意のURL];

例：

#Stop executing and return a 404
return 404;

ディレクティブ

ディレクティブとはカスタム構成から呼び出し可能なビルトイン機能一式であり、様々なプログラミング言語で呼び出される機能と似ています。ディレクティブはパラメータを取ることが多いです。

一般的な形式：

directive_name [parameter1 [parameter2 [parametern]]];

参照 すべてのNGNIXディレクティブのリスト（アルファベット順）。

ディレクティブの例には以下が挙げられます。