Internet Engineering Task Force (IETF)                        J. Howlett
Request for Comments: 7833                                          Jisc
Category: Standards Track                                     S. Hartman
ISSN: 2070-1721                                        Painless Security
                                                   A. Perez-Mendez, Ed.
                                                   University of Murcia
                                                               May 2016


  A RADIUS Attribute, Binding, Profiles, Name Identifier Format, and
Confirmation Methods for the Security Assertion Markup Language (SAML)

Abstract

  This document describes the use of the Security Assertion Markup
  Language (SAML) with RADIUS in the context of the Application
  Bridging for Federated Access Beyond web (ABFAB) architecture.  It
  defines two RADIUS attributes, a SAML binding, a SAML name identifier
  format, two SAML profiles, and two SAML confirmation methods.  The
  RADIUS attributes permit encapsulation of SAML Assertions and
  protocol messages within RADIUS, allowing SAML entities to
  communicate using the binding.  The two profiles describe the
  application of this binding for ABFAB authentication and assertion
  Query/Request, enabling a Relying Party to request authentication of,
  or assertions for, users or machines (clients).  These clients may be
  named using a Network Access Identifier (NAI) name identifier format.
  Finally, the subject confirmation methods allow requests and queries
  to be issued for a previously authenticated user or machine without
  needing to explicitly identify them as the subject.  The use of the
  artifacts defined in this document is not exclusive to ABFAB.  They
  can be applied in any Authentication, Authorization, and Accounting
  (AAA) scenario, such as network access control.

Status of This Memo

  This is an Internet Standards Track document.

  This document is a product of the Internet Engineering Task Force
  (IETF).  It represents the consensus of the IETF community.  It has
  received public review and has been approved for publication by the
  Internet Engineering Steering Group (IESG).  Further information on
  Internet Standards is available in Section 2 of RFC 5741.

  Information about the current status of this document, any errata,
  and how to provide feedback on it may be obtained at
  http://www.rfc-editor.org/info/rfc7833.





Howlett, et al.              Standards Track                    [Page 1]

RFC 7833                       SAML RADIUS                      May 2016


