1 /*
   2  * Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package sun.security.ssl;
  27 
  28 import javax.net.ssl.*;
  29 import java.util.*;
  30 import sun.net.util.IPAddressUtil;
  31 
  32 /**
  33  * A utility class to share the static methods.
  34  */
  35 final class Utilities {
  36     /**
  37      * hex digits
  38      */
  39     static final char[] hexDigits = "0123456789ABCDEF".toCharArray();
  40 
  41     /**
  42      * Puts {@code hostname} into the {@code serverNames} list.
  43      * <P>
  44      * If the {@code serverNames} does not look like a legal FQDN, it will
  45      * not be put into the returned list.
  46      * <P>
  47      * Note that the returned list does not allow duplicated name type.
  48      *
  49      * @return a list of {@link SNIServerName}
  50      */
  51     static List<SNIServerName> addToSNIServerNameList(
  52             List<SNIServerName> serverNames, String hostname) {
  53 
  54         SNIHostName sniHostName = rawToSNIHostName(hostname);
  55         if (sniHostName == null) {
  56             return serverNames;
  57         }
  58 
  59         int size = serverNames.size();
  60         List<SNIServerName> sniList = (size != 0) ?
  61                 new ArrayList<SNIServerName>(serverNames) :
  62                 new ArrayList<SNIServerName>(1);
  63 
  64         boolean reset = false;
  65         for (int i = 0; i < size; i++) {
  66             SNIServerName serverName = sniList.get(i);
  67             if (serverName.getType() == StandardConstants.SNI_HOST_NAME) {
  68                 sniList.set(i, sniHostName);
  69                 if (Debug.isOn("ssl")) {
  70                     System.out.println(Thread.currentThread().getName() +
  71                         ", the previous server name in SNI (" + serverName +
  72                         ") was replaced with (" + sniHostName + ")");
  73                 }
  74                 reset = true;
  75                 break;
  76             }
  77         }
  78 
  79         if (!reset) {
  80             sniList.add(sniHostName);
  81         }
  82 
  83         return Collections.<SNIServerName>unmodifiableList(sniList);
  84     }
  85 
  86     /**
  87      * Converts string hostname to {@code SNIHostName}.
  88      * <P>
  89      * Note that to check whether a hostname is a valid domain name, we cannot
  90      * use the hostname resolved from name services.  For virtual hosting,
  91      * multiple hostnames may be bound to the same IP address, so the hostname
  92      * resolved from name services is not always reliable.
  93      *
  94      * @param  hostname
  95      *         the raw hostname
  96      * @return an instance of {@link SNIHostName}, or null if the hostname does
  97      *         not look like a FQDN
  98      */
  99     private static SNIHostName rawToSNIHostName(String hostname) {
 100         SNIHostName sniHostName = null;
 101         if (hostname != null && hostname.indexOf('.') > 0 &&
 102                 !hostname.endsWith(".") &&
 103                 !IPAddressUtil.isIPv4LiteralAddress(hostname) &&
 104                 !IPAddressUtil.isIPv6LiteralAddress(hostname)) {
 105 
 106             try {
 107                 sniHostName = new SNIHostName(hostname);
 108             } catch (IllegalArgumentException iae) {
 109                 // don't bother to handle illegal host_name
 110                 if (Debug.isOn("ssl")) {
 111                     System.out.println(Thread.currentThread().getName() +
 112                         ", \"" + hostname + "\" " +
 113                         "is not a legal HostName for  server name indication");
 114                 }
 115             }
 116         }
 117 
 118         return sniHostName;
 119     }
 120 }