1 /*
2  * ====================================================================
3  * Licensed to the Apache Software Foundation (ASF) under one
4  * or more contributor license agreements.  See the NOTICE file
5  * distributed with this work for additional information
6  * regarding copyright ownership.  The ASF licenses this file
7  * to you under the Apache License, Version 2.0 (the
8  * "License"); you may not use this file except in compliance
9  * with the License.  You may obtain a copy of the License at
10  *
11  *   http://www.apache.org/licenses/LICENSE-2.0
12  *
13  * Unless required by applicable law or agreed to in writing,
14  * software distributed under the License is distributed on an
15  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16  * KIND, either express or implied.  See the License for the
17  * specific language governing permissions and limitations
18  * under the License.
19  * ====================================================================
20  *
21  * This software consists of voluntary contributions made by many
22  * individuals on behalf of the Apache Software Foundation.  For more
23  * information on the Apache Software Foundation, please see
24  * <http://www.apache.org/>.
25  *
26  */
27
28 package org.apache.http.conn.ssl;
29
30 import javax.net.ssl.SSLException;
31
32 import org.apache.http.annotation.Contract;
33 import org.apache.http.annotation.ThreadingBehavior;
34
35 /**
36  * The HostnameVerifier that works the same way as Curl and Firefox.
37  * <p>
38  * The hostname must match either the first CN, or any of the subject-alts.
39  * A wildcard can occur in the CN, and in any of the subject-alts.
40  * </p>
41  * <p>
42  * The only difference between BROWSER_COMPATIBLE and STRICT is that a wildcard
43  * (such as "*.foo.com") with BROWSER_COMPATIBLE matches all subdomains,
44  * including "a.b.foo.com".
45  * </p>
46  *
47  * @since 4.0
48  *
49  * @deprecated (4.4) Use {@link org.apache.http.conn.ssl.DefaultHostnameVerifier}
50  */
51 @Contract(threading = ThreadingBehavior.IMMUTABLE)
52 @Deprecated
53 public class BrowserCompatHostnameVerifier extends AbstractVerifier {
54
55     public static final BrowserCompatHostnameVerifier INSTANCE = new BrowserCompatHostnameVerifier();
56
57     @Override
58     public final void verify(
59             final String host,
60             final String[] cns,
61             final String[] subjectAlts) throws SSLException {
62         verify(host, cns, subjectAlts, false);
63     }
64
65     @Override
66     public final String toString() {
67         return "BROWSER_COMPATIBLE";
68     }
69
70 }
71