65 * part of defining the session in the original connection that
66 * retrieved the network resource, from cache. Note: This method
67 * can be used only when using certificate-based cipher suites;
68 * using it with non-certificate-based cipher suites, such as
69 * Kerberos, will throw an SSLPeerUnverifiedException.
70 *
71 * @return an immutable List of Certificate representing the server's
72 * certificate chain.
73 * @throws SSLPeerUnverifiedException if the peer is not verified.
74 * @see #getPeerPrincipal()
75 */
76 public abstract List<Certificate> getServerCertificateChain()
77 throws SSLPeerUnverifiedException;
78
79 /**
80 * Returns the server's principal which was established as part of
81 * defining the session during the original connection that
82 * retrieved the network resource.
83 *
84 * @return the server's principal. Returns an X500Principal of the
85 * end-entity certiticate for X509-based cipher suites, and
86 * KerberosPrincipal for Kerberos cipher suites.
87 *
88 * @throws SSLPeerUnverifiedException if the peer was not verified.
89 *
90 * @see #getServerCertificateChain()
91 * @see #getLocalPrincipal()
92 */
93 public abstract Principal getPeerPrincipal()
94 throws SSLPeerUnverifiedException;
95
96 /**
97 * Returns the principal that was sent to the server during
98 * handshaking in the original connection that retrieved the
99 * network resource.
100 *
101 * @return the principal sent to the server. Returns an X500Principal
102 * of the end-entity certificate for X509-based cipher suites, and
103 * KerberosPrincipal for Kerberos cipher suites. If no principal was
104 * sent, then null is returned.
105 *
|
65 * part of defining the session in the original connection that
66 * retrieved the network resource, from cache. Note: This method
67 * can be used only when using certificate-based cipher suites;
68 * using it with non-certificate-based cipher suites, such as
69 * Kerberos, will throw an SSLPeerUnverifiedException.
70 *
71 * @return an immutable List of Certificate representing the server's
72 * certificate chain.
73 * @throws SSLPeerUnverifiedException if the peer is not verified.
74 * @see #getPeerPrincipal()
75 */
76 public abstract List<Certificate> getServerCertificateChain()
77 throws SSLPeerUnverifiedException;
78
79 /**
80 * Returns the server's principal which was established as part of
81 * defining the session during the original connection that
82 * retrieved the network resource.
83 *
84 * @return the server's principal. Returns an X500Principal of the
85 * end-entity certificate for X509-based cipher suites, and
86 * KerberosPrincipal for Kerberos cipher suites.
87 *
88 * @throws SSLPeerUnverifiedException if the peer was not verified.
89 *
90 * @see #getServerCertificateChain()
91 * @see #getLocalPrincipal()
92 */
93 public abstract Principal getPeerPrincipal()
94 throws SSLPeerUnverifiedException;
95
96 /**
97 * Returns the principal that was sent to the server during
98 * handshaking in the original connection that retrieved the
99 * network resource.
100 *
101 * @return the principal sent to the server. Returns an X500Principal
102 * of the end-entity certificate for X509-based cipher suites, and
103 * KerberosPrincipal for Kerberos cipher suites. If no principal was
104 * sent, then null is returned.
105 *
|