Copyright Notice

  Copyright (c) 2016 IETF Trust and the persons identified as the
  document authors.  All rights reserved.

  This document is subject to BCP 78 and the IETF Trust's Legal
  Provisions Relating to IETF Documents
  (http://trustee.ietf.org/license-info) in effect on the date of
  publication of this document.  Please review these documents
  carefully, as they describe your rights and restrictions with respect
  to this document.  Code Components extracted from this document must
  include Simplified BSD License text as described in Section 4.e of
  the Trust Legal Provisions and are provided without warranty as
  described in the Simplified BSD License.

Table of Contents

  1. Introduction ....................................................3
     1.1. Terminology ................................................5
  2. Conventions .....................................................5
  3. RADIUS SAML Attributes ..........................................5
     3.1. SAML-Assertion Attribute ...................................6
     3.2. SAML-Protocol Attribute ....................................7
  4. SAML RADIUS Binding .............................................8
     4.1. Required Information .......................................8
     4.2. Operation ..................................................8
     4.3. Processing of Names ........................................9
          4.3.1. AAA Names ..........................................10
          4.3.2. SAML Names .........................................10
          4.3.3. Mapping of AAA Names in SAML Metadata ..............11
          4.3.4. Example of SAML Metadata That Includes AAA Names ...13
     4.4. Use of XML Signatures .....................................14
     4.5. Metadata Considerations ...................................14
  5. Network Access Identifier Name Identifier Format ...............14
  6. RADIUS State Confirmation Method Identifiers ...................15
  7. ABFAB Authentication Profile ...................................15
     7.1. Required Information ......................................15
     7.2. Profile Overview ..........................................16
     7.3. Profile Description .......................................18
          7.3.1. Client Request to Relying Party ....................18
          7.3.2. Relying Party Issues <samlp:AuthnRequest>
                 to Identity Provider ...............................18
          7.3.3. Identity Provider Identifies Client ................18
          7.3.4. Identity Provider Issues <samlp:Response>
                 to Relying Party ...................................19
          7.3.5. Relying Party Grants or Denies Access to Client ....19





Howlett, et al.              Standards Track                    [Page 2]

RFC 7833                       SAML RADIUS                      May 2016


     7.4. Use of Authentication Request Protocol ....................19
          7.4.1. <samlp:AuthnRequest> Usage .........................19
          7.4.2. <samlp:Response> Message Usage .....................20
          7.4.3. <samlp:Response> Message Processing Rules ..........20
          7.4.4. Unsolicited Responses ..............................21
          7.4.5. Use of the SAML RADIUS Binding .....................21
          7.4.6. Use of XML Signatures ..............................21
          7.4.7. Metadata Considerations ............................21
  8. ABFAB Assertion Query/Request Profile ..........................21
     8.1. Required Information ......................................22
     8.2. Profile Overview ..........................................22
     8.3. Profile Description .......................................23
          8.3.1. Differences from the SAML V2.0 Assertion
                 Query/Request Profile ..............................23
          8.3.2. Use of the SAML RADIUS Binding .....................23
          8.3.3. Use of XML Signatures ..............................24
          8.3.4. Metadata Considerations ............................24
  9. Privacy Considerations .........................................24
  10. Security Considerations .......................................25
  11. IANA Considerations ...........................................25
     11.1. RADIUS Attributes ........................................25
     11.2. ABFAB Parameters .........................................26
     11.3. Registration of the ABFAB URN Namespace ..................27
  12. References ....................................................27
     12.1. Normative References .....................................27
     12.2. Informative References ...................................29
  Appendix A. XML Schema ............................................30
  Acknowledgments ...................................................32
  Authors' Addresses ................................................32

1.  Introduction

  Within the ABFAB (Application Bridging for Federated Access Beyond
  web) architecture [RFC7831], it is often desirable to convey Security
  Assertion Markup Language (SAML) Assertions and protocol messages.

  SAML typically only considers the use of HTTP-based transports, known
  as bindings [OASIS.saml-bindings-2.0-os], which are primarily
  intended for use with the SAML V2.0 web browser single sign-on
  profile [OASIS.saml-profiles-2.0-os].  However, the goal of ABFAB is
  to extend the applicability of federated identity beyond the web to
  other applications by building on the Authentication, Authorization,
  and Accounting (AAA) framework.  Consequently, there exists a
  requirement for SAML to integrate with the AAA framework and with
  protocols such as RADIUS [RFC2865] and Diameter [RFC6733], in
  addition to HTTP.





Howlett, et al.              Standards Track                    [Page 3]

RFC 7833                       SAML RADIUS                      May 2016


  In summary, this document specifies:

  o  Two RADIUS attributes to encapsulate SAML Assertions and protocol
     messages, respectively.

  o  A SAML RADIUS binding that defines how SAML Assertions and
     protocol messages can be transported by RADIUS within a SAML
     exchange.

  o  A SAML name identifier format in the form of a Network Access
     Identifier.

  o  A profile of the SAML Authentication Request Protocol that uses
     the SAML RADIUS binding to effect SAML-based authentication and
     authorization.

  o  A profile of the SAML Assertion Query and Request Protocol that
     uses the SAML RADIUS binding to effect the query and request of
     SAML Assertions.

  o  Two SAML subject confirmation methods for indicating that a user
     or machine client is the subject of an assertion.

  This document adheres to the guidelines stipulated by
  [OASIS.saml-bindings-2.0-os] and [OASIS.saml-profiles-2.0-os] for
  defining new SAML bindings and profiles, respectively, and other
  conventions applied formally or otherwise within SAML.  In
  particular, this document provides a "Required Information" section
  for the binding (Section 4.1) and profiles (Sections 7.1 and 8.1)
  that enumerate:

  o  A URI that uniquely identifies the protocol binding or profile.

  o  Postal or electronic contact information for the author.

  o  A reference to previously defined bindings or profiles that the
     new binding updates or obsoletes.

  o  In the case of a profile, any SAML confirmation method identifiers
     defined and/or utilized by the profile.











Howlett, et al.              Standards Track                    [Page 4]

RFC 7833                       SAML RADIUS                      May 2016


1.1.  Terminology

  This document uses terminology from a number of related standards
  that tend to adopt different terms for similar or identical concepts.
  In general, this document uses, when possible, the ABFAB term for the
  entity, as described in [RFC7831].  For reference, we include the
  following table, which maps the different terms into a single view.
  (In this document, "NAS" refers to a network access server, and "AS"
  refers to an authentication server.)

     +----------+-----------+------------------+-------------------+
     | Protocol | Client    | Relying Party    | Identity Provider |
     +----------+-----------+------------------+-------------------+
     | ABFAB    | Client    | Relying Party    | Identity Provider |
     |          |           |                  |                   |
     | SAML     | Subject   | Service Provider | Identity Provider |
     |          | Principal | Requester        | Responder         |
     |          |           | Consumer         | Issuer            |
     |          |           |                  |                   |
     | RADIUS   | User      | NAS              | AS                |
     |          |           | RADIUS client    | RADIUS server     |
     +----------+-----------+------------------+-------------------+

                          Table 1: Terminology

2.  Conventions

  The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
  "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
  document are to be interpreted as described in RFC 2119 [RFC2119].

3.  RADIUS SAML Attributes

  The SAML RADIUS binding defined in Section 4 of this document uses
  two attributes to convey SAML Assertions and protocol messages
  [OASIS.saml-core-2.0-os].  Owing to the typical size of these
  structures, these attributes use the "Long Extended Type" format
  [RFC6929] to encapsulate their data.  RADIUS entities MUST NOT
  include both attributes in the same RADIUS message, as they represent
  exclusive alternatives to convey SAML information.











Howlett, et al.              Standards Track                    [Page 5]

RFC 7833                       SAML RADIUS                      May 2016


3.1.  SAML-Assertion Attribute

  This attribute is used to encode a SAML Assertion.  Figure 1
  represents the format of this attribute.

                         1                   2                   3
     0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |   Type        |    Length     | Extended-Type |M|  Reserved   |
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |   Value...
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                     Figure 1: SAML-Assertion Format

  Type

     245

  Length

     >= 5

  Extended-Type

     1

  M (More)

     As described in [RFC6929].

  Reserved

     As described in [RFC6929].

  Value

     One or more octets encoding a SAML Assertion.













Howlett, et al.              Standards Track                    [Page 6]

RFC 7833                       SAML RADIUS                      May 2016


3.2.  SAML-Protocol Attribute

  This attribute is used to encode a SAML protocol message.  Figure 2
  represents the format of this attribute.

                         1                   2                   3
     0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |   Type        |    Length     | Extended-Type |M|  Reserved   |
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |   Value...
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                     Figure 2: SAML-Protocol Format

  Type

     245

  Length

     >= 5

  Extended-Type

     2

  M (More)

     As described in [RFC6929].

  Reserved

     As described in [RFC6929].

  Value

     One or more octets encoding a SAML protocol message.













Howlett, et al.              Standards Track                    [Page 7]

RFC 7833                       SAML RADIUS                      May 2016


4.  SAML RADIUS Binding

  The SAML RADIUS binding defines how RADIUS [RFC2865] can be used to
  enable a RADIUS client and server to exchange SAML Assertions and
  protocol messages.

4.1.  Required Information

  Identification: urn:ietf:params:abfab:bindings:radius

  Contact information: [email protected]

  Updates: None.

4.2.  Operation

  In this specification, the Relying Party (RP) MUST trust any
  statement in the SAML messages from the Identity Provider (IdP) in
  the same way that it trusts information contained in RADIUS
  attributes.  These entities MUST trust the RADIUS infrastructure to
  provide integrity of the SAML messages.

  Hence, it is REQUIRED that the RADIUS exchange be protected using
  Transport Layer Security (TLS) encryption for RADIUS [RFC6614] to
  provide confidentiality and integrity protection, unless alternative
  methods to ensure them are used, such as IPsec tunnels or a
  sufficiently secure internal network.

  Implementations of this profile can take advantage of mechanisms to
  permit the transport of longer SAML messages over RADIUS transports,
  such as the support of fragmentation of RADIUS packets [RFC7499] or
  larger packets for RADIUS over TCP [RADIUS-Large-Pkts].

  There are two system models for the use of SAML over RADIUS.  The
  first is a request-response model, using the RADIUS SAML-Protocol
  attribute defined in Section 3 to encapsulate the SAML protocol
  messages.

  1.  The RADIUS client, acting as an RP, transmits a SAML request
      element within a RADIUS Access-Request message.  This message
      MUST include a single instance of the RADIUS User-Name attribute
      whose value MUST conform to the Network Access Identifier
      [RFC7542] scheme.  The RP MUST NOT include more than one SAML
      request element.







Howlett, et al.              Standards Track                    [Page 8]

RFC 7833                       SAML RADIUS                      May 2016


  2.  The RADIUS server, acting as an IdP, returns a SAML protocol
      message within a RADIUS Access-Accept or Access-Reject message.
      These messages necessarily conclude a RADIUS exchange, and
      therefore this is the only opportunity for the IdP to send a
      response in the context of this exchange.  The IdP MUST NOT
      include more than one SAML response.  An IdP that refuses to
      perform a message exchange with the RP can silently discard the
      SAML request (this could subsequently be followed by a RADIUS
      Access-Reject, as the same conditions that cause the IdP to
      discard the SAML request may also cause the RADIUS server to fail
      to authenticate).

  The second system model permits a RADIUS server acting as an IdP to
  use the RADIUS SAML-Assertion attribute defined in Section 3 to
  encapsulate an unsolicited SAML Assertion.  This attribute MUST be
  included in a RADIUS Access-Accept message.  When included, the
  attribute MUST contain a single SAML Assertion.

  RADIUS servers MUST NOT include both the SAML-Protocol and the
  SAML-Assertion attribute in the same RADIUS message.  If an IdP is
  producing a response to a SAML request, then the first system model
  is used.  An IdP MAY ignore a SAML request and send an unsolicited
  assertion using the second system model (that is, using the RADIUS
  SAML-Assertion attribute).

  In either system model, IdPs SHOULD return a RADIUS State attribute
  as part of the Access-Accept message so that future SAML queries or
  requests can be run against the same context of an authentication
  exchange.

  This binding is intended to be composed with other uses of RADIUS,
  such as network access.  Therefore, other arbitrary RADIUS attributes
  MAY be used in either the request or response.

  In the case of a SAML processing error, the RADIUS server MAY include
  a SAML response message with an appropriate value for the
  <samlp:Status> element within the Access-Accept or Access-Reject
  packet to notify the client.  Alternatively, the RADIUS server can
  respond without a SAML-Protocol attribute.

4.3.  Processing of Names

  SAML entities using profiles making use of this binding will
  typically possess both the SAML and AAA names of their
  correspondents.  Frequently, these entities will need to apply
  policies using these names -- for example, when deciding to release
  attributes.  Often, these policies will be security-sensitive, and so
  it is important that policy is applied on these names consistently.



Howlett, et al.              Standards Track                    [Page 9]

RFC 7833                       SAML RADIUS                      May 2016


4.3.1.  AAA Names

  These rules relate to the processing of AAA names by SAML entities
  using profiles making use of this binding.

  o  IdPs SHOULD apply policy based on the RP's identity associated
     with the RADIUS Access-Request.

  o  RPs SHOULD apply policy based on the NAI realm associated with the
     RADIUS Access-Accept.

4.3.2.  SAML Names

  These rules relate to the processing of SAML names by SAML entities
  using profiles making use of this binding.

  IdPs MAY apply policy based on the RP's SAML entityID.  In such
  cases, at least one of the following methods is required in order to
  establish a relationship between the SAML name and the AAA name of
  the RP:

  o  RADIUS client identity in trusted SAML metadata (as described in
     Section 4.3.3).

  o  RADIUS client identity in trusted digitally signed SAML request.

  A digitally signed SAML request without the RADIUS client identity is
  not sufficient, since a malicious RADIUS entity can observe a SAML
  message and include it in a different RADIUS message without the
  consent of the issuer of that SAML message.  If an IdP were to
  process the SAML message without confirming that it applied to the
  RADIUS message, inappropriate policy would be used.

  RPs MAY apply policy based on the SAML issuer's entityID.  In such
  cases, at least one of the following methods is required in order to
  establish a relationship between the SAML name and the AAA name of
  the IdP:

  o  RADIUS realm in trusted SAML metadata (as described in
     Section 4.3.3).

  o  RADIUS realm in trusted digitally signed SAML response or
     assertion.

  A digitally signed SAML response alone is not sufficient, for the
  same reasons as those described above for SAML requests.





Howlett, et al.              Standards Track                   [Page 10]

RFC 7833                       SAML RADIUS                      May 2016


4.3.3.  Mapping of AAA Names in SAML Metadata

  This section defines extensions to the SAML metadata schema
  [OASIS.saml-metadata-2.0-os] that are required in order to represent
  AAA names associated with a particular <EntityDescriptor> element.

  In SAML metadata, a single entity may act in many different roles in
  the support of multiple profiles.  This document defines two new
  roles: RADIUS IdP and RADIUS RP, requiring the declaration of two new
  subtypes of RoleDescriptorType: RADIUSIDPDescriptorType and
  RADIUSRPDescriptorType.  These subtypes contain the additional
  elements required to represent AAA names for IdP and RP entities,
  respectively.

4.3.3.1.  RADIUSIDPDescriptorType

  The RADIUSIDPDescriptorType complex type extends RoleDescriptorType
  with elements common to IdPs that support RADIUS.  It contains the
  following additional elements:

  <RADIUSIDPService> [Zero or More]  Zero or more elements of type
     EndpointType that describe RADIUS endpoints that are associated
     with the entity.

  <RADIUSRealm> [Zero or More]  Zero or more elements of type string
     that represent the acceptable values of the RADIUS realm
     associated with the entity, obtained from the realm part of the
     RADIUS User-Name attribute.























Howlett, et al.              Standards Track                   [Page 11]

RFC 7833                       SAML RADIUS                      May 2016


  The following schema fragment defines the RADIUSIDPDescriptorType
  complex type:

          <complexType name="RADIUSIDPDescriptorType">
            <complexContent>
              <extension base="md:RoleDescriptorType">
                <sequence>
                  <element ref="abfab:RADIUSIDPService"
                                minOccurs="0" maxOccurs="unbounded"/>
                  <element ref="abfab:RADIUSRealm"
                                minOccurs="0" maxOccurs="unbounded"/>
                </sequence>
              </extension>
            </complexContent>
          </complexType>
          <element name="RADIUSIDPService" type="md:EndpointType"/>
          <element name="RADIUSRealm" type="string"/>

                Figure 3: RADIUSIDPDescriptorType Schema

4.3.3.2.  RADIUSRPDescriptorType

  The RADIUSRPDescriptorType complex type extends RoleDescriptorType
  with elements common to RPs that support RADIUS.  It contains the
  following additional elements:

  <RADIUSRPService> [Zero or More]  Zero or more elements of type
     EndpointType that describe RADIUS endpoints that are associated
     with the entity.

  <RADIUSNasIpAddress> [Zero or More]  Zero or more elements of type
     string that represent the acceptable values of the RADIUS
     NAS-IP-Address or NAS-IPv6-Address attributes associated with the
     entity.

  <RADIUSNasIdentifier> [Zero or More]  Zero or more elements of type
     string that represent the acceptable values of the RADIUS
     NAS-Identifier attribute associated with the entity.

  <RADIUSGssEapName> [Zero or More]  Zero or more elements of type
     string that represent the acceptable values of the GSS-API
     Mechanism for the Extensible Authentication Protocol (GSS-EAP)
     acceptor name associated with the entity.  The format for this
     name is described in Section 3.1 of [RFC7055], while Section 3.4
     of [RFC7055] describes how that name is decomposed and transported
     using RADIUS attributes.





Howlett, et al.              Standards Track                   [Page 12]

RFC 7833                       SAML RADIUS                      May 2016


  The following schema fragment defines the RADIUSRPDescriptorType
  complex type:

      <complexType name="RADIUSRPDescriptorType">
        <complexContent>
          <extension base="md:RoleDescriptorType">
            <sequence>
              <element ref="md:RADIUSRPService"
                            minOccurs="0" maxOccurs="unbounded"/>
              <element ref="md:RADIUSNasIpAddress"
                            minOccurs="0" maxOccurs="unbounded"/>
              <element ref="md:RADIUSNasIdentifier"
                            minOccurs="0" maxOccurs="unbounded"/>
              <element ref="md:RADIUSGssEapName"
                            minOccurs="0" maxOccurs="unbounded"/>
            </sequence>
          </extension>
        </complexContent>
      </complexType>
      <element name="RADIUSRPService" type="md:EndpointType"/>
      <element name="RADIUSNasIpAddress" type="string"/>
      <element name="RADIUSNasIdentifier" type="string"/>
      <element name="RADIUSGssEapName" type="string"/>

                 Figure 4: RADIUSRPDescriptorType Schema

4.3.4.  Example of SAML Metadata That Includes AAA Names

  Figures 5 and 6 illustrate examples of metadata that includes AAA
  names for an IdP and an RP, respectively.  The IdP's SAML name is
  "https://IdentityProvider.com/", whereas its RADIUS realm is
  "idp.com".  The RP's SAML name is "https://RelyingParty.com/SAML",
  being its GSS-EAP acceptor name "nfs/[email protected]".

<EntityDescriptor
  xmlns="urn:oasis:names:tc:SAML:2.0:metadata"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:abfab="urn:ietf:params:xml:ns:abfab"
  entityID="https://IdentityProvider.com/SAML">
  <RoleDescriptor
     xsi:type="abfab:RADIUSIDPDescriptorType"
     protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol">
      <RADIUSRealm>idp.com</RADIUSRealm>
  </RoleDescriptor>
</EntityDescriptor>

                     Figure 5: Metadata for the IdP




Howlett, et al.              Standards Track                   [Page 13]

RFC 7833                       SAML RADIUS                      May 2016


<EntityDescriptor
  xmlns="urn:oasis:names:tc:SAML:2.0:metadata"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:abfab="urn:ietf:params:xml:ns:abfab"
  entityID="https://RelyingParty.com/SAML">
  <RoleDescriptor
     xsi:type="abfab:RADIUSRPDescriptorType"
     protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol">
      <RADIUSGssEapName>nfs/[email protected]</RADIUSGssEapName>
  </RoleDescriptor>
</EntityDescriptor>

                      Figure 6: Metadata for the RP

4.4.  Use of XML Signatures

  This binding calls for the use of SAML elements that support XML
  signatures.  To promote interoperability, implementations of this
  binding MUST support a default configuration that does not require
  the use of XML signatures.  Implementations MAY choose to use XML
  signatures.

4.5.  Metadata Considerations

  This binding, and the profiles, are mostly intended to be used
  without metadata.  In this usage, RADIUS infrastructure is used to
  provide integrity and naming of the SAML messages and assertions.
  RADIUS configuration is used to provide policy, including which
  attributes are accepted from an RP and which attributes are sent by
  an IdP.

  Nevertheless, if metadata is used, the roles described in
  Section 4.3.3 MUST be present.

5.  Network Access Identifier Name Identifier Format

  URI: urn:ietf:params:abfab:nameid-format:nai

  Indicates that the content of the element is in the form of a Network
  Access Identifier (NAI) using the syntax described by [RFC7542].











Howlett, et al.              Standards Track                   [Page 14]

RFC 7833                       SAML RADIUS                      May 2016


6.  RADIUS State Confirmation Method Identifiers

  URI: urn:ietf:params:abfab:cm:user

  URI: urn:ietf:params:abfab:cm:machine

  Indicates that the subject is the system entity (either the user or
  machine) authenticated by a previously transmitted RADIUS
  Access-Accept message, as identified by the value of that RADIUS
  message's State attribute.

7.  ABFAB Authentication Profile

  In the scenario supported by the ABFAB Authentication Profile, a
  client controlling a User Agent requests access to an RP.  The RP
  uses RADIUS to authenticate the client.  In particular, the RP,
  acting as a RADIUS client, attempts to validate the client's
  credentials against a RADIUS server acting as the client's IdP.  If
  the IdP successfully authenticates the client, it produces an
  authentication assertion that is consumed by the RP.  This assertion
  MAY include a name identifier that can be used between the RP and the
  IdP to refer to the client.

7.1.  Required Information

  Identification: urn:ietf:params:abfab:profiles:authentication

  Contact information: [email protected]

  SAML confirmation method identifiers: The SAML V2.0 "RADIUS State"
  confirmation method identifiers -- either
  urn:ietf:params:abfab:cm:user or urn:ietf:params:abfab:cm:machine --
  are used by this profile.

  Updates: None.
















Howlett, et al.              Standards Track                   [Page 15]

RFC 7833                       SAML RADIUS                      May 2016


7.2.  Profile Overview

  To implement this scenario, this profile of the SAML Authentication
  Request Protocol MUST be used in conjunction with the SAML RADIUS
  binding defined in Section 4.

  This profile is based on the SAML V2.0 web browser single sign-on
  profile [OASIS.saml-profiles-2.0-os].  There are some important
  differences; specifically:

  Authentication:  This profile does not require the use of any
     particular authentication method.  The ABFAB architecture does
     require the use of the Extensible Authentication Protocol (EAP)
     [RFC3579], but this specification may be used in other non-ABFAB
     scenarios.

  Bindings:  This profile does not use HTTP-based bindings.  Instead,
     all SAML protocol messages are transported using the SAML RADIUS
     binding defined in Section 4.  This is intended to reduce the
     number of bindings that implementations must support to be
     interoperable.

  Requests:  The profile does not permit the RP to name the
     <saml:Subject> of the <samlp:AuthnRequest>.  This is intended to
     simplify implementation and interoperability.

  Responses:  The profile only permits the IdP to return a single SAML
     message or assertion that MUST contain exactly one authentication
     statement.  Other statements may be included within this assertion
     at the discretion of the IdP.  This is intended to simplify
     implementation and interoperability.




















Howlett, et al.              Standards Track                   [Page 16]

RFC 7833                       SAML RADIUS                      May 2016


  Figure 7 below illustrates the flow of messages within this profile.

      Client            Relying Party             Identity Provider
        |                     |                           |
        |         (1)         |                           |
        | - - - - - - - - - > |                           |
        |                     |                           |
        |                     |            (2)            |
        |                     | - - - - - - - - - - - - > |
        |                     |                           |
        |              (3)    |                           |
        | < - - - - - - - - - |- - - - - - - - - - - - - >|
        |                     |                           |
        |                     |            (4)            |
        |                     | < - - - - - - - - - - - - |
        |                     |                           |
        |         (5)         |                           |
        | < - - - - - - - - - |                           |
        |                     |                           |
        V                     V                           V

                       Figure 7: Flow of Messages

  The following steps are described by the profile.  Within an
  individual step, there may be one or more actual message exchanges.

  1.  Client request to RP (Section 7.3.1): In step 1, the client, via
      a User Agent, makes a request for a secured resource at the RP.
      The RP determines that no security context for the client exists
      and initiates the authentication process.

  2.  RP issues <samlp:AuthnRequest> to IdP (Section 7.3.2).  In step
      2, the RP may optionally issue a <samlp:AuthnRequest> message to
      be delivered to the IdP using the SAML-Protocol RADIUS attribute.

  3.  IdP identifies client (Section 7.3.3).  In step 3, the client is
      authenticated and identified by the IdP, while honoring any
      requirements imposed by the RP in the <samlp:AuthnRequest>
      message if provided.

  4.  IdP issues <samlp:Response> to RP (Section 7.3.4).  In step 4,
      the IdP issues a <samlp:Response> message to the RP using the
      SAML RADIUS binding.  The response either indicates an error or
      includes a SAML authentication statement in exactly one SAML
      Assertion.  If the RP did not send a <samlp:AuthnRequest>, the
      IdP issues an unsolicited <samlp:Assertion>, as described in
      Section 7.4.4.




Howlett, et al.              Standards Track                   [Page 17]

RFC 7833                       SAML RADIUS                      May 2016


  5.  RP grants or denies access to client (Section 7.3.5).  In step 5,
      having received the response from the IdP, the RP can respond to
      the client with its own error, or can establish its own security
      context for the client and return the requested resource.

7.3.  Profile Description

  The ABFAB Authentication Profile is a profile of the SAML V2.0
  Authentication Request Protocol [OASIS.saml-core-2.0-os].  Where both
  specifications conflict, the ABFAB Authentication Profile takes
  precedence.

7.3.1.  Client Request to Relying Party

  The profile is initiated by an arbitrary client request to the RP.
  There are no restrictions on the form of the request.  The RP is free
  to use any means it wishes to associate the subsequent interactions
  with the original request.  The RP, acting as a RADIUS client,
  attempts to authenticate the client.

7.3.2.  Relying Party Issues <samlp:AuthnRequest> to Identity Provider

  The RP uses RADIUS to communicate with the client's IdP.  The RP MAY
  include a <samlp:AuthnRequest> within this RADIUS Access-Request
  message using the SAML-Protocol RADIUS attribute.  The "next hop"
  destination MAY be the IdP or, alternatively, an intermediate RADIUS
  proxy.

  Profile-specific rules for the contents of the <samlp:AuthnRequest>
  element are given in Section 7.4.1.

7.3.3.  Identity Provider Identifies Client

  The IdP MUST establish the identity of the client using a RADIUS
  authentication method, or else it will return an error.  If the
  ForceAuthn attribute in the <samlp:AuthnRequest> element (if sent by
  the RP) is present and true, the IdP MUST freshly establish this
  identity rather than relying on any existing session state it may
  have with the client (for example, TLS state that may be used for
  session resumption).  Otherwise, and in all other respects, the IdP
  may use any method to authenticate the client, subject to the
  constraints called out in the <samlp:AuthnRequest> message.









Howlett, et al.              Standards Track                   [Page 18]

RFC 7833                       SAML RADIUS                      May 2016


7.3.4.  Identity Provider Issues <samlp:Response> to Relying Party

  The IdP MUST conclude the authentication in a manner consistent with
  the RADIUS authentication result.  The IdP MAY issue a
  <samlp:Response> message to the RP that is consistent with the
  authentication result, as described in [OASIS.saml-core-2.0-os].
  This SAML response is delivered to the RP using the SAML RADIUS
  binding described in Section 4.

  Profile-specific rules regarding the contents of the <samlp:Response>
  element are given in Section 7.4.2.

7.3.5.  Relying Party Grants or Denies Access to Client

  If a <samlp:Response> message is issued by the IdP, the RP MUST
  process that message and any enclosed assertion elements as described
  in [OASIS.saml-core-2.0-os].  Any subsequent use of the assertion
  elements is at the discretion of the RP, subject to any restrictions
  contained within the assertions themselves or from any previously
  established out-of-band policy that governs the interaction between
  the IdP and the RP.

7.4.  Use of Authentication Request Protocol

  This profile is based on the Authentication Request Protocol defined
  in [OASIS.saml-core-2.0-os].  In the nomenclature of actors
  enumerated in Section 3.4 of that document, the RP is the requester,
  the User Agent is the attesting entity, and the client is the
  subject.

7.4.1.  <samlp:AuthnRequest> Usage

  The RP MUST NOT include a <saml:Subject> element in the request.  The
  authenticated RADIUS identity identifies the client to the IdP.

  An RP MAY include any message content described in Section 3.4.1 of
  [OASIS.saml-core-2.0-os].  All processing rules are as defined in
  [OASIS.saml-core-2.0-os].

  If the RP wishes to permit the IdP to establish a new identifier for
  the client if none exists, it MUST include a <saml:NameIDPolicy>
  element with the AllowCreate attribute set to "true".  Otherwise,
  only a client for whom the IdP has previously established an
  identifier usable by the RP can be authenticated successfully.

  The <samlp:AuthnRequest> message MAY be signed.  Authentication and
  integrity are also provided by the SAML RADIUS binding.




Howlett, et al.              Standards Track                   [Page 19]

RFC 7833                       SAML RADIUS                      May 2016


7.4.2.  <samlp:Response> Message Usage

  If the IdP cannot or will not satisfy the request, it MUST respond
  with a <samlp:Response> message containing an appropriate error
  status code or codes and/or respond with a RADIUS Access-Reject
  message.

  If the IdP wishes to return an error, it MUST NOT include any
  assertions in the <samlp:Response> message.  Otherwise, if the
  request is successful (or if the response is not associated with a
  request), the <samlp:Response> element is subject to the following
  constraints:

  o  It MAY be signed.

  o  It MUST contain exactly one assertion.  The <saml:Subject> element
     of this assertion MUST refer to the authenticated RADIUS user.

  o  The assertion MUST contain a <saml:AuthnStatement>.  Also, the
     assertion MUST contain a <saml:Subject> element with at least one
     <saml:SubjectConfirmation> element containing a
     <saml:ConfirmationMethod> element of urn:ietf:params:abfab:cm:user
     or urn:ietf:params:abfab:cm:machine that reflects the
     authentication of the client to the IdP.  Since the
     <samlp:Response> message is in response to a <samlp:AuthnRequest>,
     the InResponseTo attribute (in both the
     <saml:SubjectConfirmationData> and <saml:Response> elements) MUST
     match the request's ID.  The <saml:Subject> element MAY use the
     NAI name identifier format described in Section 5 to establish an
     identifier between the RP and the IdP.

  o  Other conditions MAY be included as requested by the RP or at the
     discretion of the IdP.  The IdP is NOT obligated to honor the
     requested set of conditions in the <samlp:AuthnRequest>, if any.

7.4.3.  <samlp:Response> Message Processing Rules

  The RP MUST do the following:

  o  Assume that the client's identifier implied by a SAML <Subject>
     element, if present, takes precedence over an identifier implied
     by the RADIUS User-Name attribute.

  o  Verify that the InResponseTo attribute in the "RADIUS State"
     <saml:SubjectConfirmationData> equals the ID of its original
     <samlp:AuthnRequest> message, unless the response is unsolicited,
     in which case the attribute MUST NOT be present.




Howlett, et al.              Standards Track                   [Page 20]

RFC 7833                       SAML RADIUS                      May 2016


  o  If a <saml:AuthnStatement> used to establish a security context
     for the client contains a SessionNotOnOrAfter attribute, the
     security context SHOULD be discarded once this time is reached,
     unless the RP reestablishes the client's identity by repeating the
     use of this profile.

  o  Verify that any assertions relied upon are valid according to
     processing rules specified in [OASIS.saml-core-2.0-os].

  o  Any assertion that is not valid or whose subject confirmation
     requirements cannot be met MUST be discarded and MUST NOT be used
     to establish a security context for the client.

7.4.4.  Unsolicited Responses

  An IdP MAY initiate this profile by delivering an unsolicited
  assertion to an RP.  This MUST NOT contain any
  <saml:SubjectConfirmationData> elements containing an InResponseTo
  attribute.

7.4.5.  Use of the SAML RADIUS Binding

  It is RECOMMENDED that the RADIUS exchange be protected using TLS
  encryption for RADIUS [RFC6614] to provide confidentiality and
  integrity protection.

7.4.6.  Use of XML Signatures

  This profile calls for the use of SAML elements that support XML
  signatures.  To promote interoperability, implementations of this
  profile MUST NOT require the use of XML signatures.  Implementations
  MAY choose to use XML signatures.

7.4.7.  Metadata Considerations

  There are no metadata considerations particular to this profile,
  aside from those applying to the use of the RADIUS binding.

8.  ABFAB Assertion Query/Request Profile

  This profile builds on the SAML V2.0 Assertion Query/Request Profile
  defined by [OASIS.saml-profiles-2.0-os].  That profile describes the
  use of the Assertion Query and Request Protocol defined by
  Section 3.3 of [OASIS.saml-core-2.0-os] with synchronous bindings,
  such as the SOAP binding defined in [OASIS.saml-bindings-2.0-os].






Howlett, et al.              Standards Track                   [Page 21]

RFC 7833                       SAML RADIUS                      May 2016


  Although the SAML V2.0 Assertion Query/Request Profile is independent
  of the underlying binding, it is nonetheless useful to describe the
  use of the SAML RADIUS binding defined in Section 4 of this document,
  in the interest of promoting interoperable implementations,
  particularly as the SAML V2.0 Assertion Query/Request Profile is most
  frequently discussed and implemented in the context of the SOAP
  binding.

8.1.  Required Information

  Identification: urn:ietf:params:abfab:profiles:query

  Contact information: [email protected]

  Description: Given below.

  Updates: None.

8.2.  Profile Overview

  As with the SAML V2.0 Assertion Query/Request Profile defined by
  [OASIS.saml-profiles-2.0-os], the message exchange and basic
  processing rules that govern this profile are largely defined by
  Section 3.3 of [OASIS.saml-core-2.0-os], which defines the messages
  to be exchanged, in combination with the binding used to exchange the
  messages.  The SAML RADIUS binding described in this document defines
  the binding of the message exchange to RADIUS.  Unless specifically
  noted here, all requirements defined in those specifications apply.

  Figure 8 below illustrates the basic template for the Query/Request
  Profile.

    Relying Party                                   Identity Provider
   (SAML requester)                                 (SAML responder)
         |                                                 |
         |                       (1)                       |
         | - - - - - - - - - - - - - - - - - - - - - - - > |
         |                                                 |
         |                       (2)                       |
         | < - - - - - - - - - - - - - - - - - - - - - - - |
         |                                                 |
         V                                                 V

           Figure 8: Basic Template for Query/Request Profile







Howlett, et al.              Standards Track                   [Page 22]

RFC 7833                       SAML RADIUS                      May 2016


  The following steps are described by the profile:

  1.  Query/Request issued by RP: In step 1, an RP initiates the
      profile by sending an <AssertionIDRequest>, <SubjectQuery>,
      <AuthnQuery>, <AttributeQuery>, or <AuthzDecisionQuery> message
      to a SAML authority.

  2.  <Response> issued by SAML authority: In step 2, the responding
      SAML authority (after processing the query or request) issues a
      <Response> message to the RP.

8.3.  Profile Description

8.3.1.  Differences from the SAML V2.0 Assertion Query/Request Profile

  This profile is identical to the SAML V2.0 Assertion Query/Request
  Profile, with the following exceptions:

  o  When processing the SAML request, the IdP MUST give precedence to
     the client's identifier implied by the RADIUS State attribute, if
     present, over the identifier implied by the SAML request's
     <Subject>, if any.

  o  In respect to Sections 6.3.1 and 6.5 of
     [OASIS.saml-profiles-2.0-os], this profile does not consider the
     use of metadata (as in [OASIS.saml-metadata-2.0-os]).  See
     Section 8.3.4.

  o  In respect to Sections 6.3.2, 6.4.1, and 6.4.2 of
     [OASIS.saml-profiles-2.0-os], this profile additionally stipulates
     that implementations of this profile MUST NOT require the use of
     XML signatures.  See Section 8.3.3.

8.3.2.  Use of the SAML RADIUS Binding

  The RADIUS Access-Request sent by the RP:

  o  MUST include an instance of the RADIUS Service-Type attribute,
     having a value of Authorize-Only.

  o  SHOULD include the RADIUS State attribute, where this
     Query/Request pertains to a previously authenticated client.

  When processing the SAML request, the IdP MUST give precedence to the
  client's identifier implied by the RADIUS State attribute over the
  identifier implied by the SAML request's <Subject>, if any.





Howlett, et al.              Standards Track                   [Page 23]

RFC 7833                       SAML RADIUS                      May 2016


  It is RECOMMENDED that the RADIUS exchange be protected using TLS
  encryption for RADIUS [RFC6614] to provide confidentiality and
  integrity protection.

8.3.3.  Use of XML Signatures

  This profile calls for the use of SAML elements that support XML
  signatures.  To promote interoperability, implementations of this
  profile MUST NOT require the use of XML signatures.  Implementations
  MAY choose to use XML signatures.

8.3.4.  Metadata Considerations

  There are no metadata considerations particular to this profile,
  aside from those applying to the use of the RADIUS binding.

9.  Privacy Considerations

  The profiles defined in this document allow an RP to request specific
  information about the client and allow an IdP to disclose information
  about that client.  In this sense, IdPs MUST apply policy to decide
  what information is released to a particular RP.  Moreover, the
  identity of the client is typically hidden from the RP unless
  provided by the IdP.  Conversely, the RP does typically know the
  realm of the IdP, as it is required to route the RADIUS packets to
  the right destination.

  The kind of information that is released by the IdP can include
  generic attributes such as affiliation shared by many clients.  But
  even these generic attributes can help to identify a specific client.
  Other kinds of attributes may also provide an RP with the ability to
  link the same client between different sessions.  Finally, other
  kinds of attributes might provide a group of RPs with the ability to
  link the client between them or with personally identifiable
  information about the client.

  These profiles do not directly provide a client with a mechanism to
  express preferences about what information is released.  That
  information can be expressed out of band, for example, as part of the
  enrollment process.

  The RP may disclose privacy-sensitive information about itself as
  part of the request, although this is unlikely in typical
  deployments.







Howlett, et al.              Standards Track                   [Page 24]

RFC 7833                       SAML RADIUS                      May 2016


  If RADIUS proxies are used and encryption is not used, the attributes
  disclosed by the IdP are visible to the proxies.  This is a
  significant privacy exposure in some deployments.  Ongoing work is
  exploring mechanisms for creating TLS connections directly between
  the RADIUS client and the RADIUS server to reduce this exposure.  If
  proxies are used, the impact of exposing SAML Assertions to the
  proxies needs to be carefully considered.

  The use of TLS to provide confidentiality for the RADIUS exchange is
  strongly encouraged.  Without this, passive eavesdroppers can observe
  the assertions.

10.  Security Considerations

  In this specification, the RP MUST trust any statement in the SAML
  messages from the IdP in the same way that it trusts information
  contained in RADIUS attributes.  These entities MUST trust the RADIUS
  infrastructure to provide integrity of the SAML messages.

  Furthermore, the RP MUST apply policy and filter the information
  based on what information the IdP is permitted to assert and on what
  trust is reasonable to place in proxies between them.

  XML signatures and encryption are provided as an OPTIONAL mechanism
  for end-to-end security.  These mechanisms can protect SAML messages
  from being modified by proxies in the RADIUS infrastructure.  These
  mechanisms are not mandatory to implement.  It is believed that
  ongoing work to provide direct TLS connections between a RADIUS
  client and RADIUS server will provide similar assurances but better
  deployability.  XML security is appropriate for deployments where
  end-to-end security is required but proxies cannot be removed or
  where SAML messages need to be verified at a later time or by parties
  not involved in the authentication exchange.

11.  IANA Considerations

11.1.  RADIUS Attributes

  The Attribute Types and Attribute Values defined in this document
  have been registered by the Internet Assigned Numbers Authority
  (IANA) from the RADIUS namespaces as described in the "IANA
  Considerations" section of [RFC3575], in accordance with BCP 26
  [RFC5226].  For RADIUS packets, attributes, and registries created by
  this document, IANA has placed them at
  <http://www.iana.org/assignments/radius-types>.






Howlett, et al.              Standards Track                   [Page 25]

RFC 7833                       SAML RADIUS                      May 2016


  In particular, this document defines two new RADIUS attributes,
  entitled "SAML-Assertion" and "SAML-Protocol" (see Section 3), with
  assigned values of 245.1 and 245.2 from the long extended space
  [RFC6929]:

    Type  Ext. Type  Name            Length  Meaning
    ----  ---------  --------------  ------  ------------------------
    245   1          SAML-Assertion  >=5     Encodes a SAML Assertion
    245   2          SAML-Protocol   >=5     Encodes a SAML protocol
                                               message

11.2.  ABFAB Parameters

  A new top-level registry has been created, entitled "Application
  Bridging for Federated Access Beyond Web (ABFAB) Parameters".

  In this top-level registry, a sub-registry entitled "ABFAB URN
  Parameters" has been created.  Registration in this registry is via
  IETF Review or Expert Review procedures [RFC5226].

  This paragraph gives guidance to designated experts.  Registrations
  in this registry are generally only expected as part of protocols
  published as RFCs on the IETF stream; other URIs are expected to be
  better choices for non-IETF work.  Expert review is permitted mainly
  to allow early registration related to specifications under
  development when the community believes they have reached sufficient
  maturity.  The expert SHOULD evaluate the maturity and stability of
  such an IETF-stream specification.  Experts SHOULD review anything
  not from the IETF stream for consistency and consensus with current
  practice.  Today, such requests would not typically be approved.

  If a parameter named "paramname" is registered in this registry, then
  its URN will be "urn:ietf:params:abfab:paramname".  The initial
  registrations are as follows:

                 +-------------------------+-----------+
                 | Parameter               | Reference |
                 +-------------------------+-----------+
                 | bindings:radius         | Section 4 |
                 | nameid-format:nai       | Section 5 |
                 | profiles:authentication | Section 7 |
                 | profiles:query          | Section 8 |
                 | cm:user                 | Section 6 |
                 | cm:machine              | Section 6 |
                 +-------------------------+-----------+

                            ABFAB Parameters




Howlett, et al.              Standards Track                   [Page 26]

RFC 7833                       SAML RADIUS                      May 2016


11.3.  Registration of the ABFAB URN Namespace

  IANA has registered the "abfab" URN sub-namespace in the IETF URN
  sub-namespace for protocol parameters defined in [RFC3553].

  Registry Name: abfab

  Specification: RFC 7833 (this document)

  Repository: ABFAB URN Parameters (Section 11.2)

  Index Value: Sub-parameters MUST be specified in UTF-8, using
  standard URI encoding where necessary.

12.  References

12.1.  Normative References

  [OASIS.saml-bindings-2.0-os]
             Cantor, S., Hirsch, F., Kemp, J., Philpott, R., and E.
             Maler, "Bindings for the OASIS Security Assertion
             Markup Language (SAML) V2.0", OASIS
             Standard saml-bindings-2.0-os, March 2005,
             <http://docs.oasis-open.org/security/saml/v2.0/
             saml-bindings-2.0-os.pdf>.

  [OASIS.saml-core-2.0-os]
             Cantor, S., Kemp, J., Philpott, R., and E. Maler,
             "Assertions and Protocols for the OASIS Security Assertion
             Markup Language (SAML) V2.0", OASIS
             Standard saml-core-2.0-os, March 2005,
             <http://docs.oasis-open.org/security/saml/v2.0/
             saml-core-2.0-os.pdf>.

  [OASIS.saml-metadata-2.0-os]
             Cantor, S., Moreh, J., Philpott, R., and E. Maler,
             "Metadata for the OASIS Security Assertion Markup Language
             (SAML) V2.0", OASIS Standard saml-metadata-2.0-os,
             March 2005, <http://docs.oasis-open.org/security/
             saml/v2.0/saml-metadata-2.0-os.pdf>.

  [OASIS.saml-profiles-2.0-os]
             Hughes, J., Cantor, S., Hodges, J., Hirsch, F., Mishra,
             P., Philpott, R., and E. Maler, "Profiles for the OASIS
             Security Assertion Markup Language (SAML) V2.0", OASIS
             Standard OASIS.saml-profiles-2.0-os, March 2005,
             <http://docs.oasis-open.org/security/saml/v2.0/
             saml-profiles-2.0-os.pdf>.



Howlett, et al.              Standards Track                   [Page 27]

RFC 7833                       SAML RADIUS                      May 2016


  [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
             Requirement Levels", BCP 14, RFC 2119,
             DOI 10.17487/RFC2119, March 1997,
             <http://www.rfc-editor.org/info/rfc2119>.

  [RFC2865]  Rigney, C., Willens, S., Rubens, A., and W. Simpson,
             "Remote Authentication Dial In User Service (RADIUS)",
             RFC 2865, DOI 10.17487/RFC2865, June 2000,
             <http://www.rfc-editor.org/info/rfc2865>.

  [RFC3575]  Aboba, B., "IANA Considerations for RADIUS (Remote
             Authentication Dial In User Service)", RFC 3575,
             DOI 10.17487/RFC3575, July 2003,
             <http://www.rfc-editor.org/info/rfc3575>.

  [RFC3579]  Aboba, B. and P. Calhoun, "RADIUS (Remote Authentication
             Dial In User Service) Support For Extensible
             Authentication Protocol (EAP)", RFC 3579,
             DOI 10.17487/RFC3579, September 2003,
             <http://www.rfc-editor.org/info/rfc3579>.

  [RFC6614]  Winter, S., McCauley, M., Venaas, S., and K. Wierenga,
             "Transport Layer Security (TLS) Encryption for RADIUS",
             RFC 6614, DOI 10.17487/RFC6614, May 2012,
             <http://www.rfc-editor.org/info/rfc6614>.

  [RFC6929]  DeKok, A. and A. Lior, "Remote Authentication Dial In User
             Service (RADIUS) Protocol Extensions", RFC 6929,
             DOI 10.17487/RFC6929, April 2013,
             <http://www.rfc-editor.org/info/rfc6929>.

  [RFC7542]  DeKok, A., "The Network Access Identifier", RFC 7542,
             DOI 10.17487/RFC7542, May 2015,
             <http://www.rfc-editor.org/info/rfc7542>.

















