HostnameVerifier (Java Platform SE 8 )
Keywords: javax.net.ssl.HostnameVerifier interface
Date: 2026-04-17

compact1, compact2, compact3
javax.net.ssl

## Interface HostnameVerifier

-     public interface HostnameVerifier

  This class is the base interface for hostname verification.

  During handshaking, if the URL's hostname and the server's identification hostname mismatch, the verification mechanism can call back to implementers of this interface to determine if this connection should be allowed.

  The policies can be certificate-based or may depend on other authentication schemes.

  These callbacks are used when the default rules for URL hostname verification fail.

  Since:
    1.4

- - ### Method Summary

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method and Description
    --- | ---
    `boolean` | `verify(String hostname, SSLSession session)` Verify that the host name is an acceptable match with the server's authentication scheme.

- - ### Method Detail

    - #### verify

          boolean verify(String hostname,
                         SSLSession session)

      Verify that the host name is an acceptable match with the server's authentication scheme.
      Parameters:
        `hostname` - the host name
        `session` - SSLSession used on the connection to host
      Returns:
        true if the host name is acceptable

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2026, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.