💾 Archived View for gemini.bortzmeyer.org › rfc-mirror › rfc2943.txt captured on 2023-06-14 at 18:02:24.
⬅️ Previous capture (2021-11-30)
-=-=-=-=-=-=-
Network Working Group R. Housley
Request for Comments: 2943 T. Horting
Category: Standards Track P. Yee
SPYRUS
September 2000
TELNET Authentication Using DSA
Status of this Memo
This document specifies an Internet standards track protocol for the
Internet community, and requests discussion and suggestions for
improvements. Please refer to the current edition of the "Internet
Official Protocol Standards" (STD 1) for the standardization state
and status of this protocol. Distribution of this memo is unlimited.
Copyright Notice
Copyright (C) The Internet Society (2000). All Rights Reserved.
Abstract
This document defines a telnet authentication mechanism using the
Digital Signature Algorithm (DSA) [FIPS186]. It relies on the Telnet
Authentication Option [RFC2941].
1. Command Names and Codes
AUTHENTICATION 37
Authentication Commands:
IS 0
SEND 1
REPLY 2
NAME 3
Authentication Types:
DSS 14
Modifiers:
AUTH_WHO_MASK 1
AUTH_CLIENT_TO_SERVER 0
AUTH_SERVER_TO CLIENT 1
Housley, et al. Standards Track [Page 1]
RFC 2943 TELNET Authentication Using DSA September 2000
AUTH_HOW_MASK 2
AUTH_HOW_ONE_WAY 0
AUTH_HOW_MUTUAL 2
ENCRYPT_MASK 20
ENCRYPT_OFF 0
ENCRYPT_USING_TELOPT 4
ENCRYPT_AFTER_EXCHANGE 16
ENCRYPT_RESERVED 20
INI_CRED_FWD_MASK 8
INI_CRED_FWD_OFF 0
INI_CRED_FWD_ON 8
Sub-option Commands:
DSS_INITIALIZE 1
DSS_TOKENBA 2
DSS_CERTA_TOKENAB 3
DSS_CERTB_TOKENBA2 4
2. TELNET Security Extensions
TELNET, as a protocol, has no concept of security. Without
negotiated options, it merely passes characters back and forth
between the NVTs represented by the two TELNET processes. In its
most common usage as a protocol for remote terminal access (TCP port
23), TELNET connects to a server that requires user-level
authentication through a user name and password in the clear; the
server does not authenticate itself to the user.
The TELNET Authentication Option provides for user authentication and
server authentication. User authentication replaces or augments the
normal host password mechanism. Server authentication is normally
done in conjunction with user authentication.
In order to support these security services, the two TELNET entities
must first negotiate their willingness to support the TELNET
Authentication Option. Upon agreeing to support this option, the
parties are then able to perform sub-option negotiations to the
authentication protocol to be used, and possibly the remote user name
to be used for authorization checking.
Authentication and parameter negotiation occur within an unbounded
series of exchanges. The server proposes a preference-ordered list
of authentication types (mechanisms) which it supports. In addition
to listing the mechanisms it supports, the server qualifies each
mechanism with a modifier that specifies whether the authentication
Housley, et al. Standards Track [Page 2]
RFC 2943 TELNET Authentication Using DSA September 2000
is to be one-way or mutual, and in which direction the authentication
is to be performed. The client selects one mechanism from the list
and responds to the server indicating its choice and the first set of
authentication data needed for the selected authentication type. The
server and the client then proceed through whatever number of
iterations are required to arrive at the requested authentication.
3. Use of Digital Signature Algorithm (DSA)
DSA is also known as the Digital Signature Standard (DSS), and the
names are used interchangeably. This paper specifies a method in
which DSA may be used to achieve certain security services when used
in conjunction with the TELNET Authentication Option. SHA-1
[FIPS180-1] is used with DSA [FIPS186].
DSA may provide either unilateral or mutual authentication. Due to
TELNET's character-by-character nature, it is not well-suited to the
application of integrity-only services, therefore use of the DSA
profile provides authentication but it does not provide session
integrity. This specification follows the token and exchanges
defined in NIST FIPS PUB 196 [FIPS196], Standard for Public Key
Cryptographic Entity Authentication Mechanisms including Appendix A
on ASN.1 encoding of messages and tokens. All data that is covered
by a digital signature must be encoded using the Distinguished
Encoding Rules (DER). However, other data may use either the Basic
Encoding Rules (BER) or DER [X.208].
3.1. Unilateral Authentication with DSA
Unilateral authentication must be done client-to-server. What
follows are the protocol steps necessary to perform DSA
authentication as specified in FIPS PUB 196 under the TELNET
Authentication Option framework. Where failure modes are
encountered, the return codes follow those specified in the TELNET
Authentication Option. They are not enumerated here, as they are
invariant among the mechanisms used. FIPS PUB 196 employs a set of
exchanges that are transferred to provide authentication. Each
exchange employs various fields and tokens, some of which are
optional. In addition, each token has several subfields that are
optional. A conformant subset of the fields and subfields have been
selected. The tokens are ASN.1 encoded as defined in Appendix A of
FIPS PUB 196, and each token is named to indicate the direction in
which it flows (e.g., TokenBA flows from Party B to Party A). All
data that is covered by a digital signature must be encoded using the
Housley, et al. Standards Track [Page 3]
RFC 2943 TELNET Authentication Using DSA September 2000
Distinguished Encoding Rules (DER). Data that is not covered by a
digital signature may use either the Basic Encoding Rules (BER) or
DER [X.208]. Figure 1 illustrates the exchanges for unilateral
authentication.
During authentication, the client may provide the user name to the
server by using the authentication name sub-option. If the name
sub-option is not used, the server will generally prompt for a name
and password in the clear. The name sub-option must be sent after
the server sends the list of authentication types supported and
before the client finishes the authentication exchange, this ensures
that the server will not prompt for a user name and password. In
figure 1, the name sub-option is sent immediately after the server
presents the list of authentication types supported.
For one-way DSS authentication, the two-octet authentication type
pair is DSS AUTH_CLIENT_TO_SERVER | AUTH_HOW_ONE_WAY | ENCRYPT_OFF |
INI_CRED_FWD_OFF. This indicates that the DSS authentication
mechanism will be used to authenticate the client to the server and
that no encryption will be performed.
CertA is the clients certificate. Both certificates are X.509
certificates that contain DSS public keys[RFC2459]. The client must
validate the server's certificate before using the DSA public key it
contains.
Within the unbounded authentication exchange, implementation is
greatly simplified if each portion of the exchange carries a unique
identifier. For this reason, a single octet sub-option identifier is
carried immediately after the two-octet authentication type pair.
The exchanges detailed in Figure 1 below presume knowledge of FIPS
PUB 196 and the TELNET Authentication Option. The client is Party A,
while the server is Party B. At the end of the exchanges, the client
is authenticated to the server.
Housley, et al. Standards Track [Page 4]
RFC 2943 TELNET Authentication Using DSA September 2000
------------------------------------------------------------------
Client (Party A) Server (Party B)
<-- IAC DO AUTHENTICATION
IAC WILL AUTHENTICATION -->
<-- IAC SB AUTHENTICATION SEND
<list of authentication options>
IAC SE
IAC SB AUTHENTICATION
NAME <user name> -->
IAC SB AUTHENTICATION IS
DSS
AUTH_CLIENT_TO_SERVER |
AUTH_HOW_ONE_WAY |
ENCRYPT_OFF |
INI_CRED_FWD_OFF
DSS_INITIALIZE
IAC SE -->
<-- IAC SB AUTHENTICATION REPLY
DSS
AUTH_CLIENT_TO_SERVER |
AUTH_HOW_ONE_WAY |
ENCRYPT_OFF |
INI_CRED_FWD_OFF
DSS_TOKENBA
Sequence( TokenID, TokenBA )
IAC SE
IAC SB AUTHENTICATION IS
DSS
AUTH_CLIENT_TO_SERVER |
AUTH_HOW_ONE_WAY |
ENCRYPT_OFF |
INI_CRED_FWD_OFF
DSS_CERTA_TOKENAB
Sequence( TokenID, CertA, TokenAB )
IAC SE -->
------------------------------------------------------------------
Figure 1
Housley, et al. Standards Track [Page 5]
RFC 2943 TELNET Authentication Using DSA September 2000
3.2. Mutual Authentication with DSA
Mutual authentication is slightly more complex. Figure 2 illustrates
the exchanges.
For mutual DSS authentication, the two-octet authentication type pair
is DSS AUTH_CLIENT_TO_SERVER | AUTH_HOW_MUTUAL | ENCRYPT_OFF |
INI_CRED_FWD_OFF. This indicates that the DSS authentication
mechanism will be used to mutually authenticate the client and the
server and that no encryption will be performed.
---------------------------------------------------------------------
Client (Party A) Server (Party B)
IAC WILL AUTHENTICATION -->
<-- IAC DO AUTHENTICATION
<-- IAC SB AUTHENTICATION SEND
<list of authentication options>
IAC SE
IAC SB AUTHENTICATION
NAME <user name> -->
IAC SB AUTHENTICATION IS
DSS
AUTH_CLIENT_TO_SERVER |
AUTH_HOW_MUTUAL |
ENCRYPT_OFF |
INI_CRED_FWD_OFF
DSS_INITIALIZE
IAC SE -->
<-- IAC SB AUTHENTICATION REPLY
DSS
AUTH_CLIENT_TO_SERVER |
AUTH_HOW_MUTUAL |
ENCRYPT_OFF |
INI_CRED_FWD_OFF
DSS_TOKENBA
Sequence( TokenID, TokenBA )
IAC SE
Housley, et al. Standards Track [Page 6]
RFC 2943 TELNET Authentication Using DSA September 2000
Client (Party A) Server (Party B)
IAC SB AUTHENTICATION IS
DSS
AUTH_CLIENT_TO_SERVER |
AUTH_HOW_MUTUAL |
ENCRYPT_OFF |
INI_CRED_FWD_OFF
DSS_CERTA_TOKENAB
Sequence( TokenID, CertA, TokenAB )
IAC SE -->
<-- IAC SB AUTHENTICATION REPLY
DSS
AUTH_CLIENT_TO_SERVER |
AUTH_HOW_MUTUAL |
ENCRYPT_OFF |
INI_CRED_FWD_OFF
DSS_CERTB_TOKENBA2
Sequence( TokenID, CertB,
TokenBA2 )
IAC SE
---------------------------------------------------------------------
Figure 2
4. ASN.1 Syntax
As stated earlier, a conformant subset of the defined fields and
subfields from FIPS PUB 196 have been selected. This section
provides the ASN.1 syntax for that conformant subset.
Figure 1 and Figure 2 include representations of the structures
defined in this section. Implementors should refer to the following
table to determine the ASN.1 definitions that match the figure
references:
Figure 1 Sequence( TokenID, TokenBA ) MessageBA
Sequence( TokenID, CertA, TokenAB ) MessageAB
Figure 2 Sequence( TokenID, TokenBA ) MessageBA
Sequence( TokenID, CertA, TokenAB ) MessageAB
Sequence( TokenID, CertB, TokenBA2 ) MessageBA2
The following ASN.1 definitions specify the conformant subset of FIPS
196. For simplicity, no optional fields or subfields are included.
The ASN.1 definition for CertificationPath is imported from CCITT
Recommendation X.509 [X.509], and The ASN.1 definition for Name is
imported from CCITT Recommendation X.501 [X.501]. These ASN.1
Housley, et al. Standards Track [Page 7]
RFC 2943 TELNET Authentication Using DSA September 2000
definitions are not repeated here. All DSA signature values are
encoded as a sequence of two integers, employing the same conventions
specified in RFC 2459, section 7.2.2.
MessageBA ::= SEQUENCE {
tokenId [0] TokenId,
tokenBA TokenBA }
TokenBA ::= SEQUENCE {
ranB RandomNumber,
timestampB TimeStamp }
MessageAB ::= SEQUENCE {
tokenId [0] TokenId,
certA [1] CertData,
tokenAB TokenAB }
TokenAB ::= SEQUENCE {
ranA RandomNumber,
ranB RandomNumber,
entityB EntityName,
timestampB TimeStamp,
absigValue OCTET STRING }
MessageBA2 ::= SEQUENCE {
tokenId [0] TokenId,
certB [1] CertData,
tokenBA2 TokenBA2 }
TokenBA2 ::= SEQUENCE {
ranB [0] RandomNumber,
ranA [1] RandomNumber,
entityA EntityName,
timestampB2 TimeStamp,
ba2sigValue OCTET STRING }
CertData ::= SEQUENCE {
certPath [0] CertificationPath } -- see X.509
EntityName ::= SEQUENCE OF CHOICE { -- only allow one!
directoryName [4] Name } -- see X.501
RandomNumber ::= INTEGER -- 20 octets
Housley, et al. Standards Track [Page 8]
RFC 2943 TELNET Authentication Using DSA September 2000
TokenId ::= SEQUENCE {
tokenType INTEGER, -- see table below
protoVerNo INTEGER } -- always 0x0001
TimeStamp ::= GeneralizedTime
The TokenId.TokenType is used to distinguish the message type and the
authentication type (either unilateral or mutual). The following
table provides the values needed to implement this specification:
Message Type Authentication Type TokenId.TokenType
MessageBA Unilateral 0x0001
Mutual 0x0011
MessageAB Unilateral 0x0002
Mutual 0x0012
MessageBA Mutual 0x0013
5. Security Considerations
This entire memo is about security mechanisms. For DSA to provide
the authentication discussed, the implementation must protect the
private key from disclosure.
Implementations must randomly generate DSS private keys, 'k' values
used in DSS signatures, and nonces. The use of inadequate pseudo-
random number generators (PRNGs) to generate cryptographic values can
result in little or no security. An attacker may find it much easier
to reproduce the PRNG environment that produced the values, searching
the resulting small set of possibilities, rather than using a brute
force search. The generation of quality random numbers is difficult.
RFC 1750 [RFC1750] offers important guidance in this area, and
Appendix 3 of FIPS PUB 186 [FIPS186] provides one quality PRNG
technique.
6. Acknowledgements
We would like to thank William Nace for support during implementation
of this specification.
Housley, et al. Standards Track [Page 9]
RFC 2943 TELNET Authentication Using DSA September 2000
7. IANA Considerations
The authentication type DSS and its associated suboption values are
registered with IANA. Any suboption values used to extend the
protocol as described in this document must be registered with IANA
before use. IANA is instructed not to issue new suboption values
without submission of documentation of their use.
8. References
FIPS180-1 Secure Hash Standard. FIPS Pub 180-1. April 17, 1995.
<http://csrc.nist.gov/fips/fips180-1.pdf>
FIPS186 Digital Signature Standard (DSS). FIPS Pub 186. May 19,
1994. <http://csrc.nist.gov/fips/fips186.pdf>
FIPS196 Standard for Entity Authentication Using Public Key
Cryptography. FIPS Pub 196. February 18, 1997.
<http://csrc.nist.gov/fips/fips196.pdf>
RFC1750 Eastlake, 3rd, D., Crocker, S. and J. Schiller, "Randomness
Recommendations for Security", RFC 1750, December 1994.
RFC2459 Housley, R., Ford, W., Polk, W. and D. Solo, "Internet
X.509 Public Key Infrastructure: X.509 Certificate and CRL
Profile", RFC 2459, January 1999.
RFC2941 T'so, T. and J. Altman, "Telnet Authentication Option", RFC
2941, September 2000.
X.208 CCITT. Recommendation X.208: Specification of Abstract
Syntax Notation One (ASN.1). 1988.
X.501 CCITT. Recommendation X.501: The Directory - Models. 1988.
X.509 CCITT. Recommendation X.509: The Directory -
Authentication Framework. 1988.
Housley, et al. Standards Track [Page 10]
RFC 2943 TELNET Authentication Using DSA September 2000
9. Authors' Addresses
Russell Housley
SPYRUS
381 Elden Street, Suite 1120
Herndon, VA 20172
USA
EMail: housley@spyrus.com
Todd Horting
SPYRUS
381 Elden Street, Suite 1120
Herndon, VA 20172
USA
EMail: thorting@spyrus.com
Peter Yee
SPYRUS
5303 Betsy Ross Drive
Santa Clara, CA 95054
USA
EMail: yee@spyrus.com
Housley, et al. Standards Track [Page 11]
RFC 2943 TELNET Authentication Using DSA September 2000
10. Full Copyright Statement
Copyright (C) The Internet Society (2000). All Rights Reserved.
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 paragraph are
included on all such copies and derivative works. However, this
document itself may not be modified in any way, such as by removing
the copyright notice or references to the Internet Society or other
Internet organizations, except as needed for the purpose of
developing Internet standards in which case the procedures for
copyrights defined in the Internet Standards process 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 the Internet Society or its successors or assigns.
This document and the information contained herein is provided on an
"AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Acknowledgement
Funding for the RFC Editor function is currently provided by the
Internet Society.
Housley, et al. Standards Track [Page 12]