Table of contents

Appendices

3.12 Specifying HTTP Access Authentication

Description[top]

Every Endpoint component MAY indicate the use of an HTTP access authentication mechanism (as defined by [RFC2616]) for the endpoint described.

This binding specification allows the authentication scheme and realm to be specified.

Relationship to WSDL Component Model[top]

The HTTP binding specification adds the following property to the WSDL component model (as defined in [WSDL-PART1]):

• {http authentication scheme}, a string value to the Endpoint component, corresponding to the HTTP authentication scheme used. The valid values are "basic" for the "basic" authentication scheme defined in [RFC2617], "digest" for the Digest Access Authentication scheme as defined in [RFC2617], and "none" for no access authentication.

• {http authentication realm}, a string value to the Endpoint. It corresponds to the realm authentication parameter defined in [RFC2617]. If the the value of the {http authentication scheme} property is not "none", it MUST not be empty.

XML Representation[top]

<definitions>
  <service>
    <endpoint name="xs:NCName" binding="xs:QName" address="xs:anyURI"? >
              whttp:authenticationType="xs:string"? 
              whttp:authenticationRealm="xs:string"? />
    </endpoint>
  </service>
</definitions>

The XML representation for specifying the use of HTTP access authentication is two OPTIONAL attribute information items with the following Infoset properties:

• An OPTIONAL authenticationType attribute information item with the following Infoset properties:

  • A [local name] of authenticationType

  • A [namespace name] of http://www.w3.org/2004/08/wsdl/http

  • A type of wsdls:string

  • A default value of "none"

• An OPTIONAL authenticationType attribute information item with the following Infoset properties:

  • A [local name] of authenticationRealm

  • A [namespace name] of http://www.w3.org/2004/08/wsdl/http

  • A type of wsdls:string

  • A default value of ""

Mapping Between Component Properties and XML Representation[top]

See [tab_HTTP_Access_Authentication_Mapping].