cvs: phpdoc-it /features http-auth.xml
| From: | Simone Cortesi | Date: | Tue, 24 Sep 2002 21:56:58 +0000 |
| Subject: | cvs: phpdoc-it /features http-auth.xml | ||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-104@lists.php.net to get a copy of this message | ||
cortesi Tue Sep 24 17:56:58 2002 EDT
Modified files:
/phpdoc-it/features http-auth.xml
Log:
general sync with EN 1.28
Index: phpdoc-it/features/http-auth.xml diff -u phpdoc-it/features/http-auth.xml:1.12 phpdoc-it/features/http-auth.xml:1.13 --- phpdoc-it/features/http-auth.xml:1.12 Sun Jun 2 11:10:24 2002 +++ phpdoc-it/features/http-auth.xml Tue Sep 24 17:56:58 2002 @@ -1,74 +1,97 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.22 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.28 Maintainer: cortesi Status: ready --> <chapter id="features.http-auth"> <title>Autenticazione HTTP usando PHP</title> <simpara> I meccanismi di Autenticazione HTTP sono disponibili in PHP solo quando questo - viene usato come un modulo di Apache ed esso non è quindi disponibile nella versione CGI. + viene usato come un modulo di Apache ed esso non è quindi disponibile nella versione CGI. In uno script PHP modulo di Apache, è possibile usare la funzione <function>header</function> per inviare un messaggio di "Authentication Required" al browser dell'utente, provocando quindi l'apertura di una finestra contenente una richiesta di Nome utente/Password. Una volta che l'utente ha compilato i campi nome utente e password, - l'URL contenente lo script PHP verrà richiamato nuovamente usando le variabili, - $PHP_AUTH_USER, $PHP_AUTH_PW e $PHP_AUTH_TYPE impostate con, rispettivamente: - nome, password e tipo di autenticazione. Solamente il tipo di autenticazione "Basic" + l'URL contenente lo script PHP verrà richiamato nuovamente usando le + <link linkend="reserved.variables">variabili predefinite</link>, <varname>PHP_AUTH_USER</varname>, + <varname>PHP_AUTH_PW</varname> e + <varname>PHP_AUTH_TYPE</varname> impostate con, rispettivamente: + nome, password e tipo di autenticazione. Queste variabili predefinite possono essere trovate + negli array <link linkend="reserved.variables.server">$_SERVER</link> e + <varname>$HTTP_SERVER_VARS</varname>. Solamente il tipo di autenticazione "Basic" è al momento supportato. Fare riferimento alla funzione <function>header</function> - per ulteriori informazioni.</simpara> + per ulteriori informazioni. + </simpara> + <note> + <title>Nota sulla versione di PHP</title> + <para> + Le <link linkend="language.variables.superglobals">variabili autoglobali</link>, + come <link linkend="reserved.variables.server">$_SERVER</link>, esistono + in PHP dalla versione <ulink url="&url.php.release4.1.0;">4.1.0</ulink>. + <varname>$HTTP_SERVER_VARS</varname> è disponibile a partire da PHP 3. + </para> + </note> + <para> Un frammento di script di esempio che richiede l'autenticazione da parte del browser su una pagina, potrebbe essere il seguente: - + </para> + <para> <example> <title>Esempio di Autenticazione HTTP</title> <programlisting role="php"> <![CDATA[ <?php - if (!isset($PHP_AUTH_USER)) { - header("WWW-Authenticate: Basic realm=\"Il mio realm\""); - header("HTTP/1.0 401 Unauthorized"); - echo "Messaggio da inviare se si preme il tasto Cancel\n"; + if (!isset($_SERVER['PHP_AUTH_USER'])) { + header('WWW-Authenticate: Basic realm="Il mio realm"'); + header('HTTP/1.0 401 Unauthorized'); + echo 'Messaggio da inviare se si preme il tasto Cancel'; exit; } else { - echo "<p>Ciao $PHP_AUTH_USER.</p>"; - echo "<p>Hai inserito $PHP_AUTH_PW come tua password.</p>"; + echo "<p>Ciao {$_SERVER['PHP_AUTH_USER']}.</p>"; + echo "<p>Hai inserito {$_SERVER['PHP_AUTH_PW']} come tua password.</p>"; } ?> ]]> </programlisting> - </example></para> + </example> + </para> <note> - <title>Note</title> + <title>Note sulla compatibilità</title> <para> Fare molta attenzione quando si scrive codice per le intestazioni HTTP. Per ottenere la massima compatibilità con tutti i client, la paorla-chiave "Basic" deve essere scritta con una "B" maiuscola, la stringa realm deve essere racchiusa in virgolette doppie (non singole), - ed esattamente uno spazio deve precedere il codice "401" nella linea di intestazione "HTTP/1.0 401". + ed esattamente uno spazio deve precedere il codice <emphasis>401</emphasis> nella linea + di intestazione <emphasis>HTTP/1.0 401</emphasis>. </para> </note> <para> - Invece di stampare semplicemente $PHP_AUTH_USER e - $PHP_AUTH_PW, probabilmente si vorrà controllare la validità dello username e - della password. Probabilemnte inviando una chiamata al database, - o cercando un utente in un file dbm.</para> + Invece di stampare semplicemente <varname>PHP_AUTH_USER</varname> e + <varname>PHP_AUTH_PW</varname>, probabilmente si vorrà controllare + la validità dello username e della password. + Probabilmente inviando una chiamata al database, + o cercando un utente in un file dbm. + </para> <para> Si faccia attenzione ad alcune versioni di Internet Explorer. Sembra che siano molto schizzinosi riguardo all'ordine delle intestazioni. Inviare l'intestazione <emphasis>WWW-Authenticate</emphasis> prima dell'intestazione <literal>HTTP/1.0 401</literal> sembra sistemare le cose per - il momento.</para> + il momento. + </para> <simpara> Al fine di prevenire che qualcuno scriva uno script che rivela la password di una pagina che era stata autenticata tramite un tradizionale meccanismo esterno, le variabili PHP_AUTH non verranno - impostate se è abilitata l'autenticazione esterna per quella determinata - pagina. In questo caso, la variabile $REMOTE_USER può essere usata per - identificare un utente autenticato esternamente.</simpara> + impostate se è abilitata l'autenticazione esterna per quella determinata + pagina. In questo caso, la variabile <varname>REMOTE_USER</varname> può essere + usata per identificare un utente autenticato esternamente. Così, + <varname>$_SERVER['REMOTE_USER']</varname>. + </simpara> <note> <title>Nota sulla Configurazione</title> @@ -84,7 +107,8 @@ <simpara> Si fa notare, però, che quanto scritto sopra non impedisce a qualcuno che controlla un URL non autenticato di sottrarre password da - URL autenticati presenti sullo stesso server.</simpara> + URL autenticati presenti sullo stesso server. + </simpara> <simpara> Sia Netscape Navigator che Internet Explorer cancellano la cache locale della finestra del browser, per quanto riguarda il realm, al ricevimento @@ -92,41 +116,43 @@ che lo forza a reinserire lo username e la password. Alcune persone usano questo per fare il "time out" dei login, o per rendere disponibili bottoni di "log-out". </simpara> - <example> - <title>Esempio di Autenticazione HTTP che impone l'inserimento di nuovo username/password</title> - <programlisting role="php"> + <para> + <example> + <title>Esempio di Autenticazione HTTP che impone l'inserimento di nuovo username/password</title> + <programlisting role="php"> <![CDATA[ <?php function authenticate() { - header( "WWW-Authenticate: Basic realm=\"Prova del Sistema di Autenticazione\""); - header( "HTTP/1.0 401 Unauthorized"); + header('WWW-Authenticate: Basic realm="Prova del Sistema di Autenticazione"'); + header('HTTP/1.0 401 Unauthorized'); echo "Per poter accedere a questa risorsa occorre inserire una coppia login e password valide\n"; exit; } - if (!isset($PHP_AUTH_USER) || ($SeenBefore == 1 && !strcmp($OldAuth, $PHP_AUTH_USER))) { + if (!isset($_SERVER['PHP_AUTH_USER']) || ($_POST['SeenBefore'] == 1 && $_POST['OldAuth'] == $_SERVER['PHP_AUTH_USER'])) { authenticate(); } else { - echo "<p>Benvenuto: $PHP_AUTH_USER<br>"; - echo "Vecchio: $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 "<p>Benvenuto: {$_SERVER['PHP_AUTH_USER']}<br>"; + echo "Vecchio: {$_REQUEST['OldAuth']}"; + echo "<form action='{$_SERVER['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='Ri autentifica'>\n"; echo "</form></p>\n"; } ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> <simpara> - Questo comportamento non è richiesto dallo standard di autenticazione HTTP + Questo comportamento non è richiesto dallo standard di autenticazione HTTP Basic, quindi non si dovrebbe mai fare affidamento su di esso. Test effettuati con Lynx mostrano che Lynx non cancella le credenziali di autenticazione al ricevimento del codice di risposta 401 da parte del server, quindi, premendo indietro e avanti nuovamente, darà nuovamente accesso alla risorsa, ammesso che le rispettive richieste di credenziali - non siano cambiate. L'utente può però premere il + non siano cambiate. L'utente può però premere il tasto '_' al fine di cancellare le sue informazioni di autenticazione. </simpara> <simpara> @@ -135,7 +161,6 @@ </simpara> <note> - <title>Nota</title> <para> Se è abilitato <link linkend="ini.safe-mode">safe mode</link> viene aggiunto lo uid dello script al <literal>realm</literal>
Index: phpdoc-it/features/http-auth.xml diff -u phpdoc-it/features/http-auth.xml:1.12 phpdoc-it/features/http-auth.xml:1.13 --- phpdoc-it/features/http-auth.xml:1.12 Sun Jun 2 11:10:24 2002 +++ phpdoc-it/features/http-auth.xml Tue Sep 24 17:56:58 2002 @@ -1,74 +1,97 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.22 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.28 Maintainer: cortesi Status: ready --> <chapter id="features.http-auth"> <title>Autenticazione HTTP usando PHP</title> <simpara> I meccanismi di Autenticazione HTTP sono disponibili in PHP solo quando questo - viene usato come un modulo di Apache ed esso non è quindi disponibile nella versione CGI. + viene usato come un modulo di Apache ed esso non è quindi disponibile nella versione CGI. In uno script PHP modulo di Apache, è possibile usare la funzione <function>header</function> per inviare un messaggio di "Authentication Required" al browser dell'utente, provocando quindi l'apertura di una finestra contenente una richiesta di Nome utente/Password. Una volta che l'utente ha compilato i campi nome utente e password, - l'URL contenente lo script PHP verrà richiamato nuovamente usando le variabili, - $PHP_AUTH_USER, $PHP_AUTH_PW e $PHP_AUTH_TYPE impostate con, rispettivamente: - nome, password e tipo di autenticazione. Solamente il tipo di autenticazione "Basic" + l'URL contenente lo script PHP verrà richiamato nuovamente usando le + <link linkend="reserved.variables">variabili predefinite</link>, <varname>PHP_AUTH_USER</varname>, + <varname>PHP_AUTH_PW</varname> e + <varname>PHP_AUTH_TYPE</varname> impostate con, rispettivamente: + nome, password e tipo di autenticazione. Queste variabili predefinite possono essere trovate + negli array <link linkend="reserved.variables.server">$_SERVER</link> e + <varname>$HTTP_SERVER_VARS</varname>. Solamente il tipo di autenticazione "Basic" è al momento supportato. Fare riferimento alla funzione <function>header</function> - per ulteriori informazioni.</simpara> + per ulteriori informazioni. + </simpara> + <note> + <title>Nota sulla versione di PHP</title> + <para> + Le <link linkend="language.variables.superglobals">variabili autoglobali</link>, + come <link linkend="reserved.variables.server">$_SERVER</link>, esistono + in PHP dalla versione <ulink url="&url.php.release4.1.0;">4.1.0</ulink>. + <varname>$HTTP_SERVER_VARS</varname> è disponibile a partire da PHP 3. + </para> + </note> + <para> Un frammento di script di esempio che richiede l'autenticazione da parte del browser su una pagina, potrebbe essere il seguente: - + </para> + <para> <example> <title>Esempio di Autenticazione HTTP</title> <programlisting role="php"> <![CDATA[ <?php - if (!isset($PHP_AUTH_USER)) { - header("WWW-Authenticate: Basic realm=\"Il mio realm\""); - header("HTTP/1.0 401 Unauthorized"); - echo "Messaggio da inviare se si preme il tasto Cancel\n"; + if (!isset($_SERVER['PHP_AUTH_USER'])) { + header('WWW-Authenticate: Basic realm="Il mio realm"'); + header('HTTP/1.0 401 Unauthorized'); + echo 'Messaggio da inviare se si preme il tasto Cancel'; exit; } else { - echo "<p>Ciao $PHP_AUTH_USER.</p>"; - echo "<p>Hai inserito $PHP_AUTH_PW come tua password.</p>"; + echo "<p>Ciao {$_SERVER['PHP_AUTH_USER']}.</p>"; + echo "<p>Hai inserito {$_SERVER['PHP_AUTH_PW']} come tua password.</p>"; } ?> ]]> </programlisting> - </example></para> + </example> + </para> <note> - <title>Note</title> + <title>Note sulla compatibilità</title> <para> Fare molta attenzione quando si scrive codice per le intestazioni HTTP. Per ottenere la massima compatibilità con tutti i client, la paorla-chiave "Basic" deve essere scritta con una "B" maiuscola, la stringa realm deve essere racchiusa in virgolette doppie (non singole), - ed esattamente uno spazio deve precedere il codice "401" nella linea di intestazione "HTTP/1.0 401". + ed esattamente uno spazio deve precedere il codice <emphasis>401</emphasis> nella linea + di intestazione <emphasis>HTTP/1.0 401</emphasis>. </para> </note> <para> - Invece di stampare semplicemente $PHP_AUTH_USER e - $PHP_AUTH_PW, probabilmente si vorrà controllare la validità dello username e - della password. Probabilemnte inviando una chiamata al database, - o cercando un utente in un file dbm.</para> + Invece di stampare semplicemente <varname>PHP_AUTH_USER</varname> e + <varname>PHP_AUTH_PW</varname>, probabilmente si vorrà controllare + la validità dello username e della password. + Probabilmente inviando una chiamata al database, + o cercando un utente in un file dbm. + </para> <para> Si faccia attenzione ad alcune versioni di Internet Explorer. Sembra che siano molto schizzinosi riguardo all'ordine delle intestazioni. Inviare l'intestazione <emphasis>WWW-Authenticate</emphasis> prima dell'intestazione <literal>HTTP/1.0 401</literal> sembra sistemare le cose per - il momento.</para> + il momento. + </para> <simpara> Al fine di prevenire che qualcuno scriva uno script che rivela la password di una pagina che era stata autenticata tramite un tradizionale meccanismo esterno, le variabili PHP_AUTH non verranno - impostate se è abilitata l'autenticazione esterna per quella determinata - pagina. In questo caso, la variabile $REMOTE_USER può essere usata per - identificare un utente autenticato esternamente.</simpara> + impostate se è abilitata l'autenticazione esterna per quella determinata + pagina. In questo caso, la variabile <varname>REMOTE_USER</varname> può essere + usata per identificare un utente autenticato esternamente. Così, + <varname>$_SERVER['REMOTE_USER']</varname>. + </simpara> <note> <title>Nota sulla Configurazione</title> @@ -84,7 +107,8 @@ <simpara> Si fa notare, però, che quanto scritto sopra non impedisce a qualcuno che controlla un URL non autenticato di sottrarre password da - URL autenticati presenti sullo stesso server.</simpara> + URL autenticati presenti sullo stesso server. + </simpara> <simpara> Sia Netscape Navigator che Internet Explorer cancellano la cache locale della finestra del browser, per quanto riguarda il realm, al ricevimento @@ -92,41 +116,43 @@ che lo forza a reinserire lo username e la password. Alcune persone usano questo per fare il "time out" dei login, o per rendere disponibili bottoni di "log-out". </simpara> - <example> - <title>Esempio di Autenticazione HTTP che impone l'inserimento di nuovo username/password</title> - <programlisting role="php"> + <para> + <example> + <title>Esempio di Autenticazione HTTP che impone l'inserimento di nuovo username/password</title> + <programlisting role="php"> <![CDATA[ <?php function authenticate() { - header( "WWW-Authenticate: Basic realm=\"Prova del Sistema di Autenticazione\""); - header( "HTTP/1.0 401 Unauthorized"); + header('WWW-Authenticate: Basic realm="Prova del Sistema di Autenticazione"'); + header('HTTP/1.0 401 Unauthorized'); echo "Per poter accedere a questa risorsa occorre inserire una coppia login e password valide\n"; exit; } - if (!isset($PHP_AUTH_USER) || ($SeenBefore == 1 && !strcmp($OldAuth, $PHP_AUTH_USER))) { + if (!isset($_SERVER['PHP_AUTH_USER']) || ($_POST['SeenBefore'] == 1 && $_POST['OldAuth'] == $_SERVER['PHP_AUTH_USER'])) { authenticate(); } else { - echo "<p>Benvenuto: $PHP_AUTH_USER<br>"; - echo "Vecchio: $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 "<p>Benvenuto: {$_SERVER['PHP_AUTH_USER']}<br>"; + echo "Vecchio: {$_REQUEST['OldAuth']}"; + echo "<form action='{$_SERVER['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='Ri autentifica'>\n"; echo "</form></p>\n"; } ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> <simpara> - Questo comportamento non è richiesto dallo standard di autenticazione HTTP + Questo comportamento non è richiesto dallo standard di autenticazione HTTP Basic, quindi non si dovrebbe mai fare affidamento su di esso. Test effettuati con Lynx mostrano che Lynx non cancella le credenziali di autenticazione al ricevimento del codice di risposta 401 da parte del server, quindi, premendo indietro e avanti nuovamente, darà nuovamente accesso alla risorsa, ammesso che le rispettive richieste di credenziali - non siano cambiate. L'utente può però premere il + non siano cambiate. L'utente può però premere il tasto '_' al fine di cancellare le sue informazioni di autenticazione. </simpara> <simpara> @@ -135,7 +161,6 @@ </simpara> <note> - <title>Nota</title> <para> Se è abilitato <link linkend="ini.safe-mode">safe mode</link> viene aggiunto lo uid dello script al <literal>realm</literal>