draft-ietf-oauth-jwt-bearer-09.txt		draft-ietf-oauth-jwt-bearer-10.txt
	OAuth Working Group M. Jones		OAuth Working Group M. Jones
	Internet-Draft Microsoft		Internet-Draft Microsoft
	Intended status: Standards Track B. Campbell		Intended status: Standards Track B. Campbell
	Expires: October 30, 2014 Ping Identity		Expires: January 24, 2015 Ping Identity
	C. Mortimore		C. Mortimore
	Salesforce		Salesforce
	April 28, 2014		July 23, 2014
	JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication and		JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication and
	Authorization Grants		Authorization Grants
	draft-ietf-oauth-jwt-bearer-09		draft-ietf-oauth-jwt-bearer-10
	Abstract		Abstract
	This specification defines the use of a JSON Web Token (JWT) Bearer		This specification defines the use of a JSON Web Token (JWT) Bearer
	Token as a means for requesting an OAuth 2.0 access token as well as		Token as a means for requesting an OAuth 2.0 access token as well as
	for use as a means of client authentication.		for use as a means of client authentication.
	Status of This Memo		Status of This Memo
	This Internet-Draft is submitted in full conformance with the		This Internet-Draft is submitted in full conformance with the
	skipping to change at page 1, line 36		skipping to change at page 1, line 36
	Internet-Drafts are working documents of the Internet Engineering		Internet-Drafts are working documents of the Internet Engineering
	Task Force (IETF). Note that other groups may also distribute		Task Force (IETF). Note that other groups may also distribute
	working documents as Internet-Drafts. The list of current Internet-		working documents as Internet-Drafts. The list of current Internet-
	Drafts is at http://datatracker.ietf.org/drafts/current/.		Drafts is at http://datatracker.ietf.org/drafts/current/.
	Internet-Drafts are draft documents valid for a maximum of six months		Internet-Drafts are draft documents valid for a maximum of six months
	and may be updated, replaced, or obsoleted by other documents at any		and may be updated, replaced, or obsoleted by other documents at any
	time. It is inappropriate to use Internet-Drafts as reference		time. It is inappropriate to use Internet-Drafts as reference
	material or to cite them other than as "work in progress."		material or to cite them other than as "work in progress."
	This Internet-Draft will expire on October 30, 2014.		This Internet-Draft will expire on January 24, 2015.
	Copyright Notice		Copyright Notice
	Copyright (c) 2014 IETF Trust and the persons identified as the		Copyright (c) 2014 IETF Trust and the persons identified as the
	document authors. All rights reserved.		document authors. All rights reserved.
	This document is subject to BCP 78 and the IETF Trust's Legal		This document is subject to BCP 78 and the IETF Trust's Legal
	Provisions Relating to IETF Documents		Provisions Relating to IETF Documents
	(http://trustee.ietf.org/license-info) in effect on the date of		(http://trustee.ietf.org/license-info) in effect on the date of
	publication of this document. Please review these documents		publication of this document. Please review these documents
	carefully, as they describe your rights and restrictions with respect		carefully, as they describe your rights and restrictions with respect
	to this document. Code Components extracted from this document must		to this document. Code Components extracted from this document must
	include Simplified BSD License text as described in Section 4.e of		include Simplified BSD License text as described in Section 4.e of
	the Trust Legal Provisions and are provided without warranty as		the Trust Legal Provisions and are provided without warranty as
	described in the Simplified BSD License.		described in the Simplified BSD License.
	Table of Contents		Table of Contents
	1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2		1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2
	1.1. Notational Conventions . . . . . . . . . . . . . . . . . 3		1.1. Notational Conventions . . . . . . . . . . . . . . . . . 4
	1.2. Terminology . . . . . . . . . . . . . . . . . . . . . . . 4		1.2. Terminology . . . . . . . . . . . . . . . . . . . . . . . 4
	2. HTTP Parameter Bindings for Transporting Assertions . . . . . 4		2. HTTP Parameter Bindings for Transporting Assertions . . . . . 4
	2.1. Using JWTs as Authorization Grants . . . . . . . . . . . 4		2.1. Using JWTs as Authorization Grants . . . . . . . . . . . 4
	2.2. Using JWTs for Client Authentication . . . . . . . . . . 5		2.2. Using JWTs for Client Authentication . . . . . . . . . . 5
	3. JWT Format and Processing Requirements . . . . . . . . . . . 5		3. JWT Format and Processing Requirements . . . . . . . . . . . 5
	3.1. Authorization Grant Processing . . . . . . . . . . . . . 7		3.1. Authorization Grant Processing . . . . . . . . . . . . . 7
	3.2. Client Authentication Processing . . . . . . . . . . . . 7		3.2. Client Authentication Processing . . . . . . . . . . . . 8
	4. Authorization Grant Example . . . . . . . . . . . . . . . . . 8		4. Authorization Grant Example . . . . . . . . . . . . . . . . . 8
	5. Interoperability Considerations . . . . . . . . . . . . . . . 9		5. Interoperability Considerations . . . . . . . . . . . . . . . 9
	6. Security Considerations . . . . . . . . . . . . . . . . . . . 9		6. Security Considerations . . . . . . . . . . . . . . . . . . . 9
	7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 9		7. Privacy Considerations . . . . . . . . . . . . . . . . . . . 10
	7.1. Sub-Namespace Registration of urn:ietf:params:oauth		8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 10
	:grant-type:jwt-bearer . . . . . . . . . . . . . . . . . 9		8.1. Sub-Namespace Registration of urn:ietf:params:oauth
	7.2. Sub-Namespace Registration of urn:ietf:params:oauth		:grant-type:jwt-bearer . . . . . . . . . . . . . . . . . 10
			8.2. Sub-Namespace Registration of urn:ietf:params:oauth
	:client-assertion-type:jwt-bearer . . . . . . . . . . . . 10		:client-assertion-type:jwt-bearer . . . . . . . . . . . . 10
	8. References . . . . . . . . . . . . . . . . . . . . . . . . . 10		9. References . . . . . . . . . . . . . . . . . . . . . . . . . 11
	8.1. Normative References . . . . . . . . . . . . . . . . . . 10		9.1. Normative References . . . . . . . . . . . . . . . . . . 11
	8.2. Informative References . . . . . . . . . . . . . . . . . 11		9.2. Informative References . . . . . . . . . . . . . . . . . 11
	Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . 11		Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . 12
	Appendix B. Document History . . . . . . . . . . . . . . . . . . 11		Appendix B. Document History . . . . . . . . . . . . . . . . . . 12
	Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 13		Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 14
	1. Introduction		1. Introduction
	JSON Web Token (JWT) [JWT] is a JavaScript Object Notation (JSON)		JSON Web Token (JWT) [JWT] is a JavaScript Object Notation (JSON)
	[RFC7159] based security token encoding that enables identity and		[RFC7159] based security token encoding that enables identity and
	security information to be shared across security domains. A		security information to be shared across security domains. A
	security token is generally issued by an identity provider and		security token is generally issued by an identity provider and
	consumed by a relying party that relies on its content to identify		consumed by a relying party that relies on its content to identify
	the token's subject for security related purposes.		the token's subject for security related purposes.
	skipping to change at page 3, line 12		skipping to change at page 3, line 13
	are defined to support a wide range of client types and user		are defined to support a wide range of client types and user
	experiences. OAuth also allows for the definition of new extension		experiences. OAuth also allows for the definition of new extension
	grant types to support additional clients or to provide a bridge		grant types to support additional clients or to provide a bridge
	between OAuth and other trust frameworks. Finally, OAuth allows the		between OAuth and other trust frameworks. Finally, OAuth allows the
	definition of additional authentication mechanisms to be used by		definition of additional authentication mechanisms to be used by
	clients when interacting with the authorization server.		clients when interacting with the authorization server.
	The Assertion Framework for OAuth 2.0 Client Authentication and		The Assertion Framework for OAuth 2.0 Client Authentication and
	Authorization Grants [I-D.ietf-oauth-assertions] specification is an		Authorization Grants [I-D.ietf-oauth-assertions] specification is an
	abstract extension to OAuth 2.0 that provides a general framework for		abstract extension to OAuth 2.0 that provides a general framework for
	the use of Assertions (a.k.a. Security Tokens) as client credentials		the use of Assertions (a.k.a. Security Tokens) as client credentials
	and/or authorization grants with OAuth 2.0. This specification		and/or authorization grants with OAuth 2.0. This specification
	profiles the Assertion Framework for OAuth 2.0 Client Authentication		profiles the Assertion Framework for OAuth 2.0 Client Authentication
	and Authorization Grants [I-D.ietf-oauth-assertions] specification to		and Authorization Grants [I-D.ietf-oauth-assertions] specification to
	define an extension grant type that uses a JSON Web Token (JWT)		define an extension grant type that uses a JSON Web Token (JWT)
	Bearer Token to request an OAuth 2.0 access token as well as for use		Bearer Token to request an OAuth 2.0 access token as well as for use
	as client credentials. The format and processing rules for the JWT		as client credentials. The format and processing rules for the JWT
	defined in this specification are intentionally similar, though not		defined in this specification are intentionally similar, though not
	identical, to those in the closely related SAML 2.0 Profile for OAuth		identical, to those in the closely related SAML 2.0 Profile for OAuth
	2.0 Client Authentication and Authorization Grants		2.0 Client Authentication and Authorization Grants
	[I-D.ietf-oauth-saml2-bearer] specification.		[I-D.ietf-oauth-saml2-bearer] specification.
	skipping to change at page 9, line 36		skipping to change at page 10, line 5
	for OAuth 2.0 Client Authentication and Authorization Grants		for OAuth 2.0 Client Authentication and Authorization Grants
	[I-D.ietf-oauth-assertions], The OAuth 2.0 Authorization Framework		[I-D.ietf-oauth-assertions], The OAuth 2.0 Authorization Framework
	[RFC6749], and the JSON Web Token (JWT) [JWT] specifications are all		[RFC6749], and the JSON Web Token (JWT) [JWT] specifications are all
	applicable to this document.		applicable to this document.
	The specification does not mandate replay protection for the JWT		The specification does not mandate replay protection for the JWT
	usage for either the authorization grant or for client		usage for either the authorization grant or for client
	authentication. It is an optional feature, which implementations may		authentication. It is an optional feature, which implementations may
	employ at their own discretion.		employ at their own discretion.
	7. IANA Considerations		7. Privacy Considerations
	7.1. Sub-Namespace Registration of urn:ietf:params:oauth:grant-type		A JWT may contain privacy-sensitive information and, to prevent
	:jwt-bearer		disclosure of such information to unintended parties, should only be
			transmitted over encrypted channels, such as TLS. In cases where it
			is desirable to prevent disclosure of certain information the client,
			the JWT should be be encrypted to the authorization server.
			Deployments should determine the minimum amount of information
			necessary to complete the exchange and include only such claims in
			the JWT. In some cases, the "sub" (subject) claim can be a value
			representing an anonymous or pseudonymous user, as described in
			Section 6.3.1 of the Assertion Framework for OAuth 2.0 Client
			Authentication and Authorization Grants [I-D.ietf-oauth-assertions].
			8. IANA Considerations
			8.1. Sub-Namespace Registration of urn:ietf:params:oauth:grant-
			type:jwt-bearer
	This specification registers the value "grant-type:jwt-bearer" in the		This specification registers the value "grant-type:jwt-bearer" in the
	IANA urn:ietf:params:oauth registry established in An IETF URN Sub-		IANA urn:ietf:params:oauth registry established in An IETF URN Sub-
	Namespace for OAuth [RFC6755].		Namespace for OAuth [RFC6755].
	o URN: urn:ietf:params:oauth:grant-type:jwt-bearer		o URN: urn:ietf:params:oauth:grant-type:jwt-bearer
	o Common Name: JWT Bearer Token Grant Type Profile for OAuth 2.0		o Common Name: JWT Bearer Token Grant Type Profile for OAuth 2.0
	o Change controller: IETF		o Change controller: IETF
	o Specification Document: [[this document]]		o Specification Document: [[this document]]
	7.2. Sub-Namespace Registration of urn:ietf:params:oauth:client-		8.2. Sub-Namespace Registration of urn:ietf:params:oauth:client-
	assertion-type:jwt-bearer		assertion-type:jwt-bearer
	This specification registers the value "client-assertion-type:jwt-		This specification registers the value "client-assertion-type:jwt-
	bearer" in the IANA urn:ietf:params:oauth registry established in An		bearer" in the IANA urn:ietf:params:oauth registry established in An
	IETF URN Sub-Namespace for OAuth [RFC6755].		IETF URN Sub-Namespace for OAuth [RFC6755].
	o URN: urn:ietf:params:oauth:client-assertion-type:jwt-bearer		o URN: urn:ietf:params:oauth:client-assertion-type:jwt-bearer
	o Common Name: JWT Bearer Token Profile for OAuth 2.0 Client		o Common Name: JWT Bearer Token Profile for OAuth 2.0 Client
	Authentication		Authentication
	o Change controller: IETF		o Change controller: IETF
	o Specification Document: [[this document]]		o Specification Document: [[this document]]
	8. References		9. References
	8.1. Normative References		9.1. Normative References
	[I-D.ietf-oauth-assertions]		[I-D.ietf-oauth-assertions]
	Campbell, B., Mortimore, C., Jones, M., and Y. Goland,		Campbell, B., Mortimore, C., Jones, M., and Y. Goland,
	"Assertion Framework for OAuth 2.0 Client Authentication		"Assertion Framework for OAuth 2.0 Client Authentication
	and Authorization Grants", draft-ietf-oauth-assertions		and Authorization Grants", draft-ietf-oauth-assertions
	(work in progress), April 2014.		(work in progress), July 2014.
	[JWT] Jones, M., Bradley, J., and N. Sakimura, "JSON Web Token		[JWT] Jones, M., Bradley, J., and N. Sakimura, "JSON Web Token
	(JWT)", draft-ietf-oauth-json-web-token (work in		(JWT)", draft-ietf-oauth-json-web-token (work in
	progress), March 2014.		progress), July 2014.
	[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate		[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
	Requirement Levels", BCP 14, RFC 2119, March 1997.		Requirement Levels", BCP 14, RFC 2119, March 1997.
	[RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform		[RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform
	Resource Identifier (URI): Generic Syntax", STD 66, RFC		Resource Identifier (URI): Generic Syntax", STD 66, RFC
	3986, January 2005.		3986, January 2005.
	[RFC6749] Hardt, D., "The OAuth 2.0 Authorization Framework", RFC		[RFC6749] Hardt, D., "The OAuth 2.0 Authorization Framework", RFC
	6749, October 2012.		6749, October 2012.
	[RFC6755] Campbell, B. and H. Tschofenig, "An IETF URN Sub-Namespace		[RFC6755] Campbell, B. and H. Tschofenig, "An IETF URN Sub-Namespace
	for OAuth", RFC 6755, October 2012.		for OAuth", RFC 6755, October 2012.
	[RFC7159] Bray, T., "The JavaScript Object Notation (JSON) Data		[RFC7159] Bray, T., "The JavaScript Object Notation (JSON) Data
	Interchange Format", RFC 7159, March 2014.		Interchange Format", RFC 7159, March 2014.
	8.2. Informative References		9.2. Informative References
	[I-D.ietf-oauth-dyn-reg]		[I-D.ietf-oauth-dyn-reg]
	Richer, J., Jones, M., Bradley, J., Machulak, M., and P.		Richer, J., Jones, M., Bradley, J., Machulak, M., and P.
	Hunt, "OAuth 2.0 Dynamic Client Registration Core		Hunt, "OAuth 2.0 Dynamic Client Registration Core
	Protocol", draft-ietf-oauth-dyn-reg-16 (work in progress),		Protocol", draft-ietf-oauth-dyn-reg-16 (work in progress),
	February 2014.		February 2014.
	[I-D.ietf-oauth-saml2-bearer]		[I-D.ietf-oauth-saml2-bearer]
	Campbell, B., Mortimore, C., and M. Jones, "SAML 2.0		Campbell, B., Mortimore, C., and M. Jones, "SAML 2.0
	Profile for OAuth 2.0 Client Authentication and		Profile for OAuth 2.0 Client Authentication and
	Authorization Grants", draft-ietf-oauth-saml2-bearer (work		Authorization Grants", draft-ietf-oauth-saml2-bearer (work
	in progress), April 2014.		in progress), July 2014.
	[OpenID.Discovery]		[OpenID.Discovery]
	Sakimura, N., Bradley, J., Jones, M., and E. Jay, "OpenID		Sakimura, N., Bradley, J., Jones, M., and E. Jay, "OpenID
	Connect Discovery 1.0", February 2014.		Connect Discovery 1.0", February 2014.
	[OpenID.Registration]		[OpenID.Registration]
	Sakimura, N., Bradley, J., and M. Jones, "OpenID Connect		Sakimura, N., Bradley, J., and M. Jones, "OpenID Connect
	Dynamic Client Registration 1.0", February 2014.		Dynamic Client Registration 1.0", February 2014.
	Appendix A. Acknowledgements		Appendix A. Acknowledgements
	This profile was derived from SAML 2.0 Profile for OAuth 2.0 Client		This profile was derived from SAML 2.0 Profile for OAuth 2.0 Client
	Authentication and Authorization Grants [I-D.ietf-oauth-saml2-bearer]		Authentication and Authorization Grants [I-D.ietf-oauth-saml2-bearer]
	by Brian Campbell and Chuck Mortimore.		by Brian Campbell and Chuck Mortimore.
	Appendix B. Document History		Appendix B. Document History
	[[ to be removed by the RFC editor before publication as an RFC ]]		[[ to be removed by the RFC editor before publication as an RFC ]]
			draft-ietf-oauth-jwt-bearer-10
			o Added Privacy Considerations section per AD review discussion
			http://www.ietf.org/mail-archive/web/oauth/current/msg13148.html
			and http://www.ietf.org/mail-archive/web/oauth/current/
			msg13144.html
	draft-ietf-oauth-jwt-bearer-09		draft-ietf-oauth-jwt-bearer-09
	o Clarified some text around the treatment of subject based on the		o Clarified some text around the treatment of subject based on the
	rough rough consensus from the thread staring at http://		rough rough consensus from the thread staring at
	www.ietf.org/mail-archive/web/oauth/current/msg12630.html		http://www.ietf.org/mail-archive/web/oauth/current/msg12630.html
	draft-ietf-oauth-jwt-bearer-08		draft-ietf-oauth-jwt-bearer-08
	o Updated references, including replacing references to RFC 4627		o Updated references, including replacing references to RFC 4627
	with RFC 7159.		with RFC 7159.
	draft-ietf-oauth-jwt-bearer-07		draft-ietf-oauth-jwt-bearer-07
	o Clean up language around subject per http://www.ietf.org/mail-		o Clean up language around subject per http://www.ietf.org/mail-
	archive/web/oauth/current/msg12250.html.		archive/web/oauth/current/msg12250.html.
	o As suggested in http://www.ietf.org/mail-archive/web/oauth/current		o As suggested in http://www.ietf.org/mail-
	/msg12251.html stated that "In the absence of an application		archive/web/oauth/current/msg12251.html stated that "In the
	profile specifying otherwise, compliant applications MUST compare		absence of an application profile specifying otherwise, compliant
	the audience values using the Simple String Comparison method		applications MUST compare the audience values using the Simple
	defined in Section 6.2.1 of RFC 3986."		String Comparison method defined in Section 6.2.1 of RFC 3986."
	o Added one-time use, maximum lifetime, and specific subject and		o Added one-time use, maximum lifetime, and specific subject and
	attribute requirements to Interoperability Considerations based on		attribute requirements to Interoperability Considerations based on
	http://www.ietf.org/mail-archive/web/oauth/current/msg12252.html.		http://www.ietf.org/mail-archive/web/oauth/current/msg12252.html.
	o Remove "or its subject confirmation requirements cannot be met"		o Remove "or its subject confirmation requirements cannot be met"
	text.		text.
	o Reword security considerations and mention that replay protection		o Reword security considerations and mention that replay protection
	is not mandated based on http://www.ietf.org/mail-archive/web/		is not mandated based on http://www.ietf.org/mail-
	oauth/current/msg12259.html.		archive/web/oauth/current/msg12259.html.
	-06		-06
	o Stated that issuer and audience values SHOULD be compared using		o Stated that issuer and audience values SHOULD be compared using
	the Simple String Comparison method defined in Section 6.2.1 of		the Simple String Comparison method defined in Section 6.2.1 of
	RFC 3986 unless otherwise specified by the application.		RFC 3986 unless otherwise specified by the application.
	-05		-05
	o Changed title from "JSON Web Token (JWT) Bearer Token Profiles for		o Changed title from "JSON Web Token (JWT) Bearer Token Profiles for
	OAuth 2.0" to "JSON Web Token (JWT) Profile for OAuth 2.0 Client		OAuth 2.0" to "JSON Web Token (JWT) Profile for OAuth 2.0 Client
	Authentication and Authorization Grants" to be more explicit about		Authentication and Authorization Grants" to be more explicit about
	the scope of the document per http://www.ietf.org/mail-archive/web		the scope of the document per http://www.ietf.org/mail-
	/oauth/current/msg11063.html.		archive/web/oauth/current/msg11063.html.
	o Numbered the list of processing rules.		o Numbered the list of processing rules.
	o Smallish editorial cleanups to try and improve readability and		o Smallish editorial cleanups to try and improve readability and
	comprehensibility.		comprehensibility.
	o Cleaner split out of the processing rules in cases where they		o Cleaner split out of the processing rules in cases where they
	differ for client authentication and authorization grants.		differ for client authentication and authorization grants.
	o Clarified the parameters that are used/available for authorization		o Clarified the parameters that are used/available for authorization
End of changes. 23 change blocks.
	38 lines changed or deleted		61 lines changed or added
This html diff was produced by rfcdiff 1.41. The latest version is available from http://tools.ietf.org/tools/rfcdiff/