cvs: phpdoc-de /features http-auth.xml
| From: | ali | Date: | Tue, 02 Sep 2003 18:05:43 +0000 |
| Subject: | cvs: phpdoc-de /features http-auth.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-896@lists.php.net to get a copy of this message | ||
ali Tue Sep 2 14:05:43 2003 EDT
Modified files:
/phpdoc-de/features http-auth.xml
Log:
- added infomration about autoglobals
- removed entities in examples, added CDATA
- cleaned up indentation
Index: phpdoc-de/features/http-auth.xml
diff -u phpdoc-de/features/http-auth.xml:1.10 phpdoc-de/features/http-auth.xml:1.11
--- phpdoc-de/features/http-auth.xml:1.10 Fri May 31 13:47:01 2002
+++ phpdoc-de/features/http-auth.xml Tue Sep 2 14:05:43 2003
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
<chapter id="features.http-auth">
<title>HTTP-Authentifizierung mit PHP</title>
-
+
<simpara>
Die HTTP-Authentifizierung durch PHP ist nur verfügbar, wenn PHP als
Apache-Modul läuft und funktioniert daher nicht mit der CGI-Version.
@@ -15,8 +15,19 @@
und $PHP_AUTH_TYPE, die den jeweiligen Benutzernamen, das
Passwort und den Typ der Identifizierung enthalten, erneut aufgerufen.
Momentan wird nur das Authentifizierungsmodell "basic" unterstützt.
- Näheres hierzu bei der <function>header</function> Funktion.</simpara>
-
+ Näheres hierzu bei der <function>header</function> Funktion.
+ </simpara>
+
+ <note>
+ <title>Anmerkung zur PHP Version</title>
+ <para>
+ <link linkend="language.variables.superglobals">Autoglobals</link>,
+ wie <link linkend="reserved.variables.server">$_SERVER</link>, sind seit
+ der PHP Version <ulink url="&url.php.release4.1.0;">4.1.0</ulink>
verfügbar.
+ <varname>$HTTP_SERVER_VARS</varname> seit PHP 3.
+ </para>
+ </note>
+
<para>
Ein Auszug aus einem Skript, das die Clientauthentifizierung
auf einer Seite erzwingt, würde so aussehen:
@@ -24,19 +35,22 @@
<example>
<title>HTTP-Authentifizierung</title>
<programlisting role="php">
-<?php
- if(!isset($PHP_AUTH_USER)) {
- Header("WWW-Authenticate: Basic realm=\"My Realm\"");
- Header("HTTP/1.0 401 Unauthorized");
- echo "Text to send if user hits Cancel button\n";
+<![CDATA[
+<?php
+ if( !isset ($_SERVER['PHP_AUTH_USER']) ){
+ Header("WWW-Authenticate: Basic realm=\"My Realm\"");
+ Header("HTTP/1.0 401 Unauthorized");
+ echo "Text to send if user hits Cancel button\n";
exit;
} else {
- echo "Hello $PHP_AUTH_USER.<P>";
- echo "You entered $PHP_AUTH_PW as your password.<P>";
+ echo "Hello {$_SERVER['PHP_AUTH_USER']}";
+ echo "<p>You entered {$_SERVER['PHP_AUTH_PW']} as your
password.</p>";
}
-?>
+?>
+]]>
</programlisting>
- </example></para>
+ </example>
+ </para>
<note>
<title>Hinweis</title>
@@ -50,25 +64,28 @@
</note>
<para>
- Anstatt $PHP_AUTH_USER und $PHP_AUTH_PW einfach nur
+ Anstatt $_SERVER['PHP_AUTH_USER'] und $_SERVER['PHP_AUTH_PW'] einfach nur
auszugeben, werden Sie den Benutzernamen und das Passwort
auf Gültigkeit überprüfen wollen. Dies kann durch die Abfrage
- einer Datenbank oder das Einlesen einer Textdatei geschehen.</para>
+ einer Datenbank oder das Einlesen einer Textdatei geschehen.
+ </para>
<para>
Vorsicht bei einigen Internet Explorer-Versionen - sie scheinen
sehr wählerisch zu sein, was die Reihenfolge der Header angeht.
Abhilfe schafft hier das Senden des <emphasis>WWW-Authenticate</emphasis>
- Headers vor dem <errorcode>HTTP/1.0 401</errorcode>.</para>
+ Headers vor dem <errorcode>HTTP/1.0 401</errorcode>.
+ </para>
<simpara>
Um zu unterbinden, dass ein Skript das Passwort einer durch
einen traditionellen externen Mechanismus geschützten Seite
ausliest, werden die PHP_AUTH Variablen nicht gesetzt, wenn
eine externe Authentifizierung für diese bestimmte Seite aktiviert
- ist. In diesem Fall kann die $REMOTE_USER Variable benutzt
+ ist. In diesem Fall kann die $_SERVER['REMOTE_USER'] Variable benutzt
werden, um den Benutzer durch die externe Zugriffskontrolle
- zu identifizieren.</simpara>
+ zu identifizieren.
+ </simpara>
<note>
<title>Konfigurationshinweis</title>
@@ -85,7 +102,8 @@
Zu beachten ist, dass obenstehendes keinesfalls jemanden,
der die Kontrolle über eine nichtgeschützte URL hat, davon
abhalten kann, Passwörter von geschützten URLs auf dem
- gleichen Rechner auszulesen.</simpara>
+ gleichen Rechner auszulesen.
+ </simpara>
<simpara>
Sowohl Netscape als auch der Internet Explorer löschen den
lokalen Authentifizierungscache des Browserfensters, wenn der
@@ -93,34 +111,37 @@
einen Benutzer "auszuloggen" und eine erneute Eingabe des
Benutzernamens/Passworts zu erzwingen. Manchmal wird dieses Verhalten
für das automatische Ausloggen nach Ablauf einer bestimmten Zeitspanne
- oder für einen Logout-Button genutzt.</simpara>
- <simpara></simpara>
+ oder für einen Logout-Button genutzt.
+ </simpara>
+ <simpara>
<example>
<title>HTTP-Authentifizierung, mit erneuter Anforderung von Name/Passwort</title>
<programlisting role="php">
-<?php
- function authenticate() {
- Header( "WWW-Authenticate: Basic realm=\"Test Authentication
System\"");
- Header( "HTTP/1.0 401 Unauthorized");
- echo "You must enter a valid login ID and password to access this resource\n";
+<![CDATA[
+<?php
+ function authenticate(){
+ Header("WWW-Authenticate: Basic realm=\"Test Authentication System\"");
+ Header("HTTP/1.0 401 Unauthorized");
+ echo "You must enter a valid login ID and password to access this resource\n";
exit;
}
- if(!isset($PHP_AUTH_USER) || ($SeenBefore == 1 && !strcmp($OldAuth,
$PHP_AUTH_USER)) ) {
+ if( !isset( $_SERVER['PHP_AUTH_USER'] ) || ( $SeenBefore == 1 && ! strcmp(
$OldAuth, $_SERVER['PHP_AUTH_USER']) ) ) {
authenticate();
- }
- else {
- echo "Welcome: $PHP_AUTH_USER<BR>";
- echo "Old: $OldAuth";
- echo "<FORM ACTION=\"$PHP_SELF\"
METHOD=POST>\n";
- echo "<INPUT TYPE=HIDDEN NAME=\"SeenBefore\"
VALUE=\"1\">\n";
- echo "<INPUT TYPE=HIDDEN NAME=\"OldAuth\"
VALUE=\"$PHP_AUTH_USER\">\n";
- echo "<INPUT TYPE=Submit VALUE=\"Re
Authenticate\">\n";
- echo "</FORM>\n";
+ }else{
+ echo "Welcome: {$_SERVER['PHP_AUTH_USER']}<br>";
+ echo "Old: $OldAuth";
+ echo "<form action=\"$PHP_SELF\" method=\"post\">\n";
+ echo "<input type=\"hidden\" name=\"SeenBefore\"
value=\"1\">\n";
+ echo "<input type=\"hidden\" name=\"OldAuth\"
value=\"{$_SERVER['PHP_AUTH_USER']}\">\n";
+ echo "<input type=\"submit\" value=\"Re Authenticate\">\n";
+ echo "</form>\n";
}
-?>
+?>
+]]>
</programlisting>
</example>
+ </simpara>
<simpara>
Dieses Verhalten wird vom Authentifizierungsstandard HTTP Basic
nicht gefordert, daher sollte man sich nie darauf verlassen. Tests
@@ -128,12 +149,13 @@
bei Erhalt einer 401-Meldung nicht löscht. Ein Klick auf den Zurück-
Button und danach auf Vorwärts wird die angeforderte Adresse
öffnen (und zwar so lange, bis die Identifizierung der Benutzer
- geändert wird).</simpara>
+ geändert wird).
+ </simpara>
<simpara>
Weiterhin muss beachtet werden, dass dies unter dem Microsoft
IIS mit der CGI-Version von PHP aufgrund einer
- Einschränkung des IIS nicht funktioniert.</simpara>
-
+ Einschränkung des IIS nicht funktioniert.
+ </simpara>
</chapter>
<!-- Keep this comment at the end of the file