Howlett, et al.              Standards Track                   [Page 28]

RFC 7833                       SAML RADIUS                      May 2016


12.2.  Informative References

  [RADIUS-Large-Pkts]
             Hartman, S., "Larger Packets for RADIUS over TCP", Work in
             Progress, draft-ietf-radext-bigger-packets-07, April 2016.

  [RFC3553]  Mealling, M., Masinter, L., Hardie, T., and G. Klyne, "An
             IETF URN Sub-namespace for Registered Protocol
             Parameters", BCP 73, RFC 3553, DOI 10.17487/RFC3553,
             June 2003, <http://www.rfc-editor.org/info/rfc3553>.

  [RFC5226]  Narten, T. and H. Alvestrand, "Guidelines for Writing an
             IANA Considerations Section in RFCs", BCP 26, RFC 5226,
             DOI 10.17487/RFC5226, May 2008,
             <http://www.rfc-editor.org/info/rfc5226>.

  [RFC6733]  Fajardo, V., Ed., Arkko, J., Loughney, J., and G. Zorn,
             Ed., "Diameter Base Protocol", RFC 6733,
             DOI 10.17487/RFC6733, October 2012,
             <http://www.rfc-editor.org/info/rfc6733>.

  [RFC7055]  Hartman, S., Ed., and J. Howlett, "A GSS-API Mechanism for
             the Extensible Authentication Protocol", RFC 7055,
             DOI 10.17487/RFC7055, December 2013,
             <http://www.rfc-editor.org/info/rfc7055>.

  [RFC7499]  Perez-Mendez, A., Ed., Marin-Lopez, R., Pereniguez-Garcia,
             F., Lopez-Millan, G., Lopez, D., and A. DeKok, "Support of
             Fragmentation of RADIUS Packets", RFC 7499,
             DOI 10.17487/RFC7499, April 2015,
             <http://www.rfc-editor.org/info/rfc7499>.

  [RFC7831]  Howlett, J., Hartman, S., Tschofenig, H., and J. Schaad,
             "Application Bridging for Federated Access Beyond Web
             (ABFAB) Architecture", RFC 7831, DOI 10.17487/RFC7831,
             May 2016, <http://www.rfc-editor.org/info/rfc7831>.

  [W3C.REC-xmlschema-1]
             Thompson, H., Beech, D., Maloney, M., and N. Mendelsohn,
             "XML Schema Part 1: Structures Second Edition",
             W3C REC-xmlschema-1, October 2004,
             <http://www.w3.org/TR/xmlschema-1/>.









