|
|
||
FastCGI ディレクティブ
FastCgiAccessChecker
FastCgiAccessChecker ディレクティブは、FastCGI アプリケーションをディレクトリー・アクセス当たりの妥当性検査プログラムとして定義するために使用します。Apache Access の段階では、ユーザー認証が先に行われて、要求されたリソースへのアクセス許可の決定はその要求で実行依頼された HTTP ヘッダーに基づいて行われます。FastCGI に基づいた許可機能は、アクセス妥当性検査の決定に対する動的コンポーネント(時間またはドメインのアカウントが最新かどうかなど)がある場合に便利です。 FastCGI アプリケーションのファイル名に対応する静的または外部サーバー定義がない場合には、アプリケーションは動的 FastCGI アプリケーションとして開始されます。ファイル名がスラッシュ (/) で始まっていない場合には、そのファイル名は ServerRoot に相対するものと見なされます。 FastCgiAccessChecker は、Directory または Location コンテナー内で使用されます。
Mod_fastcgi は、通常 CGI/FastCGI 要求処理プログラムで使用可能なほとんどすべての標準環境変数を送信します。正常応答 (状況: 200) の FastCGI アクセス・チェッカー・アプリケーションによって戻されるすべてのヘッダーは、環境変数としてサブプロセス (CGI/FastCGI 呼び出し) に渡されます。正常に実行されなかった応答で返されるすべてのヘッダーはクライアントに渡されます。FastCGI 仕様に従った動作は "-compat" オプションを使用して取得されます。 Mod_fastcgi は、環境変数 "FCGI_APACHE_ROLE" を "ACCESS_CHECKER" に設定して、どの (Apache 特定の)許可機能フェーズが実行されるかを指示します。 FastCGI 許可機能アプリケーションからのカスタム障害応答はサポートされていません。作業の ErrorDocument ディレクティブを参照してください (FastCGI アプリケーションはその文書を実行することができます)。 FastCgiAccessCheckerAuthoritative
FastCgiAccessCheckerAuthoritative ディレクティブを明示的にオフに設定することによって、FastCGI アプリケーションがアクセスに失敗した場合に、アクセス検査を低レベルのモジュール(構成ファイルおよび modules.c ファイルで定義されている)に渡すことができます。 デフォルトでは、制御は渡されないで、失敗したアクセス検査では「禁止」応答となります。デフォルトを使用不可にする前に慎重に検討することをお勧めします。 FastCgiAuthenticator
FastCgiAuthenticator ディレクティブは、FastCGI アプリケーションをディレクトリー当たりのオーセンティケーターとして定義するために使用します。オーセンティケーターは、提供されたユーザー名とパスワードを、既知のユーザーおよびパスワードのリストまたはデータベースと突き合わせて、要求元を検査します。FastCGI に基づいたオーセンティケーターは、ユーザーのデータベースが既存の独立プログラム内で保持されているか、または Web サーバー以外のマシン上にある場合に便利です。 FastCGI アプリケーションのファイル名に対応する静的または外部サーバー定義がない場合には、アプリケーションは動的 FastCGI アプリケーションとして開始されます。ファイル名がスラッシュ (/) で始まっていない場合には、そのファイル名は ServerRoot に対して相対と見なされます。 FastCgiAuthenticator は Directoryまたは Location のコンテナー内で使用され、 AuthType および AuthName ディレクティブを含んでいる必要があります。サポートされているのは、「基本設定」 ユーザー認証タイプだけです。このタイプは、正しく機能するために require または FastCgiAuthorizer ディレクティブを必要とします。
Mod_fastcgi は、通常 CGI/FastCGI 要求処理プログラムで使用可能なほとんどすべての標準環境変数を送信します。正常応答 (状況: 200) の FastCGI 認証アプリケーションによって戻されるすべてのヘッダーは、環境変数としてサブプロセス (CGI/FastCGI 呼び出し) に渡されます。正常に実行されなかった応答で返されるすべてのヘッダーはクライアントに渡されます。FastCGI 仕様に従った動作は、"-compat" オプションを使用して取得されます。 Mod_fastcgi は、環境変数 "FCGI_APACHE_ROLE" を "AUTHENTICATOR" に設定して、どの (Apache 特定の)許可機能フェーズが実行されるかを指示します。 FastCGI 許可機能アプリケーションからのカスタム障害応答はサポートされていません。 作業の ErrorDocument ディレクティブを参照してください ( FastCGI アプリケーションはその文書を実行することができます)。
FastCgiAuthenticatorAuthoritative
FastCgiAuthenticatorAuthoritative ディレクティブを明示的に Off に設定することによって、FastCGI アプリケーションがユーザーの認証に失敗した場合に、認証を低レベルのモジュール (Configuration および modules.c ファイルで定義されている)に渡すことができます。 通常このディレクティブは、少数の(管理関連)ユーザーが入っている十分に保護された AuthUserFile と一緒に使用されます。 デフォルトでは、制御は渡されないで、不明のユーザーでは「許可が必要」の応答となります。 デフォルトを使用不可にする前に慎重に検討することをお勧めします。 FastCgiAuthorizer
FastCgiAuthorizer ディレクティブは、FastCGI アプリケーションをディレクトリーごとの許可機能として定義するために使用されます。 許可機能は、認証されたユーザーが要求されたリソースへのアクセスを許可されるかどうかの妥当性を検査します。 FastCGI に基づいた許可機能は、時間やユーザーが料金を支払ったかどうかなどの権限の決定に対する動的コンポーネントがある場合に便利です。 FastCGI アプリケーションのファイル名に対応する静的または外部サーバー定義がない場合には、そのアプリケーションは動的 FastCGI アプリケーションとして開始されます。 ファイル名がスラッシュ (/) で始まっていない場合には、そのファイル名は ServerRoot に対して相対と見なされます。 FastCgiAuthorizer は、Directory または Location コンテナー内で使用され、AuthType および AuthName ディレクティブを含む必要があります。このディレクティブには、正しく機能するために FastCgiAuthenticator、AuthUserFile、AuthDBUserFile、または AuthDBMUserFile などの authentication ディレクティブが必要です。 .
Mod_fastcgi は、通常 CGI/FastCGI で使用可能なほとんどすべての標準環境変数を送信します。 正常な応答で FastCGI 認証アプリケーションによって返されるすべてのヘッダー (状況: 200) は、環境変数としてサブプロセス (CGI/FastCGI 呼び出し)に割らされます。 正常に実行されなかった応答で返されるすべてのヘッダーは、クライアントに渡されます。 FastCGI 仕様に従った動作は、"-compat" オプションを使用することによって取得されます。 Mod_fastcgi は環境変数 "FCGI_APACHE_ROLE" を "AUTHORIZER" に設定して、どの (Apache 特定の)許可機能フェーズが実行されるかを指示します。 FastCGI 許可機能アプリケーションからのカスタム障害応答は、サポートされていません。 作業のErrorDocument ディレクティブを参照してください (FastCGI アプリケーションはその文書を実行することができます)。 FastCgiAuthorizerAuthoritative
FastCgiAuthenticatorAuthoritative ディレクティブを明示的に Off に設定することによって、FastCGI アプリケーションがユーザーの認証に失敗した場合に、認証を低レベルのモジュール (構成 および modules.c ファイルで定義されている)に渡すことができます。 通常このディレクトリーは、少数の(管理関連)ユーザーが入っている十分に保護された AuthUserFile と一緒に使用されます。 デフォルトでは、制御は渡されないで、不明のユーザーでは「許可が必要」の応答となります。 デフォルトを使用不可にする前に慎重に検討することをお勧めします。 FastCgiConfig
FastCgiConfig ディレクティブは、すべての動的 FastCGI アプリケーションのデフォルトのパラメーターを定義します。このディレクティブは静的または外部アプリケーションには影響を与えません。 動的アプリケーションはコマンドによって開始されます。 要求が多量の場合には、追加のアプリケーション・インスタンスが開始されます。要求が少なくなると、アプリケーション・インスタンスは強制終了されます。多くのオプションがこのプロセスを管理します。 オプション は次の 1 つを含むことができます(大文字小文字が区別されます)。 FastCgiExternalServer
FastCgiIpcDir
|
|
UNIX: FastCgiIpcDir ディレクティブは、アプリケーションと Web サーバーとの間の通信に使用する UNIX ソケット・ファイルを保管 (外部 FastCGI アプリケーションの場合には検索) する場所として directory を指定します。このディレクトリーがスラッシュ (/) で始まっていない場合には、ServerRoot に対して相対と見なされます。このディレクトリーが存在しない場合には、適切な許可によってディレクティブを作成しようとします。ローカル・ファイル・システム上にないディレクトリーは、指定しないでください。デフォルトのディレクトリー(または /tmp 内の別のディレクトリー)を使用する場合には、mod_fastcgiは、ユーザー・システムが定期的に /tmp からファイルを削除する場合に中断します。 |
|
|
Windows NT: FastCgiIpcDir ディレクティブは、アプリケーションと Web サーバーとの間の通信に使用される名前付きパイプのルートとして名前を指定します。名前 は \\.\pipe\パイプ名の形式で入力してください。パイプ名パーツには、円記号以外の任意の文字を入れることができます。 |
||
FastCgiIpcDir ディレクティブは FastCgiServer または FastCgiExternalServer ディレクティブ (UNIX ソケット)の前に必要です。このディレクトリーが Web サーバーによって読み取り可能、書き込み可能、実行可能(検索可能)であることを確認してください。 FastCgiServer
FastCgiServer ディレクティブは、静的 FastCGI アプリケーションとして ファイル名 を定義します。ファイル名がスラッシュ (/) で始まっていない場合には、そのファイル名は ServerRoot に対して相対と見なされます。 デフォルトでは、プロセス・マネージャーは、アプリケーションの 1 つのインスタンスを下記で括弧に入れて指定されたデフォルトの構成で開始します。何らかの理由で静的アプリケーション・インスタンスが中断した場合には、mod_fastcgi は置き換え用の別のインスタンスを作成して、そのイベントを(warn LogLevelで)ログに記録します。 オプション は以下の 1 つとすることができます(大文字小文字が区別されます)。 |
|||
|
|
||
|
Windows NT: アプリケーションが Web サーバーとの通信に使用するパイプの名前。 このモジュールは、FastCgiIpcDir で指定された名前付きパイプのルートから名前付きパイプを作成します。 このオプションは、アプリケーションを同じマシン上の cgi-fcgi などの他のアプリケーション、または外部 FastCGI アプリケーション定義 (FastCgiExternalServer) を介してアクセスできるようにします。-socket も -port オプションも指定されていない場合には、モジュールは名前付きパイプの名前を生成します。-socket と -port オプションは相互に排他的です。 | ||
FastCgiSuexec
FastCgiSuexec ディレクティブは、suexec-wrapper のサポートを使用可能にするために使用されます。 FastCgiSuexec では、suexec が Apache (CGI の場合) で使用可能になる必要があります。 Apache が使用した suexec-wrapper と同じものを使用するには、FastCgiSuexec を On. に設定してください。別の suexec-wrapper を使用するには、suexec-wrapper の filename を指定してください。 ファイル名がスラッシュ (/) で始まっていない場合には、そのファイル名は ServerRoot に対して相対と見なされます。 FastCgiSuexec が使用可能の場合には、静的または外部 FastCGI アプリケーション定義の場所が重要です。 これらの相違は、定義されている仮想サーバーの User および Group ディレクティブからそのユーザーおよびグループを継承します。 User および Group ディレクティブは、FastCGI アプリケーション定義の前に置く必要があります。 この機能は、FastCGI アプリケーションをそれが定義された仮想サーバーに限定しないので、アプリケーションは仮想サーバーから同じユーザーおよびグループで要求をサービスすることができます。 正しいユーザーおよびグループで実行中の既存の突き合わせ定義なしで、FastCGI アプリケーションの要求を受信した場合には、その正しいユーザーおよびグループでアプリケーションの動的インスタンスが開始されます。 このアクションは、別のユーザー/グループで実行中の同じアプリケーションの複数のコピーをもたらす場合があります。 これが問題になる場合には、他の仮想サーバーからアプリケーションへのナビゲートを不可能にするか、あるいは同じユーザー およびグループで仮想サーバーを構成してください。 (セキュリティーに関して完全に理解するために) suexec の詳細については Apache の文書を参照してください。
(トップに戻る) |