Path: blob/aarch64-shenandoah-jdk8u272-b10/jdk/src/share/classes/sun/security/krb5/internal/Krb5.java
38923 views
/*1* Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.2* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.3*4* This code is free software; you can redistribute it and/or modify it5* under the terms of the GNU General Public License version 2 only, as6* published by the Free Software Foundation. Oracle designates this7* particular file as subject to the "Classpath" exception as provided8* by Oracle in the LICENSE file that accompanied this code.9*10* This code is distributed in the hope that it will be useful, but WITHOUT11* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or12* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License13* version 2 for more details (a copy is included in the LICENSE file that14* accompanied this code).15*16* You should have received a copy of the GNU General Public License version17* 2 along with this work; if not, write to the Free Software Foundation,18* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.19*20* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA21* or visit www.oracle.com if you need additional information or have any22* questions.23*/2425/*26*27* (C) Copyright IBM Corp. 1999 All Rights Reserved.28* Copyright 1997 The Open Group Research Institute. All rights reserved.29*/3031package sun.security.krb5.internal;3233import java.util.Hashtable;3435// Constants and other defined values from RFC 41203637public class Krb5 {3839//Recommended KDC values40public static final int DEFAULT_ALLOWABLE_CLOCKSKEW = 5 * 60; //5 minutes41public static final int DEFAULT_MINIMUM_LIFETIME = 5 * 60; //5 minutes42public static final int DEFAULT_MAXIMUM_RENEWABLE_LIFETIME = 7 * 24 * 60 * 60; //1 week43public static final int DEFAULT_MAXIMUM_TICKET_LIFETIME = 24 * 60 * 60; //1 day44public static final boolean DEFAULT_FORWARDABLE_ALLOWED = true;45public static final boolean DEFAULT_PROXIABLE_ALLOWED = true;46public static final boolean DEFAULT_POSTDATE_ALLOWED = true;47public static final boolean DEFAULT_RENEWABLE_ALLOWED = true;48public static final boolean AP_EMPTY_ADDRESSES_ALLOWED = true;4950//AP_REQ Options5152public static final int AP_OPTS_RESERVED = 0;53public static final int AP_OPTS_USE_SESSION_KEY = 1;54public static final int AP_OPTS_MUTUAL_REQUIRED = 2;55public static final int AP_OPTS_MAX = 31;5657//Ticket Flags5859public static final int TKT_OPTS_RESERVED = 0;60public static final int TKT_OPTS_FORWARDABLE = 1;61public static final int TKT_OPTS_FORWARDED = 2;62public static final int TKT_OPTS_PROXIABLE = 3;63public static final int TKT_OPTS_PROXY = 4;64public static final int TKT_OPTS_MAY_POSTDATE = 5;65public static final int TKT_OPTS_POSTDATED = 6;66public static final int TKT_OPTS_INVALID = 7;67public static final int TKT_OPTS_RENEWABLE = 8;68public static final int TKT_OPTS_INITIAL = 9;69public static final int TKT_OPTS_PRE_AUTHENT = 10;70public static final int TKT_OPTS_HW_AUTHENT = 11;71public static final int TKT_OPTS_DELEGATE = 13;72public static final int TKT_OPTS_ENC_PA_REP = 15;73public static final int TKT_OPTS_MAX = 31;7475// KDC Options76// (option values defined in KDCOptions.java)77public static final int KDC_OPTS_MAX = 31;7879// KerberosFlags80public static final int KRB_FLAGS_MAX = 31;8182//Last Request types8384public static final int LRTYPE_NONE = 0;85public static final int LRTYPE_TIME_OF_INITIAL_TGT = 1;86public static final int LRTYPE_TIME_OF_INITIAL_REQ = 2;87public static final int LRTYPE_TIME_OF_NEWEST_TGT = 3;88public static final int LRTYPE_TIME_OF_LAST_RENEWAL = 4;89public static final int LRTYPE_TIME_OF_LAST_REQ = 5;9091//Host address lengths9293public static final int ADDR_LEN_INET = 4;94public static final int ADDR_LEN_CHAOS = 2;95public static final int ADDR_LEN_OSI = 0; //means variable96public static final int ADDR_LEN_XNS = 6;97public static final int ADDR_LEN_APPLETALK = 3;98public static final int ADDR_LEN_DECNET = 2;99100//Host address types101102public static final int ADDRTYPE_UNIX = 1; // Local103public static final int ADDRTYPE_INET = 2; // Internet104public static final int ADDRTYPE_IMPLINK = 3; // Arpanet105public static final int ADDRTYPE_PUP = 4; // PUP106public static final int ADDRTYPE_CHAOS = 5; // CHAOS107public static final int ADDRTYPE_XNS = 6; // XEROX Network Services108public static final int ADDRTYPE_IPX = 6; // IPX109public static final int ADDRTYPE_ISO = 7; // ISO110public static final int ADDRTYPE_ECMA = 8; // European Computer Manufacturers111public static final int ADDRTYPE_DATAKIT = 9; // Datakit112public static final int ADDRTYPE_CCITT = 10; // CCITT113public static final int ADDRTYPE_SNA = 11; // SNA114public static final int ADDRTYPE_DECNET = 12; // DECnet115public static final int ADDRTYPE_DLI = 13; // Direct Data Link Interface116public static final int ADDRTYPE_LAT = 14; // LAT117public static final int ADDRTYPE_HYLINK = 15; // NSC Hyperchannel118public static final int ADDRTYPE_APPLETALK = 16; // AppleTalk119public static final int ADDRTYPE_NETBIOS = 17; // NetBios120public static final int ADDRTYPE_VOICEVIEW = 18; // VoiceView121public static final int ADDRTYPE_FIREFOX = 19; // Firefox122public static final int ADDRTYPE_BAN = 21; // Banyan123public static final int ADDRTYPE_ATM = 22; // ATM124public static final int ADDRTYPE_INET6 = 24; // Internet Protocol V6125126//IP Transport UDP Port for KDC Messages127128public static final int KDC_INET_DEFAULT_PORT = 88;129130// number of retries before giving up131132public static final int KDC_RETRY_LIMIT = 3;133public static final int KDC_DEFAULT_UDP_PREF_LIMIT = 1465;134public static final int KDC_HARD_UDP_LIMIT = 32700;135136//OSI authentication mechanism OID137138//public static final int[] OSI_AUTH_MECH_TYPE = { /*iso*/ 1, /*org*/ 3,139// /*dod*/ 5, /*internet*/ 1, /*security*/ 5, /*kerberosv5*/ 2 };140141//Protocol constants and associated values142143//Key Types144public static final int KEYTYPE_NULL = 0;145public static final int KEYTYPE_DES = 1;146147public static final int KEYTYPE_DES3 = 2;148public static final int KEYTYPE_AES = 3;149public static final int KEYTYPE_ARCFOUR_HMAC = 4;150151152//----------------------------------------+-----------------153// padata type |padata-type value154//----------------------------------------+-----------------155public static final int PA_TGS_REQ = 1;156public static final int PA_ENC_TIMESTAMP = 2;157public static final int PA_PW_SALT = 3;158159// new preauth types160public static final int PA_ETYPE_INFO = 11;161public static final int PA_ETYPE_INFO2 = 19;162163// S4U2user info164public static final int PA_FOR_USER = 129;165public static final int PA_PAC_OPTIONS = 167;166167// FAST (RFC 6806)168public static final int PA_REQ_ENC_PA_REP = 149;169170//-------------------------------+-------------171//authorization data type |ad-type value172//-------------------------------+-------------173//reserved values 0-63174public static final int OSF_DCE = 64;175public static final int SESAME = 65;176177//----------------------------------------------+-----------------178//alternate authentication type |method-type value179//----------------------------------------------+-----------------180// reserved values 0-63181public static final int ATT_CHALLENGE_RESPONSE = 64;182183//--------------------------------------------+-------------184//transited encoding type |tr-type value185//--------------------------------------------+-------------186public static final int DOMAIN_X500_COMPRESS = 1;187// reserved values all others188189//----------------------------+-------+-----------------------------------------190// Label |Value |Meaning191//----------------------------+-------+-----------------------------------------192public static final int PVNO = 5; // current Kerberos protocol version number193public static final int AUTHNETICATOR_VNO = 5; // current authenticator version number194public static final int TICKET_VNO = 5; // current ticket version number195196//message types197198// there are several message sub-components not included here199public static final int KRB_AS_REQ = 10; //Request for initial authentication200public static final int KRB_AS_REP = 11; //Response to KRB_AS_REQ request201public static final int KRB_TGS_REQ = 12; //Request for authentication based on TGT202public static final int KRB_TGS_REP = 13; //Response to KRB_TGS_REQ request203public static final int KRB_AP_REQ = 14; //application request to server204public static final int KRB_AP_REP = 15; //Response to KRB_AP_REQ_MUTUAL205public static final int KRB_SAFE = 20; //Safe (checksummed) application message206public static final int KRB_PRIV = 21; //Private (encrypted) application message207public static final int KRB_CRED = 22; //Private (encrypted) message to forward credentials208public static final int KRB_ERROR = 30; //Error response209210//message component types211212public static final int KRB_TKT = 1; //Ticket213public static final int KRB_AUTHENTICATOR = 2; //Authenticator214public static final int KRB_ENC_TKT_PART = 3; //Encrypted ticket part215public static final int KRB_ENC_AS_REP_PART = 25; //Encrypted initial authentication part216public static final int KRB_ENC_TGS_REP_PART = 26; //Encrypted TGS request part217public static final int KRB_ENC_AP_REP_PART = 27; //Encrypted application request part218public static final int KRB_ENC_KRB_PRIV_PART = 28; //Encrypted application message part219public static final int KRB_ENC_KRB_CRED_PART = 29; //Encrypted credentials forward part220221222//error codes223224public static final int KDC_ERR_NONE = 0; //No error225public static final int KDC_ERR_NAME_EXP = 1; //Client's entry in database expired226public static final int KDC_ERR_SERVICE_EXP = 2; //Server's entry in database has expired227public static final int KDC_ERR_BAD_PVNO = 3; //Requested protocol version number not supported228public static final int KDC_ERR_C_OLD_MAST_KVNO = 4; //Client's key encrypted in old master key229public static final int KDC_ERR_S_OLD_MAST_KVNO = 5; //Server's key encrypted in old master key230public static final int KDC_ERR_C_PRINCIPAL_UNKNOWN = 6; //Client not found in Kerberos database231public static final int KDC_ERR_S_PRINCIPAL_UNKNOWN = 7; //Server not found in Kerberos database232public static final int KDC_ERR_PRINCIPAL_NOT_UNIQUE = 8; //Multiple principal entries in database233public static final int KDC_ERR_NULL_KEY = 9; //The client or server has a null key234public static final int KDC_ERR_CANNOT_POSTDATE = 10; //Ticket not eligible for postdating235public static final int KDC_ERR_NEVER_VALID = 11; //Requested start time is later than end time236public static final int KDC_ERR_POLICY = 12; //KDC policy rejects request237public static final int KDC_ERR_BADOPTION = 13; //KDC cannot accommodate requested option238public static final int KDC_ERR_ETYPE_NOSUPP = 14; //KDC has no support for encryption type239public static final int KDC_ERR_SUMTYPE_NOSUPP = 15; //KDC has no support for checksum type240public static final int KDC_ERR_PADATA_TYPE_NOSUPP = 16; //KDC has no support for padata type241public static final int KDC_ERR_TRTYPE_NOSUPP = 17; //KDC has no support for transited type242public static final int KDC_ERR_CLIENT_REVOKED = 18; //Clients credentials have been revoked243public static final int KDC_ERR_SERVICE_REVOKED = 19; //Credentials for server have been revoked244public static final int KDC_ERR_TGT_REVOKED = 20; //TGT has been revoked245public static final int KDC_ERR_CLIENT_NOTYET = 21; //Client not yet valid - try again later246public static final int KDC_ERR_SERVICE_NOTYET = 22; //Server not yet valid - try again later247public static final int KDC_ERR_KEY_EXPIRED = 23; //Password has expired - change password to reset248public static final int KDC_ERR_PREAUTH_FAILED = 24; //Pre-authentication information was invalid249public static final int KDC_ERR_PREAUTH_REQUIRED = 25; //Additional pre-authentication required250public static final int KRB_AP_ERR_BAD_INTEGRITY = 31; //Integrity check on decrypted field failed251public static final int KRB_AP_ERR_TKT_EXPIRED = 32; //Ticket expired252public static final int KRB_AP_ERR_TKT_NYV = 33; //Ticket not yet valid253public static final int KRB_AP_ERR_REPEAT = 34; //Request is a replay254public static final int KRB_AP_ERR_NOT_US = 35; //The ticket isn't for us255public static final int KRB_AP_ERR_BADMATCH = 36; //Ticket and authenticator don't match256public static final int KRB_AP_ERR_SKEW = 37; //Clock skew too great257public static final int KRB_AP_ERR_BADADDR = 38; //Incorrect net address258public static final int KRB_AP_ERR_BADVERSION = 39; //Protocol version mismatch259public static final int KRB_AP_ERR_MSG_TYPE = 40; //Invalid msg type260public static final int KRB_AP_ERR_MODIFIED = 41; //Message stream modified261public static final int KRB_AP_ERR_BADORDER = 42; //Message out of order262public static final int KRB_AP_ERR_BADKEYVER = 44; //Specified version of key is not available263public static final int KRB_AP_ERR_NOKEY = 45; //Service key not available264public static final int KRB_AP_ERR_MUT_FAIL = 46; //Mutual authentication failed265public static final int KRB_AP_ERR_BADDIRECTION = 47; //Incorrect message direction266public static final int KRB_AP_ERR_METHOD = 48; //Alternative authentication method required267public static final int KRB_AP_ERR_BADSEQ = 49; //Incorrect sequence number in message268public static final int KRB_AP_ERR_INAPP_CKSUM = 50; //Inappropriate type of checksum in message269public static final int KRB_ERR_RESPONSE_TOO_BIG = 52; //Response too big for UDP, retry with TCP270public static final int KRB_ERR_GENERIC = 60; //Generic error (description in e-text)271public static final int KRB_ERR_FIELD_TOOLONG = 61; //Field is too long for this implementation272public static final int KRB_ERR_WRONG_REALM = 68; //Wrong realm273public static final int KRB_CRYPTO_NOT_SUPPORT = 100; //Client does not support this crypto type274public static final int KRB_AP_ERR_NOREALM = 62;275public static final int KRB_AP_ERR_GEN_CRED = 63;276// public static final int KRB_AP_ERR_CKSUM_NOKEY =101; //Lack of the key to generate the checksum277// error codes specific to this implementation278public static final int KRB_AP_ERR_REQ_OPTIONS = 101; //Invalid TGS_REQ279public static final int API_INVALID_ARG = 400; //Invalid argument280281public static final int BITSTRING_SIZE_INVALID = 500; //BitString size does not match input byte array282public static final int BITSTRING_INDEX_OUT_OF_BOUNDS = 501; //BitString bit index does not fall within size283public static final int BITSTRING_BAD_LENGTH = 502; //BitString length is wrong for the expected type284285public static final int REALM_ILLCHAR = 600; //Illegal character in realm name; one of: '/', ':', '\0'286public static final int REALM_NULL = 601; //Null realm name287288public static final int ASN1_BAD_TIMEFORMAT = 900; //Input not in GeneralizedTime format289public static final int ASN1_MISSING_FIELD = 901; //Structure is missing a required field290public static final int ASN1_MISPLACED_FIELD = 902; //Unexpected field number291public static final int ASN1_TYPE_MISMATCH = 903; //Type numbers are inconsistent292public static final int ASN1_OVERFLOW = 904; //Value too large293public static final int ASN1_OVERRUN = 905; //Encoding ended unexpectedly294public static final int ASN1_BAD_ID = 906; //Identifier doesn't match expected value295public static final int ASN1_BAD_LENGTH = 907; //Length doesn't match expected value296public static final int ASN1_BAD_FORMAT = 908; //Badly-formatted encoding297public static final int ASN1_PARSE_ERROR = 909; //Parse error298public static final int ASN1_BAD_CLASS = 910; //Bad class number299public static final int ASN1_BAD_TYPE = 911; //Bad type number300public static final int ASN1_BAD_TAG = 912; //Bad tag number301public static final int ASN1_UNSUPPORTED_TYPE = 913; //Unsupported ASN.1 type encountered302public static final int ASN1_CANNOT_ENCODE = 914; //Encoding failed due to invalid parameter(s)303304private static Hashtable<Integer,String> errMsgList;305306public static String getErrorMessage(int i) {307return errMsgList.get(i);308}309310311public static final boolean DEBUG =312java.security.AccessController.doPrivileged(313new sun.security.action.GetBooleanAction("sun.security.krb5.debug"));314public static final sun.misc.HexDumpEncoder hexDumper =315new sun.misc.HexDumpEncoder();316317static {318errMsgList = new Hashtable<Integer,String> ();319errMsgList.put(KDC_ERR_NONE, "No error");320errMsgList.put(KDC_ERR_NAME_EXP, "Client's entry in database expired");321errMsgList.put(KDC_ERR_SERVICE_EXP, "Server's entry in database has expired");322errMsgList.put(KDC_ERR_BAD_PVNO, "Requested protocol version number not supported");323errMsgList.put(KDC_ERR_C_OLD_MAST_KVNO, "Client's key encrypted in old master key");324errMsgList.put(KDC_ERR_S_OLD_MAST_KVNO, "Server's key encrypted in old master key");325errMsgList.put(KDC_ERR_C_PRINCIPAL_UNKNOWN, "Client not found in Kerberos database");326errMsgList.put(KDC_ERR_S_PRINCIPAL_UNKNOWN, "Server not found in Kerberos database");327errMsgList.put(KDC_ERR_PRINCIPAL_NOT_UNIQUE, "Multiple principal entries in database");328errMsgList.put(KDC_ERR_NULL_KEY, "The client or server has a null key");329errMsgList.put(KDC_ERR_CANNOT_POSTDATE, "Ticket not eligible for postdating");330errMsgList.put(KDC_ERR_NEVER_VALID, "Requested start time is later than end time");331errMsgList.put(KDC_ERR_POLICY, "KDC policy rejects request");332errMsgList.put(KDC_ERR_BADOPTION, "KDC cannot accommodate requested option");333errMsgList.put(KDC_ERR_ETYPE_NOSUPP, "KDC has no support for encryption type");334errMsgList.put(KDC_ERR_SUMTYPE_NOSUPP, "KDC has no support for checksum type");335errMsgList.put(KDC_ERR_PADATA_TYPE_NOSUPP, "KDC has no support for padata type");336errMsgList.put(KDC_ERR_TRTYPE_NOSUPP, "KDC has no support for transited type");337errMsgList.put(KDC_ERR_CLIENT_REVOKED, "Clients credentials have been revoked");338errMsgList.put(KDC_ERR_SERVICE_REVOKED, "Credentials for server have been revoked");339errMsgList.put(KDC_ERR_TGT_REVOKED, "TGT has been revoked");340errMsgList.put(KDC_ERR_CLIENT_NOTYET, "Client not yet valid - try again later");341errMsgList.put(KDC_ERR_SERVICE_NOTYET, "Server not yet valid - try again later");342errMsgList.put(KDC_ERR_KEY_EXPIRED, "Password has expired - change password to reset");343errMsgList.put(KDC_ERR_PREAUTH_FAILED, "Pre-authentication information was invalid");344errMsgList.put(KDC_ERR_PREAUTH_REQUIRED, "Additional pre-authentication required");345errMsgList.put(KRB_AP_ERR_BAD_INTEGRITY, "Integrity check on decrypted field failed");346errMsgList.put(KRB_AP_ERR_TKT_EXPIRED, "Ticket expired");347errMsgList.put(KRB_AP_ERR_TKT_NYV, "Ticket not yet valid");348errMsgList.put(KRB_AP_ERR_REPEAT, "Request is a replay");349errMsgList.put(KRB_AP_ERR_NOT_US, "The ticket isn't for us");350errMsgList.put(KRB_AP_ERR_BADMATCH, "Ticket and authenticator don't match");351errMsgList.put(KRB_AP_ERR_SKEW, "Clock skew too great");352errMsgList.put(KRB_AP_ERR_BADADDR, "Incorrect net address");353errMsgList.put(KRB_AP_ERR_BADVERSION, "Protocol version mismatch");354errMsgList.put(KRB_AP_ERR_MSG_TYPE, "Invalid msg type");355errMsgList.put(KRB_AP_ERR_MODIFIED, "Message stream modified");356errMsgList.put(KRB_AP_ERR_BADORDER, "Message out of order");357errMsgList.put(KRB_AP_ERR_BADKEYVER, "Specified version of key is not available");358errMsgList.put(KRB_AP_ERR_NOKEY, "Service key not available");359errMsgList.put(KRB_AP_ERR_MUT_FAIL, "Mutual authentication failed");360errMsgList.put(KRB_AP_ERR_BADDIRECTION, "Incorrect message direction");361errMsgList.put(KRB_AP_ERR_METHOD, "Alternative authentication method required");362errMsgList.put(KRB_AP_ERR_BADSEQ, "Incorrect sequence number in message");363errMsgList.put(KRB_AP_ERR_INAPP_CKSUM, "Inappropriate type of checksum in message");364errMsgList.put(KRB_ERR_RESPONSE_TOO_BIG, "Response too big for UDP, retry with TCP");365errMsgList.put(KRB_ERR_GENERIC, "Generic error (description in e-text)");366errMsgList.put(KRB_ERR_FIELD_TOOLONG, "Field is too long for this implementation");367errMsgList.put(KRB_AP_ERR_NOREALM, "Realm name not available"); //used in setDefaultCreds() in sun.security.krb5.Credentials368369// error messages specific to this implementation370371errMsgList.put(API_INVALID_ARG, "Invalid argument");372373errMsgList.put(BITSTRING_SIZE_INVALID, "BitString size does not match input byte array");374errMsgList.put(BITSTRING_INDEX_OUT_OF_BOUNDS, "BitString bit index does not fall within size");375errMsgList.put(BITSTRING_BAD_LENGTH, "BitString length is wrong for the expected type");376377errMsgList.put(REALM_ILLCHAR, "Illegal character in realm name; one of: '/', ':', '\0'");378errMsgList.put(REALM_NULL, "Null realm name");379380errMsgList.put(ASN1_BAD_TIMEFORMAT, "Input not in GeneralizedTime format");381errMsgList.put(ASN1_MISSING_FIELD, "Structure is missing a required field");382errMsgList.put(ASN1_MISPLACED_FIELD, "Unexpected field number");383errMsgList.put(ASN1_TYPE_MISMATCH, "Type numbers are inconsistent");384errMsgList.put(ASN1_OVERFLOW, "Value too large");385errMsgList.put(ASN1_OVERRUN, "Encoding ended unexpectedly");386errMsgList.put(ASN1_BAD_ID, "Identifier doesn't match expected value");387errMsgList.put(ASN1_BAD_LENGTH, "Length doesn't match expected value");388errMsgList.put(ASN1_BAD_FORMAT, "Badly-formatted encoding");389errMsgList.put(ASN1_PARSE_ERROR, "Parse error");390errMsgList.put(ASN1_BAD_CLASS, "Bad class number");391errMsgList.put(ASN1_BAD_TYPE, "Bad type number");392errMsgList.put(ASN1_BAD_TAG, "Bad tag number");393errMsgList.put(ASN1_UNSUPPORTED_TYPE, "Unsupported ASN.1 type encountered");394errMsgList.put(ASN1_CANNOT_ENCODE, "Encoding failed due to invalid parameter(s)");395errMsgList.put(KRB_CRYPTO_NOT_SUPPORT, "Client has no support for crypto type");396errMsgList.put(KRB_AP_ERR_REQ_OPTIONS, "Invalid option setting in ticket request.");397errMsgList.put(KRB_AP_ERR_GEN_CRED, "Fail to create credential.");398}399400}401402403