📄 webssecurityhandler.htm
字号:
<html>
<head>
<!- Copyright (c) Go Ahead Software Inc., 1995-2000. All Rights Reserved. ->
<title>websSecurityHandler -- GoAhead WebServer API</title>
<link rel="stylesheet" href="../../../style/doc.css" type="text/css">
</head>
<body>
<table width="550"> <tr><td>
<TABLE border=0 width=100% cellspacing=0 cellpadding=0 CLASS="apiTitle"> <TR>
<td class="titleLeft" align=left width="33%"><b>websSecurityHandler</b></TD><td class="titleCenter" align=center width="33%"><b>
GoAhead WebServer API</b></TD><td class="titleRight" align=right width="33%"><B>
GoAhead EMF</B></TD></TR> </TABLE><HR> <h2>Synopsis</h2><p> URL handler for the
default security policy.</p><h2>Prototype</h2><pre> #include "webs.h"
int <b>websSecurityHandler</b>(webs_t wp, char_t *url, char_t *path, char_t *query);
</pre><h2>Parameters</h2><table width=100% BORDER="0" CELLPADDING="0" CELLSPACING="0">
<TR> <TD VALIGN="TOP" WIDTH="5%">wp <TD WIDTH="95%">Web server connection handle.
<TR> <TD VALIGN="TOP" WIDTH="5%">url <TD WIDTH="95%">Request URL. <TR> <TD VALIGN="TOP" WIDTH="5%">path
<TD WIDTH="95%">Request path portion of the URL. <TR> <TD VALIGN="TOP" WIDTH="5%">query
<TD WIDTH="95%">Query string portion of the URL.</TD></TR></table><h2>Description</h2><P>websSecurityHandler
implements the default security policy. It operates as a URL handler and is installed
to run as the very first URL handler. If you require a replacement security policy,
delete the websSecurityHandler and install your own with <A href="websUrlHandlerDefine.htm">websUrlHandlerDefine</A>.</P><P>
The <A href="websSetPassword.htm">websSetPassword</a> procedure defines the security
password. The security handler will require all non-local requests (those from
a remote system) to supply this password. The user name is ignored. To use the
password feature, the <A href="websSecurityHandler.htm" >Security Handler</A>
must be installed by calling <A href="websUrlHandlerDefine.htm" >websHandlerDefine</A>
for websSecurityHandler. This in done automatically in the GoAhead EMF. If you
are using the GoAhead WebServer, this should be done in your main program. See
main.c for examples.</P><P>The security handler should return 0 if the request
is acceptable. It should return 1 to deny the request. When websSecurityHandler
denies a request, it first returns a 401 response code to cause the user's browser
to prompt for a username and password.</P><p> <p>Use <A href="websGetRequestPassword.htm">websGetRequestPassword</A>
to get the password supplied with the current request.</p><h2>Return Value</h2><p>
Returns 0 if the request is acceptable. Returns 1 if the request is denied.</p><h2>Example</h2><p>The
following code will install a new security handler:</p><pre> websSecurityDelete();
websUrlHandlerDefine("", mySecurityHandler, WEBS_HANDLER_FIRST); </pre><h2>Stability
Classification</h2><p>Stable.</p><h2>See Also</h2><p> <A href="websGetRequestFlags.htm">websGetRequestFlags</A>,
<A href="websGetRequestIpaddr.htm">websGetRequestIpaddr</A>, <A href="websGetRequestPassword.htm">websGetRequestPassword</A>,
<A href="websGetRequestType.htm">websGetRequestType</A> </p></td></tr></table>
</body>
</html>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -