Quellcode durchsuchen

modules/auth_db: document authentication return values

Klaus Darilion vor 12 Jahren
Ursprung
Commit
2940d50122
1 geänderte Dateien mit 18 neuen und 2 gelöschten Zeilen
  1. 18 2
      modules/auth_db/doc/auth_db_admin.xml

+ 18 - 2
modules/auth_db/doc/auth_db_admin.xml

@@ -327,13 +327,27 @@ modparam("auth_db", "version_table", 0)
 			occurred and no reply was sent out;
 			occurred and no reply was sent out;
 			</para></listitem>
 			</para></listitem>
 			<listitem><para>
 			<listitem><para>
-			<emphasis>-2 (invalid password)</emphasis> - valid user, but 
-			wrong password;
+			<emphasis>-2 (invalid password)</emphasis> - wrong password;
 			</para></listitem>
 			</para></listitem>
 			<listitem><para>
 			<listitem><para>
 			<emphasis>-3 (invalid user)</emphasis> - authentication user does
 			<emphasis>-3 (invalid user)</emphasis> - authentication user does
 			not exist.
 			not exist.
 			</para></listitem>
 			</para></listitem>
+			<listitem><para>
+			<emphasis>-4 (nonce expired)</emphasis> - the nonce has expired
+			</para></listitem>
+			<listitem><para>
+			<emphasis>-5 (no credentials)</emphasis> - request does not contain
+			an Authorization header with the correct realm.
+			</para></listitem>
+			<listitem><para>
+			<emphasis>-6 (nonce reused)</emphasis> - the nonce has already been
+			used to authenticate a previous request
+			</para></listitem>
+			<listitem><para>
+			<emphasis>-8 (authuser mismatch)</emphasis> - depending on the method, th
+			From/To/RURI user does not match the authentication user (see auth_check() function).
+			</para></listitem>
 		</itemizedlist>
 		</itemizedlist>
 		<para>Meaning of the parameters is as follows:</para>
 		<para>Meaning of the parameters is as follows:</para>
 		<itemizedlist>
 		<itemizedlist>
@@ -479,6 +493,8 @@ if (!proxy_authorize("$fd", "subscriber)) {
 		the function checks if authentication username matches From/To header
 		the function checks if authentication username matches From/To header
 		username, and Request-URI in case of PUBLISH.
 		username, and Request-URI in case of PUBLISH.
 		</para>
 		</para>
+		<para>Negative return codes have the same meaning as for
+			www_authenticate().</para>
 		<para>Meaning of the parameters is as follows:</para>
 		<para>Meaning of the parameters is as follows:</para>
 		<itemizedlist>
 		<itemizedlist>
 		<listitem>
 		<listitem>