GSS-API Key Exchange with SHA2

SSH GSS-API Methods allows the use of GSSAPI for authentication and key exchange in SSH. It defines three exchange methods all based on DH groups and SHA-1. This document updates RFC4462 with new methods intended to support environments that desire to use the SHA-2 cryptographic hash functions.

Due to security concerns with SHA-1 and with MODP groups with less than 2048 bits we propose the use of hashes based on SHA-2 with DH group14, group15, group16, group17 and group18 . Additionally we add support for key exchange based on Elliptic Curve Diffie Hellman with the NIST P-256, P-384 and P-521 as well as the X25519 and X448 curves. Following the practice of only SHA-256 and SHA-512 hashes are used for DH groups. For NIST curves the same curve-to-hashing algorithm pairing used in is adopted for consistency.

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 BCP 14 RFC2119 RFC8174 when, and only when, they appear in all capitals, as shown here.

This document adopts the same naming convention defined in to define families of methods that cover any GSS-API mechanism used with a specific Diffie-Hellman group and SHA-2 Hash combination. Key Exchange Method Name Implementation Recommendations gss-group14-sha256-*SHOULD/RECOMMENDED gss-group15-sha512-*MAY/OPTIONAL gss-group16-sha512-*SHOULD/RECOMMENDED gss-group17-sha512-*MAY/OPTIONAL gss-group18-sha512-*MAY/OPTIONAL Each key exchange method prefix is registered by this document. The IESG is the change controller of all these key exchange methods; this does NOT imply that the IESG is considered to be in control of the corresponding GSS-API mechanism. Each method in any family of methods specifies GSS-API-authenticated Diffie-Hellman key exchanges as described in Section 2.1 of . The method name for each method is the concatenation of the family name prefix with the Base64 encoding of the MD5 hash of the ASN.1 DER encoding of the corresponding GSS-API mechanism's OID. Base64 encoding is described in Section 4 of . Family Name prefix Hash Function Group Reference gss-group14-sha256-SHA-2562048-bit MODP Section 3 of gss-group15-sha512-SHA-5123072-bit MODP Section 4 of gss-group16-sha512-SHA-5124096-bit MODP Section 5 of gss-group17-sha512-SHA-5126144-bit MODP Section 6 of gss-group18-sha512-SHA-5128192-bit MODP Section 7 of

In new SSH key exchange algorithms based on Elliptic Curve Cryptography are introduced. We reuse much of section 4 of to define GSS-API-authenticated ECDH Key Exchanges. Additionally, we also utilize the curves defined in to complement the three classic NIST-defined curves required by .

