Internet Engineering Task Force K. Hazelton, Ed.
Internet-Draft University of Wisconsin-Madison
Intended status: Informational February 9, 2018
Expires: August 13, 2018

SAML vocabulary extension for OTTO Draft-01
otto-saml-draft-01

Abstract

This specification describes a method for packaging information about SAML-based federations, and establishing mechanisms for its validation. It includes term definitions which appear in the current JSON-LD context for the OTTO 1.0 specification.

Status of This Memo

This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.

Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.

Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."

This Internet-Draft will expire on August 13, 2018.

Copyright Notice

Copyright (c) 2018 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 (https://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

The Open Trust Taxonomy for Federation Operators ("OTTO") defines an extension mechanism to allow the community to add functionality in a community compatible way. This specification was developed to enable OTTO federations to support SAML-based identity services, and defines all the terms used in the JSON-LD context file which the extension covers.

2. Requirements Language

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.

3. Notational Conventions

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

Unless otherwise noted, all protocol properties and values are case sensitive.

4. OTTO SAML Vocabulary Extension

4.1. SAML Entity

SAML Entity
Property Expected Type Description
Entity Otto:Entity Elements that are common to both SAML Entities and Otto Entities
Otto Category Otto:Category String, (URI?): Enumerated categories of entities of a particular type
Refeds Entity Category URI or array of URIs URI identifier for a registered Refeds Entity Category (e.g., Research and Scholarship)
SAML Entity Descriptor SAML Entity Descriptor The full specification of a SAML Entity
UI Information SAML UI Information descriptive information about the SSO User Interface
SAML Service Provider Endpoint SAML Service Provider Endpoint or array of Service Provider Endpoint The Service Provider Endpoints provided by this entity
SAML Identity Provider Endpoint SAML Identity Provider Endpoint or array of Identity Provider Endpoint The Identity Provider Endpoints provided by this entity
SAML Attribute Authority Endpoint SAML Attribute Authority Endpoint or array of Attribute Authority Endpoint The Attribute Authority Endpoints provided by this entity

4.2. SAML Service Provider Endpoint

SAML Service Provider Endpoint
Property Expected Type Description
Protocols URIs
Keys http://www.w3.org/2000/09/xmldsig:X509Certificate or array of http://www.w3.org/2000/09/xmldsig:X509Certificate Public keys for SAML signing and encryption
Discovery Responses DiscoveryResponse or indexed array of DiscoveryResponses URL(s) of the SSO Endpoints associated with this SAML Service Provider Entity
Assertion Consumers Assertion Consumer element or array of Assertion Consumer element as defined in |SAML:Metadata| URLs and type of endpoint that will be consuming attributes
Attribute Consumer Attribute Consumer element as defined in |SAML:Metadata| Name and descriptive label for the service that will be consuming attributes
Requested Attributes List of attributes as defined in |SAML:Metadata| Friendly name and name format of requested attributes

4.3. SAML Identity Provider Endpoint

SAML Identity Provider Endpoint
Property Expected Type Description
Protocols URIs List of supported protocols
UI metadata SAML UI Metadata descriptive information about the IdP User Interface
Keys http://www.w3.org/2000/09/xmldsig:X509Certificate or array of http://www.w3.org/2000/09/xmldsig:X509Certificate Keys for signing (and encryption)
Registrar OTTO:Registration Authority The registrar for this SAML Identity Provider
Domain samlMd:Scope The domain for which this Identity Provider is authorized to make assertions
Identity Provider Binding Identity Provider SSO Binding or array of Identity Provider SSO Bindings The binding supported by this IdP
SAML Attribute Authority Endpoint SAML Attribute Authority Endpoint The Attribute Authority endpoint associated with this IdP

4.4. SAML Attribute Authority Endpoint

SAML Attribute Authority Endpoint
Property Expected Type Description
Protocols URIs List of supported protocols
Keys http://www.w3.org/2000/09/xmldsig:X509Certificate or array of http://www.w3.org/2000/09/xmldsig:X509Certificate Keys for signing (and encryption)
Domain samlMd:Scope The domain for which this Attribute Authority is authorized to make assertions
Attribute Service Binding URI The binding supported by this Attribute Authority

5. Acknowledgements

TBD

6. IANA Considerations

This memo includes no request to IANA.

7. Security Considerations

TBD

8. References

8.1. Normative References

[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997.

8.2. Informative References

[RFC6749] Hardt, D., "The OAuth 2.0 Authorization Framework", RFC 6749, DOI 10.17487/RFC6749, October 2012.

Author's Address

Keith Hazelton (editor) University of Wisconsin-Madison 1210 W Dayton St. Madison, Wisconsin 53706 US Phone: +1 608 262 0771 EMail: hazelton@wisc.edu