Howlett, et al.              Standards Track                   [Page 29]

RFC 7833                       SAML RADIUS                      May 2016


Appendix A.  XML Schema

  The following schema formally defines the
  "urn:ietf:params:xml:ns:abfab" namespace used in this document, in
  conformance with [W3C.REC-xmlschema-1].  Although XML validation is
  optional, the schema that follows is the normative definition of the
  constructs it defines.  Where the schema differs from any prose in
  this specification, the schema takes precedence.

          <schema
            targetNamespace="urn:ietf:params:xml:ns:abfab"
            xmlns="http://www.w3.org/2001/XMLSchema"
            xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata"
            xmlns:abfab="urn:ietf:params:xml:ns:abfab"
            elementFormDefault="unqualified"
            attributeFormDefault="unqualified"
            blockDefault="substitution"
            version="1.0">

            <import namespace="urn:oasis:names:tc:SAML:2.0:metadata"/>

            <complexType name="RADIUSIDPDescriptorType">
              <complexContent>
                <extension base="md:RoleDescriptorType">
                  <sequence>
                    <element ref="abfab:RADIUSIDPService"
                                  minOccurs="0" maxOccurs="unbounded"/>
                    <element ref="abfab:RADIUSRealm"
                                  minOccurs="0" maxOccurs="unbounded"/>
                  </sequence>
                </extension>
              </complexContent>
            </complexType>
            <element name="RADIUSIDPService" type="md:EndpointType"/>
            <element name="RADIUSRealm" type="string"/>
