This section reuses much of the scheme defined in Section 2.1 of and combines it with the scheme defined in Section 4 of ; in particular, all checks and verification steps prescribed in Section 4 of apply here as well. Key-agreement schemes ECDHE-Curve25519 and ECDHE-Curve448 perform the Diffie-Helman protocol using the functions X25519 and X448, respectively. Implementations MUST compute these functions using the algorithms described in . When they do so, implementations MUST check whether the computed Diffie-Hellman shared secret is the all-zero value and abort if so, as described in Section 6 of . Alternative implementations of these functions SHOULD abort when either input forces the shared secret to one of a small set of values, as discussed in Section 7 of . This section defers to as the source of information on GSS-API context establishment operations, Section 3 being the most relevant. All Security Considerations described in apply here too. The parties each generate an ephemeral key pair, according to Section 3.2.1 of . Keys are verified upon receipt by the parties according to Section 3.2.3.1 of . For NIST Curves the keys use the uncompressed point representation and MUST be converted using the algorithm in Section 2.3.4 of . If the conversion fails or the point is transmitted using the compressed representation, the key exchange MUST fail. A GSS Context is established according to Section 4 of ; The client initiates the establishment using GSS_Init_sec_context() and the server responds to it using GSS_Accept_sec_context(). For the negotiation, the client MUST set mutual_req_flag and integ_req_flag to "true". In addition, deleg_req_flag MAY be set to "true" to request access delegation, if requested by the user. Since the key exchange process authenticates only the host, the setting of anon_req_flag is immaterial to this process. If the client does not support the "gssapi-keyex" user authentication method described in Section 4 of , or does not intend to use that method in conjunction with the GSS-API context established during key exchange, then anon_req_flag SHOULD be set to "true". Otherwise, this flag MAY be set to true if the client wishes to hide its identity. This key exchange process will exchange only a single message token once the context has been established, therefore the replay_det_req_flag and sequence_req_flag SHOULD be set to "false". The client MUST include its public key with the first message it sends to the server during this process; if the server receives more than one key or none at all, the key exchange MUST fail. During GSS Context establishment multiple tokens may be exchanged by the client and the server. When the GSS Context is established (major_status is GSS_S_COMPLETE) the parties check that mutual_state and integ_avail are both "true". If not the key exchange MUST fail. Once a party receives the peer's public key it proceeds to compute a shared secret K. For NIST Curves the computation is done according to Section 3.3.1 of and the resulting value z is converted to the octet string K using the conversion defined in Section 2.3.5 of . For curve25519 and curve448 the algorithms in Section 6 of are used instead. To verify the integrity of the handshake, peers use the Hash Function defined by the selected Key Exchange method to calculate H: H = hash(V_C || V_S || I_C || I_S || K_S || Q_C || Q_S || K). The GSS_GetMIC() call is used by the server with H as the payload and generates a MIC. The GSS_VerifyMIC() call is used by the client to verify the MIC. If any GSS_Init_sec_context() or GSS_Accept_sec_context() returns a major_status other than GSS_S_COMPLETE or GSS_S_CONTINUE_NEEDED, or any other GSS-API call returns a major_status other than GSS_S_COMPLETE, the key exchange MUST fail. The same recommendations expressed in Section 2.1 of are followed with regards to error reporting. The following is an overview of the key exchange process:

Client Server ------ ------ Generate ephemeral key pair. Calls GSS_Init_sec_context(). SSH_MSG_KEXGSS_INIT ---------------> Verify received key is valid. (Optional) <------------- SSH_MSG_KEXGSS_HOSTKEY (Loop) | Calls GSS_Accept_sec_context(). | <------------ SSH_MSG_KEXGSS_CONTINUE | Calls GSS_Init_sec_context(). | SSH_MSG_KEXGSS_CONTINUE ------------> Calls GSS_Accept_sec_context(). Generate ephemeral key pair. Compute shared secret. Computes hash H. Calls GSS_GetMIC( H ) = MIC. <------------ SSH_MSG_KEXGSS_COMPLETE Verify received key is valid. Compute shared secret. Compute hash = H Calls GSS_VerifyMIC( MIC, H ) This is implemented with the following messages:

The client sends: byte SSH_MSG_KEXGSS_INIT string output_token (from GSS_Init_sec_context()) string Q_C, client's ephemeral public key octet string

The server may respond with: byte SSH_MSG_KEXGSS_HOSTKEY string server public host key and certificates (K_S)

The server sends: byte SSH_MSG_KEXGSS_CONTINUE string output_token (from GSS_Accept_sec_context()) Each time the client receives the message described above, it makes another call to GSS_Init_sec_context().

The client sends: byte SSH_MSG_KEXGSS_CONTINUE string output_token (from GSS_Init_sec_context())

As the final message the server sends either: byte SSH_MSG_KEXGSS_COMPLETE string Q_S, server's ephemeral public key octet string string mic_token (MIC of H) boolean TRUE string output_token (from GSS_Accept_sec_context())

Or the following if no output_token is available: byte SSH_MSG_KEXGSS_COMPLETE string Q_S, server's ephemeral public key octet string string mic_token (MIC of H) boolean FALSE

