Changeset 698 for draft-ietf-httpbis/latest/p7-auth.xml

Timestamp:

Sep 26, 2009, 3:09:09 AM (10 years ago)

Author:

julian.reschke@…

Message:

editorial: enhance readability of header introductions

File:

• draft-ietf-httpbis/latest/p7-auth.xml (modified) (5 diffs)

draft-ietf-httpbis/latest/p7-auth.xml

@@ -342 +342 @@
   <x:anchor-alias value="Authorization-v"/>
 <t>
-   A user agent that wishes to authenticate itself with a server--
-   usually, but not necessarily, after receiving a 401 response--does
-   so by including an "Authorization" request-header field with the
-   request.  The field value consists of credentials
-   containing the authentication information of the user agent for
-   the realm of the resource being requested.
+   The "Authorization" request-header field allows a user agent to authenticate
+   itself with a server -- usually, but not necessary, after receiving a 401
+   (Unauthorized) response. Its value consists of credentials containing 
+   information of the user agent for the realm of the resource being
+   requested.
 </t>
 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Authorization"/><iref primary="true" item="Grammar" subitem="Authorization-v"/>
@@ -354 +353 @@
 </artwork></figure>
 <t>
-      HTTP access authentication is described in "HTTP Authentication:
-      Basic and Digest Access Authentication" <xref target="RFC2617"/>. If a request is
-      authenticated and a realm specified, the same credentials &SHOULD;
-      be valid for all other requests within this realm (assuming that
-      the authentication scheme itself does not require otherwise, such
-      as credentials that vary according to a challenge value or using
-      synchronized clocks).
+   HTTP access authentication is described in "HTTP Authentication:
+   Basic and Digest Access Authentication" <xref target="RFC2617"/>. If a request is
+   authenticated and a realm specified, the same credentials &SHOULD;
+   be valid for all other requests within this realm (assuming that
+   the authentication scheme itself does not require otherwise, such
+   as credentials that vary according to a challenge value or using
+   synchronized clocks).
 </t>
 <t>
@@ -399 +398 @@
   <x:anchor-alias value="Proxy-Authenticate-v"/>
 <t>
-   The "Proxy-Authenticate" response-header field &MUST; be included as part
-   of a 407 (Proxy Authentication Required) response. The field value
-   consists of a challenge that indicates the authentication scheme and
-   parameters applicable to the proxy for this request-target.
+   The "Proxy-Authenticate" response-header field consists of a challenge that
+   indicates the authentication scheme and parameters applicable to the proxy
+   for this request-target. It &MUST; be included as part
+   of a 407 (Proxy Authentication Required) response.
 </t>
 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Proxy-Authenticate"/><iref primary="true" item="Grammar" subitem="Proxy-Authenticate-v"/>
@@ -429 +428 @@
    The "Proxy-Authorization" request-header field allows the client to
    identify itself (or its user) to a proxy which requires
-   authentication. The Proxy-Authorization field value consists of
+   authentication. Its value consists of
    credentials containing the authentication information of the user
    agent for the proxy and/or realm of the resource being requested.
@@ -458 +457 @@
   <x:anchor-alias value="WWW-Authenticate-v"/>
 <t>
-   The "WWW-Authenticate" response-header field &MUST; be included in 401
-   (Unauthorized) response messages. The field value consists of at
-   least one challenge that indicates the authentication scheme(s) and
-   parameters applicable to the request-target.
+   The "WWW-Authenticate" response-header field consists of at least one
+   challenge that indicates the authentication scheme(s) and parameters
+   applicable to the request-target. It &MUST; be included in 401
+   (Unauthorized) response messages.
 </t>
 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="WWW-Authenticate"/><iref primary="true" item="Grammar" subitem="WWW-Authenticate-v"/>