Share via


HttpsURLConnection.PeerPrincipal Property

Definition

Returns the server's principal which was established as part of defining the session.

public virtual Java.Security.IPrincipal? PeerPrincipal { [Android.Runtime.Register("getPeerPrincipal", "()Ljava/security/Principal;", "GetGetPeerPrincipalHandler")] get; }
[<get: Android.Runtime.Register("getPeerPrincipal", "()Ljava/security/Principal;", "GetGetPeerPrincipalHandler")>]
member this.PeerPrincipal : Java.Security.IPrincipal

Property Value

the server's principal. Returns an X500Principal of the end-entity certiticate for X509-based cipher suites, and KerberosPrincipal for Kerberos cipher suites.

Attributes

Exceptions

if the identity of the peer has not been verified.

if no connection has been established yet.

Remarks

Returns the server's principal which was established as part of defining the session.

Note: Subclasses should override this method. If not overridden, it will default to returning the X500Principal of the server's end-entity certificate for certificate-based ciphersuites, or throw an SSLPeerUnverifiedException for non-certificate based ciphersuites, such as Kerberos.

Added in 1.5.

Java documentation for javax.net.ssl.HttpsURLConnection.getPeerPrincipal().

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to