Added in API level 1
Deprecated in API level 22

StrictHostnameVerifier

open class StrictHostnameVerifier : AbstractVerifier

The Strict HostnameVerifier works the same way as Sun Java 1.4, Sun Java 5, Sun Java 6-rc. It's also pretty close to IE6. This implementation appears to be compliant with RFC 2818 for dealing with wildcards.

The hostname must match either the first CN, or any of the subject-alts. A wildcard can occur in the CN, and in any of the subject-alts. The one divergence from IE6 is how we only check the first CN. IE6 allows a match against any of the CNs present. We decided to follow in Sun Java 1.4's footsteps and only check the first CN. (If you need to check all the CN's, feel free to write your own implementation!).

A wildcard such as "*.foo.com" matches only subdomains in the same level, for example "a.foo.com". It does not match deeper subdomains such as "a.b.foo.com".

Summary

Public constructors

Public methods
String

Unit
verify(host: String!, cns: Array<String!>!, subjectAlts: Array<String!>!)

Inherited functions
Boolean acceptableCountryWildcard(cn: String!)

Int countDots(s: String!)

Counts the number of dots "." in a string.

Array<String!>! getCNs(cert: X509Certificate!)

Array<String!>! getDNSSubjectAlts(cert: X509Certificate!)

Extracts the array of SubjectAlt DNS names from an X509Certificate. Returns null if there aren't any.

Note: Java doesn't appear able to extract international characters from the SubjectAlts. It can only extract international characters from the CN field.

(Or maybe the version of OpenSSL I'm using to test isn't storing the international characters correctly in the SubjectAlts?).

Unit verify(host: String!, cns: Array<String!>!, subjectAlts: Array<String!>!, strictWithSubDomains: Boolean)

Unit verify(host: String!, cert: X509Certificate!)

Boolean verify(host: String!, session: SSLSession!)

Unit verify(host: String!, ssl: SSLSocket!)

Unit verify(host: String!, cns: Array<String!>!, subjectAlts: Array<String!>!)

Checks to see if the supplied hostname matches any of the supplied CNs or "DNS" Subject-Alts. Most implementations only look at the first CN, and ignore any additional CNs. Most implementations do look at all of the "DNS" Subject-Alts. The CNs or Subject-Alts may contain wildcards according to RFC 2818.

Public constructors

StrictHostnameVerifier

StrictHostnameVerifier()

Public methods

toString

Added in API level 1
fun toString(): String

Deprecated: Deprecated in Java.

Return
String a string representation of the object.

verify

Added in API level 1
fun verify(
    host: String!,
    cns: Array<String!>!,
    subjectAlts: Array<String!>!
): Unit

Deprecated: Deprecated in Java.

Parameters
cns Array<String!>!: CN fields, in order, as extracted from the X.509 certificate.
subjectAlts Array<String!>!: Subject-Alt fields of type 2 ("DNS"), as extracted from the X.509 certificate.
host String!: The hostname to verify.
Exceptions
javax.net.ssl.SSLException If verification failed.