The hash H is computed as the HASH hash of the concatenation of the following: string V_C, the client's version string (CR, NL excluded) string V_S, server's version string (CR, NL excluded) string I_C, payload of the client's SSH_MSG_KEXINIT string I_S, payload of the server's SSH_MSG_KEXINIT string K_S, server's public host key string Q_C, client's ephemeral public key octet string string Q_S, server's ephemeral public key octet string mpint K, shared secret This value is called the exchange hash, and it is used to authenticate the key exchange. The exchange hash SHOULD be kept secret. If no SSH_MSG_KEXGSS_HOSTKEY message has been sent by the server or received by the client, then the empty string is used in place of K_S when computing the exchange hash. Since this key exchange method does not require the host key to be used for any encryption operations, the SSH_MSG_KEXGSS_HOSTKEY message is OPTIONAL. If the "null" host key algorithm described in Section 5 of is used, this message MUST NOT be sent. If the client receives a SSH_MSG_KEXGSS_CONTINUE message after a call to GSS_Init_sec_context() has returned a major_status code of GSS_S_COMPLETE, a protocol error has occurred and the key exchange MUST fail. If the client receives a SSH_MSG_KEXGSS_COMPLETE message and a call to GSS_Init_sec_context() does not result in a major_status code of GSS_S_COMPLETE, a protocol error has occurred and the key exchange MUST fail.

Key Exchange Method Name Implementation Recommendations gss-nistp256-sha256-*SHOULD/RECOMMENDED gss-nistp384-sha384-*MAY/OPTIONAL gss-nistp521-sha512-*MAY/OPTIONAL gss-curve25519-sha256-*SHOULD/RECOMMENDED gss-curve448-sha512-*MAY/OPTIONAL Each key exchange method prefix is registered by this document. The IESG is the change controller of all these key exchange methods; this does NOT imply that the IESG is considered to be in control of the corresponding GSS-API mechanism. Each method in any family of methods specifies GSS-API-authenticated Elliptic Curve Diffie-Hellman key exchanges as described in . The method name for each method is the concatenation of the family method name with the Base64 encoding of the MD5 hash of the ASN.1 DER encoding of the corresponding GSS-API mechanism's OID. Base64 encoding is described in Section 4 of . Family Name prefix Hash Function Parameters / Function Name Definition gss-nistp256-sha256-SHA-256secp256r1 Section 2.4.2 of gss-nistp384-sha384-SHA-384secp384r1 Section 2.5.1 of gss-nistp521-sha512-SHA-512secp521r1 Section 2.6.1 of gss-curve25519-sha256-SHA-256X22519 Section 5 of gss-curve448-sha512-SHA-512X448 Section 5 of

Because they have small key lengths and are no longer strong in the face of brute-force attacks, the algorithms in the following table are considered deprecated and SHOULD NOT be used. Deprecated Algorithms Key Exchange Method Name Implementation Recommendations gss-group1-sha1-*SHOULD NOT gss-group14-sha1-*SHOULD NOT gss-gex-sha1-*SHOULD NOT

This document augments the SSH Key Exchange Method Names in . IANA is requested to update the SSH Protocol Parameters registry with the following entries: Key Exchange Method Name Reference gss-group1-sha1-*This draft gss-group14-sha1-*This draft gss-gex-sha1-*This draft gss-group14-sha256-*This draft gss-group15-sha512-*This draft gss-group16-sha512-*This draft gss-group17-sha512-*This draft gss-group18-sha512-*This draft gss-nistp256-sha256-*This draft gss-nistp384-sha384-*This draft gss-nistp521-sha512-*This draft gss-curve25519-sha256-*This draft gss-curve448-sha512-*This draft

Except for the use of a different secure hash function and larger DH groups, no significant changes has been made to the protocol described by ; therefore all the original Security Considerations apply.

Although a new cryptographic primitive is used with these methods the actual key exchange closely follows the key exchange defined in ; therefore all the original Security Considerations as well as those expressed in apply.

Some GSSAPI mechanisms can act on a request to delegate credentials to the target host when the deleg_req_flag is set. In this case, extra care must be taken to ensure that the acceptor being authenticated matches the target the user intended. Some mechanism implementations (such as commonly used krb5 libraries) may use insecure DNS resolution to canonicalize the target name; in these cases spoofing a DNS response that points to an attacker-controlled machine may result in the user silently delegating credentials to the attacker, who can then impersonate the user at will.