dorequest
|
(Optional) Controls whether to actually get the certificate,
or just test for its presence.
-
1 tells the function to redo the
SSL3 handshake to get a client certificate, if the server does not
already have the client certificate. This typically causes the client
to present a dialog box to the user to select a client certificate.
The server might already have the client certificate if it was requested
on the initial handshake, or if a cached SSL session has been resumed.
-
0 tells the function not to redo
the SSL3 handshake if the server does not already have the client
certificate.
If a certificate is obtained from the client
and verified successfully by the server, the ASCII base 64 encoding
of the DER-encoded X.509 certificate is placed in the parameter auth-cert in the Request->vars pblock,
and the function returns REQ_PROCEED, allowing
the request to proceed.
The default value is 0.
|
require
|
(Optional) Controls whether failure to get a client certificate
will abort the HTTP request.
-
1 tells the function to abort the
HTTP request if the client certificate is not present after dorequest is handled. In this case, the HTTP status is set to PROTOCOL_FORBIDDEN, and the function returns REQ_ABORTED.
-
0 tells the function to return REQ_NOACTION if the client certificate is not present after dorequest is handled.
The default value is 1.
|
method
|
(Optional) Specifies a wildcard pattern for the HTTP methods
for which the function will be applied. If method is
absent, the function is applied to all requests.
|
bucket
|
(Optional) Common to all obj.conf functions.
Adds a bucket to monitor performance. For more information, see The bucket Parameter.
|