Key Management Interoperability Protocol Profiles Version 1.0
OASIS Standard
01 October 2010
http://docs.oasis-open.org/kmip/profiles/v1.0/os/kmip-profiles-1.0-os.html
http://docs.oasis-open.org/kmip/profiles/v1.0/os/kmip-profiles-1.0-os.doc (Authoritative)
http://docs.oasis-open.org/kmip/profiles/v1.0/os/kmip-profiles-1.0-os.pdf
http://docs.oasis-open.org/kmip/profiles/v1.0/cs01/kmip-profiles-1.0-cs-01.html
http://docs.oasis-open.org/kmip/profiles/v1.0/cs01/kmip-profiles-1.0-cs-01.doc (Authoritative)
http://docs.oasis-open.org/kmip/profiles/v1.0/cs01/kmip-profiles-1.0-cs-01.pdf
Latest Version:
http://docs.oasis-open.org/kmip/profiles/v1.0/kmip-profiles-1.0.html
http://docs.oasis-open.org/kmip/profiles/v1.0/kmip-profiles-1.0.doc
http://docs.oasis-open.org/kmip/profiles/v1.0//kmip-profiles-1.0.pdf
OASIS Key Management Interoperability Protocol (KMIP) TC
Robert Griffin, EMC Corporation <robert.griffin@rsa.com>
Subhash Sankuratripati, NetApp <Subhash.Sankuratripati@netapp.com>
Robert Griffin, EMC Corporation <robert.griffin@rsa.com>
Subhash Sankuratripati, NetApp <Subhash.Sankuratripati@netapp.com>
This specification replaces or supersedes:
This specification is related to:
None
This document is intended for developers and architects who wish to design systems and applications that interoperate using the Key Management Interoperability Protocol specification.
This document was last revised or approved by the Key Management Interoperability Protocol TC on the above date. The level of approval is also listed above. Check the “Latest Version” or “Latest Approved Version” location noted above for possible later revisions of this document.
Technical Committee members should send comments on this specification to the Technical Committee’s email list. Others should send comments to the Technical Committee by using the “Send A Comment” button on the Technical Committee’s web page at http://www.oasis-open.org/committees/kmip/.
For information on whether any patents have been disclosed that may be essential to implementing this specification, and any offers of patent licensing terms, please refer to the Intellectual Property Rights section of the Technical Committee web page (http://www.oasis-open.org/committees/kmip/ipr.php).
The non-normative errata page for this specification is located at http://www.oasis-open.org/committees/kmip/.
Copyright © OASIS® 2010. All Rights Reserved.
All capitalized terms in the following text have the meanings assigned to them in the OASIS Intellectual Property Rights Policy (the "OASIS IPR Policy"). The full Policy may be found at the OASIS website.
This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published, and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this section are included on all such copies and derivative works. However, this document itself may not be modified in any way, including by removing the copyright notice or references to OASIS, except as needed for the purpose of developing any document or deliverable produced by an OASIS Technical Committee (in which case the rules applicable to copyrights, as set forth in the OASIS IPR Policy, must be followed) or as required to translate it into languages other than English.
The limited permissions granted above are perpetual and will not be revoked by OASIS or its successors or assigns.
This document and the information contained herein is provided on an "AS IS" basis and OASIS DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
OASIS requests that any OASIS Party or any other party that believes it has patent claims that would necessarily be infringed by implementations of this OASIS Committee Specification or OASIS Standard, to notify OASIS TC Administrator and provide an indication of its willingness to grant patent licenses to such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this specification.
OASIS invites any party to contact the OASIS TC Administrator if it is aware of a claim of ownership of any patent claims that would necessarily be infringed by implementations of this specification by a patent holder that is not willing to provide a license to such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this specification. OASIS may include such claims on its website, but disclaims any obligation to do so.
OASIS takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on OASIS' procedures with respect to rights in any document or deliverable produced by an OASIS Technical Committee can be found on the OASIS website. Copies of claims of rights made available for publication and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this OASIS Committee Specification or OASIS Standard, can be obtained from the OASIS TC Administrator. OASIS makes no representation that any information or list of intellectual property rights will at any time be complete, or that any claims in such list are, in fact, Essential Claims.
The names "OASIS", “KMIP” are trademarks of OASIS, the owner and developer of this specification, and should be used only to refer to the organization and its official outputs. OASIS welcomes reference to, and implementation and use of, specifications, while reserving the right to enforce its marks against misleading uses. Please see http://www.oasis-open.org/who/trademark.php for above guidance.
1 Introduction.................................................................................................................................. 5
1.1 Terminology.......................................................................................................................... 5
1.2 Normative References............................................................................................................ 5
1.3 Non-normative References..................................................................................................... 5
2 Profiles........................................................................................................................................ 7
2.1 Guidelines for Specifying Conformance Clauses..................................................................... 7
2.2 Guidelines for Specifying Authentication Suites...................................................................... 7
2.3 Guidelines for Specifying KMIP Profiles................................................................................. 7
3 Authentication suites..................................................................................................................... 8
3.1 Basic Authentication Suite...................................................................................................... 8
3.1.1 Protocols....................................................................................................................... 8
3.1.2 Cipher Suites.................................................................................................................. 8
3.1.3 Client Authenticity........................................................................................................... 8
3.1.4 Object Creator................................................................................................................ 8
3.2 TLS 1.2 Authentication Suite................................................................................................... 9
3.2.1 Protocols....................................................................................................................... 9
3.2.2 Cipher Suites.................................................................................................................. 9
3.2.3 Client Authenticity........................................................................................................... 9
3.2.4 Object Creator................................................................................................................ 9
4 KMIP Profiles............................................................................................................................. 10
4.1 Secret Data KMIP Profile..................................................................................................... 10
4.2 Basic Symmetric Key Store and Server KMIP Profile............................................................. 10
4.3 Basic Symmetric Key Foundry and Server KMIP Profile......................................................... 10
4.4 Secret Data TLS 1.2 Authentication KMIP Profile................................................................... 10
4.5 Basic Symmetric Key Store and Server TLS 1.2 Authentication KMIP Profile........................... 10
4.6 Basic Symmetric Key Foundry and Server TLS 1.2 Authentication KMIP Profile....................... 10
5 Conformance Clauses................................................................................................................. 11
5.1 Secret Data Server Clause.................................................................................................... 11
5.1.1 Implementation Conformance........................................................................................ 11
5.1.2 Conformance of a Secret Data Server............................................................................ 11
5.2 Basic Symmetric Key Store and Server Conformance Clause................................................. 11
5.2.1 Implementation Conformance........................................................................................ 11
5.2.2 Conformance as a Basic Symmetric Key Store and Server.............................................. 12
5.3 Basic Symmetric Key Foundry and Server Conformance Clause............................................. 12
5.3.1 Implementation Conformance........................................................................................ 12
5.3.2 Conformance as a KMIP Basic Symmetric Key Foundry and Server................................. 12
A. Acknowledgements...................................................................................................................... 14
B. Revision History........................................................................................................................... 16
OASIS requires a conformance section in an approved committee specification (see [TCProc], section 2.18 Specification Quality):
A specification that is approved by the TC at the Public Review Draft, Committee Specification or OASIS Standard level must include a separate section, listing a set of numbered conformance clauses, to which any implementation of the specification must adhere in order to claim conformance to the specification (or any optional portion thereof).
This document intends to meet this OASIS requirement on conformance clauses for a KMIP Server ([KMIP-Spec] 12.1) through profiles that define the use of KMIP objects, attributes, operations, message elements and authentication methods within specific contexts of KMIP server and client interaction. These profiles define a set of normative constraints for employing KMIP within a particular environment or context of use. They may, optionally, require the use of specific KMIP functionality or in other respects define the processing rules to be followed by profile actors.
For normative definition of the elements of KMIP specified in these profiles, see the KMIP Specification. Illustrative guidance for the implementation of KMIP clients and servers is provided in the KMIP Usage Guide.
The key words "SHALL", "SHALL NOT", "REQUIRED", "SHOULD", "SHOULD NOT",
"RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119]. The words ‘must’, ‘can’, and ‘will’ are forbidden.
For definitions not found in this document, see [KMIP-Spec] definitionsError! Reference source not found..
[RFC2119] S. Bradner, Key words for use in RFCs to Indicate Requirement Levels, http://www.ietf.org/rfc/rfc2119.txt, IETF RFC 2119, March 1997.
[KMIP-Spec] OASIS Standard, Key Management Interoperability Protocol Specification Version 1.0, October 2010, http://docs.oasis-open.org/kmip/spec/v1.0/os/kmip-spec-1.0-os.doc
[RFC 2246] T. Dierks & C.Allen, The TLS Protocol, Version 1.0, http://www.ietf.org/rfc/rfc2246.txt, IETF RFC 2246, January 1999
[RFC 3268] P. Chown, Advanced Encryption Standard (AES) Ciphersuites for Transport Layer Security (TLS), http://www.ietf.org/rfc/rfc3268.txt, IETF RFC 3268, June 2002
[RFC 4346] T. Dierks & E. Rescorla, The Transport Layer Security (TLS) Protocol, Version 1.1, http://www.ietf.org/rfc/rfc4346.txt, IETF RFC 4346, April 2006
[RFC 5246] T. Dierks & E. Rescorla, The Transport Layer Security (TLS) Protocol, Version 1.2, http://www.ietf.org/rfc/rfc5246.txt, IETF RFC 5246, August 2008
[NIST 800-57 Part 3] Barker, Burr, et.al, Recommendation for Key Management Part 3: Application-Specific Key Management Guidance, http://csrc.nist.gov/publications/nistpubs/800-57/sp800-57_PART3_key-management_Dec2009.pdf, December 2009
[KMIP-UG] OASIS Committee Specification 01, Key Management Interoperability Protocol Usage Guide Version 1.0, June 2010, http://docs.oasis-open.org/kmip/ug/v1.0/cs01/kmip-ug-1.0-cs-01.doc
[KMIP-UC] OASIS Committee Specification 01, Key Management Interoperability Protocol Use Cases Version 1.0, June 2010, http://docs.oasis-open.org/kmip/usecases/v1.0/cs01/kmip-usecases-1.0-cs-01.doc
This document defines a selected set of conformance clauses and authentication suites which when “paired together” form KMIP Profiles. The KMIP TC also welcomes proposals for new profiles. KMIP TC members are encouraged to submit these proposals to the KMIP TC for consideration for inclusion in a future version of this TC-approved document. However, some OASIS members may simply wish to inform the committee of profiles or other work related to KMIP.
This section provides a checklist of issues that SHALL be addressed by each clause.
1. Implement functionality as mandated by Section 12.1 (Conformance clauses for a KMIP servers)
2. Specify the list of additional objects that SHALL be supported
3. Specify the list of additional attributes that SHALL be supported
4. Specify the list of additional operations that SHALL be supported
5. Specify any additional message content that SHALL be supported
1. Channel Security – Client to Server communication SHALL establish and maintain channel confidentiality and integrity, and provide assurance of server authenticity
2. Channel Options – Options like protocol version and cipher suite
3. Client Authenticity – The options that are used to provide assurance of client authenticity
A KMIP profile is a tuple of {Conformance Clause, Authentication Suite}
This section contains the list of protocol versions and cipher suites that are to be used by profiles contained within this document.
This authentication set stipulates that a KMIP client and server SHALL use TLS to negotiate a mutually-authenticated connection with the exception of the Query operation. The query operation SHALL NOT require the client to provide assurance of its authenticity.
Conformant KMIP servers SHALL support TLSv1.0. They MAY support TLS v1.1 [RFC 4346], TLS v1.2 [RFC 5246] bearing in mind that they are not compatible with each other and SHALL NOT support SSLv3.0, SSLv2.0 and SSLv1.0.
Conformant KMIP servers SHALL support the following cipher suites:
· TLS_RSA_WITH_AES_128_CBC_SHA
Basic Authentication Suite Conformant KMIP servers MAY support the cipher suites listed in tables 4-1 through 4-4 of NIST 800-57 Part 3 with the exception of NULL ciphers (at the time this document was created, the only NULL cipher in 800-57 Part 3 was: TLS_RSA_WITH_NONE_SHA)
Basic Authentication Suite Conformant KMIP servers SHALL NOT support any other cipher suites.
NOTE: TLS 1.0 has some security issues as described in http://www.openssl.org/~bodo/tls-cbc.txt. Implementations that need protections against this attack should considering using the “TLS 1.2 Authentication Suite”
At the time this document was published, NIST 800-57 Part 3 Table 4-1, for cipher suites that have both SHA1 and SHA256 variants, erroneously categorizes SHA256 based ciphers under TLS versions 1.0, 1.1 and 1.2 and SHA1 based ciphers under TLS 1.2. The correct value for SHA256 based ciphers should 1.2 and for SHA1 based ciphers it should be 1.0, 1.2 and 1.2.
For authenticated services (all operations save Query) KMIP
servers SHALL require the use of channel (TLS) mutual authentication to provide
assurance of client authenticity.
In the absence of Credential information in the request header, KMIP servers
SHALL use the identity derived from the channel authentication as the client
identity.
In the presence of Credential information in the request header, KMIP servers
SHALL consider such Credential information into their evaluation of client
authenticity and identity, along with the authenticity and identity derived
from the channel. The exact mechanisms for such evaluation are outside
the scope of this specification.
KMIP objects have a creator. For those KMIP requests that result in new managed objects the client identity SHALL be used as the creator of the managed object. For those operations that only access pre-existent managed objects, the client identity SHALL be checked against the creator and access SHALL be controlled as detailed in section 3.13 of [KMIP].
This authentication set stipulates that a KMIP client and server SHALL use TLS to negotiate a mutually-authenticated connection with the exception of the Query operation. The query operation SHALL NOT require the client to provide assurance of its authenticity.
Conformant KMIP servers SHALL support TLSv1.2
Conformant KMIP servers SHALL support the following cipher suites:
· TLS_RSA_WITH_AES_256_CBC_SHA256
· TLS_RSA_WITH_AES_128_CBC_SHA256
TLS 1.2 Authentication Suite Conformant KMIP servers MAY support the cipher suites listed in tables 4-1 through 4-4 of NIST 800-57 Part 3 with the exception of NULL ciphers (at the time this document was created, the only NULL cipher in 800-57 Part 3 was: TLS_RSA_WITH_NONE_SHA)
TLS 1.2 Authentication Suite Conformant KMIP servers SHALL NOT support any other cipher suites
NIST 800-57 Part 3 Table 4-1, for cipher suites that have both SHA1 and SHA256 variants, erroneously categorizes SHA256 based ciphers under TLS versions 1.0, 1.1 and 1.2 and SHA1 based ciphers under TLS 1.2. The correct value for SHA256 based ciphers should 1.2 and for SHA1 based ciphers it should be 1.0, 1.2 and 1.2.
Same as the basic authentication suite (See Section 3.1.3)
Same as the basic authentication suite (See Section 3.1.4)
This section lists the KMIP profiles that are defined in this specification. More than one profile may be supported at the same time provided there are no conflicting requirements.
A profile that consists of the tuple {Secret Data Server Conformance Clause, Basic Authentication Suite}
A profile that consists of the tuple {Basic Symmetric Key Store and Server Conformance Clause, Basic Authentication Suite}
A profile that consists of the tuple {Basic Symmetric Key Foundry and Server Conformance Clause, Basic Authentication Suite}
A profile that consists of the tuple {Secret Data Server Conformance Clause, TLS 1.2 Authentication Suite}
A profile that consists of the tuple {Basic Symmetric Key Store and Server Conformance Clause, TLS 1.2 Authentication Suite}
A profile that consists of the tuple {Basic Symmetric Key Foundry and Server Conformance Clause, TLS 1.2 Authentication Suite}
The following subsections describe currently-defined profiles related to the use of KMIP in support of secret data and symmetric key operations.
This proposal builds on the KMIP server conformance clauses to provide some of the most basic functionality that would be expected of a conformant KMIP server – the ability to create, register and get secret data in an interoperable fashion.
An implementation is a conforming Secret Data Server Clause if it meets the conditions as outlined in the following section.
An implementation conforms to this specification as a Secret Data Server if it meets the following conditions:
i. Secret Data
i. Password
i. Opaque
This proposal builds on the KMIP server conformance clauses to provide support for symmetric key store and foundry use cases.
An implementation is a conforming KMIP Basic Symmetric Key Store and Server if the implementation meets the conditions as outlined in the following section.
An implementation conforms to this specification as a Basic Symmetric Key Store and Server if it meets the following conditions:
i. 3DES
ii. AES
i. Symmetric Key
i. Raw
ii. Transparent Symmetric Key
This proposal intends to meet this OASIS requirement by building on the KMIP Server Conformance Clause defined in the KMIP Specification to provide basic symmetric key services. The intent is to simply allow key creation and serving with very limited key types.
An implementation is a conforming KMIP Basic Symmetric Key Store and Server if the implementation meets the conditions as outlined in the following section.
An implementation conforms to this specification as a KMIP Basic Symmetric Key Foundry and Server if it meets the following conditions:
i. 3DES
ii. AES
i. Symmetric Key
i. Raw
ii. Transparent Symmetric Key
The following individuals have participated in the creation of this specification and are gratefully acknowledged:
Original Authors of the initial contribution:
Bruce Rich, IBM
Mike Allen, PGP Corporation
Gordon Arnold, IBM
Todd Arnold, IBM
Matthew Ball, Oracle Corporation
Elaine Barker, NIST
Peter Bartok, Venafi, Inc.
Mathias Björkqvist, IBM
Kevin Bocek, Thales e-Security
Kelley Burgin, National Security Agency
Jon Callas, PGP Corporation
Tom Clifford, Symantec Corp.
Graydon Dodson, Lexmark International Inc.
Chris Dunn, SafeNet, Inc.
Paul Earsy, SafeNet, Inc.
Stan Feather, Hewlett-Packard
Indra Fitzgerald, Hewlett-Packard
Alan Frindell, SafeNet, Inc.
Judith Furlong, EMC Corporation
Jonathan Geater, Thales e-Security
Robert Griffin, EMC Corporation
Robert Haas, IBM
Thomas Hardjono, M.I.T.
Kurt Heberlein, 3PAR, Inc.
Marc Hocking, BeCrypt Ltd.
Larry Hofer, Emulex Corporation
Brandon Hoff, Emulex Corporation
Walt Hubis, LSI Corporation
Tim Hudson, Cryptsoft Pty Ltd.
Wyllys Ingersoll, Oracle Corporation
Jay Jacobs, Target Corporation
Glen Jaquette, IBM
Scott Kipp, Brocade Communications Systems, Inc.
David Lawson, Emulex Corporation
Hal Lockhart, Oracle Corporation
Robert Lockhart, Thales e-Security
Shyam Mankala, EMC Corporation
Upendra Mardikar, PayPal Inc.
Marc Massar, Individual
Don McAlister, Associate
Hyrum Mills, Mitre Corporation
Bob Nixon, Emulex Corporation
Landon Curt Noll, Cisco Systems, Inc.
René Pawlitzek, IBM
John Peck, IBM
Rob Philpott, EMC Corporation
Scott Rea, Individual
Bruce Rich, IBM
Scott Rotondo, Oracle Corporation
Saikat Saha, Vormetric, Inc.
Anil Saldhana, Red Hat
Subhash Sankuratripati, NetApp
Mark Schiller, Hewlett-Packard
Jitendra Singh, Brocade Communications Systems, Inc.
Servesh Singh, EMC Corporation
Terence Spies, Voltage Security
Sandy Stewart, Oracle Corporation
Marcus Streets, Thales e-Security
Brett Thompson, SafeNet, Inc.
Benjamin Tomhave, Individual
Sean Turner, IECA, Inc.
Paul Turner, Venafi, Inc.
Marko Vukolić, IBM
Rod Wideman, Quantum Corporation
Steven Wierenga, Hewlett-Packard
Peter Yee, EMC Corporation
Krishna Yellepeddy, IBM
Peter Zelechoski, Election Systems & Software
Grace Zhang, Skyworth TTG Holdings Limited
Revision |
Date |
Editor |
Changes Made |
ed-0.98 |
2009-09-18 |
Robert Griffin |
Initial conversion of symmetric key profiles, as created by Bruce Rich, into this KMIP Profiles document. |
ed-0.98 |
2009-09-29 |
Subhash Sankuratripati |
Adding the notion of authentication sets |
ed-0.99 |
2009-10-05 |
Subhash Sankuratripati |
Incorporating feedback that was received during the F2F |
ed-0.99 |
2009-10-21 |
Subhash Sankuratripati |
Incorporating additional feedback and getting the document ready to be committee draft |
ed-0.99 |
2009-10-23 |
Subhash Sankuratripati |
Other minor edits |
ed-0.99 |
2009-11-01 |
Subhash Sankuratripati |
More editorial changes |
ed-0.99 |
2009-11-06 |
Subhash Sankuratripati |
Version that is to be submitted as committee draft |
cd-01 |
2009-11-06 |
Subhash Sankuratripati |
First version as committee draft |
cd-02 |
2009-11-09 |
Subhash Sankuratripati |
Corrected reference to conformance clause section of [KMIP-Spec] from 13.1 to 12.1 and another minor edit. |
cd-03 |
2009-11-11 |
Subhash Sankuratripati |
Accepting all changes and removing previous versions |
cd-04 |
2010-11-12 |
Subhash Sankuratripati |
Corrected document URIs |
cd-05 |
2010-03-05 |
Subhash Sankuratripati |
Addressing public review comments by adding - Support for TLS 1.2, - Adding references to normative documents - Added an informative warning regarding the usage of TLS 1.0 in certain scenarios due to a security issue - Added an errata for NIST 800-57 Part 3 |
cd-06 |
2010-05-26 |
Subhash Sankuratripati |
Updating references to latest committee draft versions and participant list |