Ignore:
Timestamp:
Nov 13, 2008, 10:28:51 AM (11 years ago)
Author:
julian.reschke@…
Message:

Rewrite header ABNFs to spell out whitespace rules, factor out value format definitions. (related to #36)

File:
1 edited

Legend:

Unmodified
Added
Removed
  • draft-ietf-httpbis/latest/p7-auth.xml

    r345 r365  
    249249  <x:anchor-alias value="challenge"/>
    250250  <x:anchor-alias value="credentials"/>
     251  <x:anchor-alias value="BWS"/>
     252  <x:anchor-alias value="OWS"/>
     253  <x:anchor-alias value="RWS"/>
    251254  The ABNF rules below are defined in other specifications:
    252255</t>
     256<figure><artwork type="abnf2616">
     257  <x:ref>BWS</x:ref>           = &lt;BWS, defined in &basic-rules;&gt;
     258  <x:ref>OWS</x:ref>           = &lt;OWS, defined in &basic-rules;&gt;
     259  <x:ref>RWS</x:ref>           = &lt;RWS, defined in &basic-rules;&gt;
     260</artwork></figure>
    253261<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="challenge"/><iref primary="true" item="Grammar" subitem="credentials"/>
    254262  <x:ref>challenge</x:ref>   = &lt;challenge, defined in <xref target="RFC2617" x:fmt="," x:sec="1.2"/>&gt;
     
    304312  <iref primary="true" item="Headers" subitem="Authorization" x:for-anchor=""/>
    305313  <x:anchor-alias value="Authorization"/>
     314  <x:anchor-alias value="Authorization-v"/>
    306315<t>
    307316      A user agent that wishes to authenticate itself with a server--
    308317      usually, but not necessarily, after receiving a 401 response--does
    309318      so by including an Authorization request-header field with the
    310       request.  The Authorization field value consists of credentials
     319      request.  The field "Authorization" consists of credentials
    311320      containing the authentication information of the user agent for
    312321      the realm of the resource being requested.
    313322</t>
    314 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Authorization"/>
    315   <x:ref>Authorization</x:ref>  = "Authorization" ":" <x:ref>credentials</x:ref>
     323<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Authorization"/><iref primary="true" item="Grammar" subitem="Authorization-v"/>
     324  <x:ref>Authorization</x:ref>   = "Authorization" <x:ref>BWS</x:ref> ":" <x:ref>OWS</x:ref> <x:ref>Authorization-v</x:ref>
     325  <x:ref>Authorization-v</x:ref> = <x:ref>credentials</x:ref>
    316326</artwork></figure>
    317327<t>
     
    359369  <iref primary="true" item="Headers" subitem="Proxy-Authenticate" x:for-anchor=""/>
    360370  <x:anchor-alias value="Proxy-Authenticate"/>
    361 <t>
    362    The Proxy-Authenticate response-header field &MUST; be included as part
     371  <x:anchor-alias value="Proxy-Authenticate-v"/>
     372<t>
     373   The response-header field "Proxy-Authenticate" &MUST; be included as part
    363374   of a 407 (Proxy Authentication Required) response. The field value
    364375   consists of a challenge that indicates the authentication scheme and
    365376   parameters applicable to the proxy for this Request-URI.
    366377</t>
    367 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Proxy-Authenticate"/>
    368   <x:ref>Proxy-Authenticate</x:ref>  = "Proxy-Authenticate" ":" 1#<x:ref>challenge</x:ref>
     378<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Proxy-Authenticate"/><iref primary="true" item="Grammar" subitem="Proxy-Authenticate-v"/>
     379  <x:ref>Proxy-Authenticate</x:ref>   = "Proxy-Authenticate" <x:ref>BWS</x:ref> ":" <x:ref>OWS</x:ref> <x:ref>Proxy-Authenticate-v</x:ref>
     380  <x:ref>Proxy-Authenticate-v</x:ref> = 1#<x:ref>challenge</x:ref>
    369381</artwork></figure>
    370382<t>
     
    384396  <iref primary="true" item="Headers" subitem="Proxy-Authorization" x:for-anchor=""/>
    385397  <x:anchor-alias value="Proxy-Authorization"/>
    386 <t>
    387    The Proxy-Authorization request-header field allows the client to
     398  <x:anchor-alias value="Proxy-Authorization-v"/>
     399<t>
     400   The request-header field "Proxy-Authorization" allows the client to
    388401   identify itself (or its user) to a proxy which requires
    389402   authentication. The Proxy-Authorization field value consists of
     
    391404   agent for the proxy and/or realm of the resource being requested.
    392405</t>
    393 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Proxy-Authorization"/>
    394   <x:ref>Proxy-Authorization</x:ref>     = "Proxy-Authorization" ":" <x:ref>credentials</x:ref>
     406<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Proxy-Authorization"/><iref primary="true" item="Grammar" subitem="Proxy-Authorization-v"/>
     407  <x:ref>Proxy-Authorization</x:ref>     = "Proxy-Authorization" <x:ref>BWS</x:ref> ":" <x:ref>OWS</x:ref> <x:ref>Proxy-Authorization-v</x:ref>
     408  <x:ref>Proxy-Authorization-v</x:ref>   = <x:ref>credentials</x:ref>
    395409</artwork></figure>
    396410<t>
     
    412426  <iref primary="true" item="Headers" subitem="WWW-Authenticate" x:for-anchor=""/>
    413427  <x:anchor-alias value="WWW-Authenticate"/>
     428  <x:anchor-alias value="WWW-Authenticate-v"/>
    414429<t>
    415430   The WWW-Authenticate response-header field &MUST; be included in 401
     
    418433   parameters applicable to the Request-URI.
    419434</t>
    420 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="WWW-Authenticate"/>
    421   <x:ref>WWW-Authenticate</x:ref>  = "WWW-Authenticate" ":" 1#<x:ref>challenge</x:ref>
     435<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="WWW-Authenticate"/><iref primary="true" item="Grammar" subitem="WWW-Authenticate-v"/>
     436  <x:ref>WWW-Authenticate</x:ref>   = "WWW-Authenticate" <x:ref>BWS</x:ref> ":" <x:ref>OWS</x:ref> <x:ref>WWW-Authenticate-v</x:ref>
     437  <x:ref>WWW-Authenticate-v</x:ref> = 1#<x:ref>challenge</x:ref>
    422438</artwork></figure>
    423439<t>
     
    792808<section title="Since draft-ietf-httpbis-p7-auth-04" anchor="changes.since.04">
    793809<t>
     810  Ongoing work on ABNF conversion (<eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/36"/>):
     811  <list style="symbols">
     812    <t>
     813      Use "/" instead of "|" for alternatives.
     814    </t>
     815    <t>
     816      Introduce new ABNF rules for "bad" whitespace ("BWS"), optional
     817      whitespace ("OWS") and required whitespace ("RWS").
     818    </t>
     819    <t>
     820      Rewrite ABNFs to spell out whitespace rules, factor out
     821      header value format definitions.
     822    </t>
     823  </list>
    794824</t>
    795825</section>
Note: See TracChangeset for help on using the changeset viewer.