Howlett, et al.              Standards Track                   [Page 30]

RFC 7833                       SAML RADIUS                      May 2016


            <complexType name="RADIUSRPDescriptorType">
              <complexContent>
                <extension base="md:RoleDescriptorType">
                  <sequence>
                    <element ref="md:RADIUSRPService"
                                  minOccurs="0" maxOccurs="unbounded"/>
                    <element ref="md:RADIUSNasIpAddress"
                                  minOccurs="0" maxOccurs="unbounded"/>
                    <element ref="md:RADIUSNasIdentifier"
                                  minOccurs="0" maxOccurs="unbounded"/>
                    <element ref="md:RADIUSGssEapName"
                                  minOccurs="0" maxOccurs="unbounded"/>
                  </sequence>
                </extension>
              </complexContent>
            </complexType>
            <element name="RADIUSRPService" type="md:EndpointType"/>
            <element name="RADIUSNasIpAddress" type="string"/>
            <element name="RADIUSNasIdentifier" type="string"/>
            <element name="RADIUSGssEapName" type="string"/>
          </schema>






























Howlett, et al.              Standards Track                   [Page 31]

RFC 7833                       SAML RADIUS                      May 2016


Acknowledgments

  The authors would like to acknowledge the OASIS Security Services
  (SAML) Technical Committee, and Scott Cantor in particular, for their
  help with the SAML-related material.

  The authors would also like to acknowledge the collaboration of Jim
  Schaad, Leif Johansson, Klaas Wierenga, Stephen Farrell, Gabriel
  Lopez-Millan, and Rafa Marin-Lopez, who have provided valuable
  comments on this document.

Authors' Addresses

  Josh Howlett
  Jisc
  Lumen House, Library Avenue, Harwell
  Oxford  OX11 0SG
  United Kingdom

  Phone: +44 1235 822363
  Email: [email protected]


  Sam Hartman
  Painless Security

  Email: [email protected]


  Alejandro Perez-Mendez (editor)
  University of Murcia
  Campus de Espinardo S/N, Faculty of Computer Science
  Murcia  30100
  Spain

  Phone: +34 868 88 46 44
  Email: [email protected]














Howlett, et al.              Standards Track                   [Page 32]