[CTX] [ALL] AUTH parameter for HTTP-DeleGate

---

HTTP-DeleGate 用 AUTH パラメーター

AUTH=origin:auth

-- default: AUTH=origin:ident
AUTH=proxy のように、 HTTP ヘッダー中の "Authorization" フィールド内で使用する値を指定し、 ユーザー証明を行います (この場合、"HTTP 元サーバー" としての DeleGate へのアクセス性の検査を除く)。

例)

AUTH=origin:auth RELIABLE="*@localhost"
どんなユーザーも、この DeleGate の localhost にログイン可能で、 アクセスを認証するために、Authorization の一組の正しいユーザー名とパスワードが与えられれます。

AUTH=forward[:{by,for,ver,*}]

HTTP 要求ヘッダー内の Forwarded フィールドにあるソースホストの識別情報を次のように投げます:

Forwarded: by Me (Version) for Client

現状で、これが指定された場合、AUTH="forward:*:" とみなされ、2番目のフィールドは無視されます。 これは、ファイアーウォール上の DeleGate が、内部 HTTP サーバーを外部に向けて中継する場合有効です。

AUTH=viagen[:hostIdentifier]

この DeleGate のホストの識別子を指定します。 それは、転送 HTTP メッセージヘッダー中の Via フィールドに以下のように埋め込まれます:

Via: protocol-version hostIdentifier ( comment )


AUTH=viagen を指定しない場合、デフォルトの偽名が、 hostIdentifier に使用されます。 AUTH="viagen" のように空の hostIdentifier を指定した場合、 この DeleGate ホスト名が使用されます。 特別な指定 AUTH="viagen:-" は、Via フィールドの埋め込みを停止します。
'%' を hostIdentifier 内で使用した場合、 下述の authString の書式として解釈されます。

AUTH=authgen:basic:authString

HTTP 要求ヘッダー中に、クライアントからの元 Authorization フィールドがない場合、 "Authorization:Basic authString" を生成し、サーバーに転送します。 authString は、"userName:passWord" でなければなりません。 次のの特別文字列は、クライアントの属性をあらわします。

%u	-- Ident プロトコルで得られたユーザー名
%h	-- ソケットから得られたクライアントのホスト名
%i	-- クライアントに向けたネットワークインターフェースのホスト名
%I	-- %i と同様ですが、HTTP で "Host:" が与えられた場合その値を使用します。
%a	-- クライアントのホストアドレス
%n	-- クライアントのネットワークアドレス
%H	-- DeleGate のホスト名
%M	-- DeleGate の ADMIN
%A	-- "CMAP=string:authgen:mapSpec" によって生成される文字列
%U	-- クライアントの [Proxy-]Authorization: username:password の username 部
%P	-- クライアントの [Proxy-]Authorization: username:password の password 部

例)

ファイアーウォールが 2つのネットワークインターフェースを持ち、 内部/外部ホストが異なるインターフェースからアクセスする場合、 それらは、インターフェース名で区別できます。
AUTH="authgen:basic:%i:%h"
他の場合、内部ネットワークは以下のように、CMAP で明示する必要があります。
AUTH="authgen:basic:%A"
CMAP="{internal:passWord}:authgen:*:*:{InternalNetList}"
CMAP="{external:passWord}:authgen:*:*:*"


"passWord/%i" 書式でパスワードが生成され、DeleGate は、 このようなパターンの Authorization フィールドをともなってくる要求を拒否します。 このように、偽パスワードは、ホスト"%i" 上の DeleGate を通過できません。

AUTH=pauthgen:basic:authString

AUTH=authgen のように "Proxy-Authorization: Basic authString" を生成する。 注記: MYAUTH="user:pass:http-proxy" により古いものになりました。

例)

クライアントからの要求メッセージ中で消費される Proxy-Authorization を そのまま上流プロキシーに転送する (authString == %U:%P により)。
AUTH=proxy:pauth AUTH="pauthgen:basic:%U:%P" PROXY=...

AUTH=fromgen:fromString

指定した場合、 元のヘッダーが、元の From フィールドを持たない場合、 "From: fromString" が、HTTP 要求に差込まれます。 fromString が省略された場合、デフォルト値は "%u@%h" になります。

AUTH=log:remoteHost:identUser:authUser

HTTP サーバー共通ログファイル書式内のクライアント情報部の内容を指定します。 デフォルト値は、AUTH="log:%h:%u:%U" です。

%F	-- From フィールドの E-mail アドレス
%L	-- From: local@domain フィールドの local 部
%D	-- From: local@domain フィールドの domain 部
%U	-- Authorization: username:password の username 部
%P	-- Authorization: username:password の password 部
%Q	-- Forwarded: フィールドの "for clientFQDN" 部

例)

元のクライアントに関する情報は、内部の DeleGate に記録され、 ファイアーウォール DeleGate から転送されるものは、 ファイアーウォール DeleGate で From フィールドが生成され、 内部 DeleGate に記録されます。

firewall% delegated AUTH="fromgen:%u@%h" ...
internal% delegated AUTH="log:%D/%h:%L/%u:%U" ...

---