SSLCertificateSocketFactory 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
具有多个额外功能的 SSLSocketFactory 实现:
<ul>
<li>Timeout specification for SSL handshake operations
<li>Hostname verification in most cases (see WARNINGs below)
<li>Optional SSL session caching with <code data-dev-comment-type="c">SSLSessionCache</code><li>Optionally bypass all SSL certificate checks
</ul>
The handshake timeout does not apply to actual TCP socket connection.
[Android.Runtime.Register("android/net/SSLCertificateSocketFactory", DoNotGenerateAcw=true)]
public class SSLCertificateSocketFactory : Javax.Net.Ssl.SSLSocketFactory
[<Android.Runtime.Register("android/net/SSLCertificateSocketFactory", DoNotGenerateAcw=true)>]
type SSLCertificateSocketFactory = class
inherit SSLSocketFactory
- 继承
- 特性
注解
具有多个额外功能的 SSLSocketFactory 实现:
<ul><li>Timeout specification for SSL handshake operations <li>Hostname verification in most cases (请参阅下面的 WARNING) <li>Optional SSL session caching with SSLSessionCache<li>Optionally bypass all SSL certificate checks </ul>
握手超时不适用于实际的 TCP 套接字连接。 如果还需要连接超时,请使用 #createSocket() 并 Socket#connect(java.net.SocketAddress, int)验证连接到的服务器的身份。
<b>大多数 SSLSocketFactory 实现不验证服务器的标识,允许中间人攻击。</b> 此实现会检查服务器的证书主机名,但仅适用于指定主机名的 createSocket 变体。 使用使用 InetAddress 或返回未连接的套接字的方法时,必须自行验证服务器的标识以确保安全连接。
有关进一步的信息,请参阅 更新安全提供程序以防止 SSL 攻击 。
验证服务器的标识的建议方法是用于 HttpsURLConnection#getDefaultHostnameVerifier() 获取 HostnameVerifier 用于验证证书主机名。
<b>警告</b>:此类上的某些方法返回连接的套接字,某些方法返回未连接的套接字。 对于返回连接套接字的方法,在这些套接字上设置与连接或握手相关的属性将不起作用。
在开发设备上,“setprop socket.relaxsslcheck yes”会绕过所有 SSL 证书和主机名检查以进行测试。 此设置需要根访问权限。
此成员已弃用。 此类使用标准 API 进行容易出错的替换较少。 若要创建,SSLSocket请从中获取或SSLSocketFactorySSLSocketFactory#getDefault()获取 javax.net.ssl.SSLContext#getSocketFactory() 。 若要验证主机名,请传递给 "HTTPS"javax.net.ssl.SSLParameters#setEndpointIdentificationAlgorithm(String)。 若要启用 ALPN,请使用 javax.net.ssl.SSLParameters#setApplicationProtocols(String[])。 若要启用 SNI,请使用 javax.net.ssl.SSLParameters#setServerNames(java.util.List)。
Java文档android.net.SSLCertificateSocketFactory。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
构造函数
| 名称 | 说明 |
|---|---|
| SSLCertificateSocketFactory(Int32) |
已过时.
此成员已弃用。 |
| SSLCertificateSocketFactory(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
属性
| 名称 | 说明 |
|---|---|
| Class |
返回此 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
具有多个额外功能的 SSLSocketFactory 实现:
(继承自 JavaObject)
|
| JniPeerMembers |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
| ThresholdType |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
方法
| 名称 | 说明 |
|---|---|
| Clone() |
创建并返回此对象的副本。 (继承自 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
具有多个额外功能的 SSLSocketFactory 实现:
(继承自 JavaObject)
|
| CreateSocket() |
创建未连接的套接字。 (继承自 SocketFactory) |
| CreateSocket(InetAddress, Int32, InetAddress, Int32) |
已过时.
创建套接字。 |
| CreateSocket(InetAddress, Int32) |
已过时.
创建套接字。 |
| CreateSocket(Socket, String, Int32, Boolean) |
已过时.
创建套接字。 |
| CreateSocket(String, Int32, InetAddress, Int32) |
已过时.
创建套接字。 |
| CreateSocket(String, Int32) |
已过时.
创建套接字。 |
| Dispose() |
释放此Java对等方持有的资源。 (继承自 Object) |
| Dispose(Boolean) |
释放此Java对等方持有的资源。 (继承自 Object) |
| DisposeUnlessReferenced() |
具有多个额外功能的 SSLSocketFactory 实现:
(继承自 JavaObject)
|
| Equals(Object) |
具有多个额外功能的 SSLSocketFactory 实现:
(继承自 JavaObject)
|
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| GetDefault(Int32, SSLSessionCache) |
返回具有可选握手超时和 SSL 会话缓存的新套接字工厂实例。 |
| GetDefault(Int32) |
返回具有可选握手超时的新套接字工厂实例。 |
| GetDefaultCipherSuites() |
已过时.
返回默认启用的密码套件的名称。 |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| GetHttpSocketFactory(Int32, SSLSessionCache) |
已过时.
返回用于 Apache HTTP 堆栈的套接字工厂(也称为 SSLSocketFactory,但在不同的命名空间中)。 |
| GetInsecure(Int32, SSLSessionCache) |
使用可选的握手超时和 SSL 会话缓存返回禁用所有 SSL 安全检查的套接字工厂的新实例。 |
| GetNpnSelectedProtocol(Socket) |
返回客户端和服务器选择的 下一个协议协商 (NPN) 协议,如果未协商任何协议,则返回 null。 |
| GetSupportedCipherSuites() |
已过时.
返回受支持的密码套件的名称,并且可以为 SSL 连接启用。 |
| JavaFinalize() |
已过时.
当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。 (继承自 Object) |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| SetHostname(Socket, String) |
在给定套接字上打开 服务器名称指示(SNI )。 |
| SetKeyManagers(IKeyManager[]) |
设置 |
| SetNpnProtocols(Byte[][]) |
设置此对等方感兴趣的 下一个协议协商 (NPN) 协议。 |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
具有多个额外功能的 SSLSocketFactory 实现:
(继承自 JavaObject)
|
| SetTrustManagers(ITrustManager[]) |
设置 |
| SetUseSessionTickets(Socket, Boolean) |
在给定套接字上启用 会话票证 支持。 |
| ToArray<T>() |
从此Java数组包装器创建托管数组。 (继承自 Object) |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| UnregisterFromRuntime() |
从互操作运行时取消注册此Java对等。 (继承自 Object) |
| Wait() |
使当前线程等待,直到唤醒它,通常是通过 em 通知/em< 或 >em<interrupted>/em<。><> (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。 (继承自 Object) |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
具有多个额外功能的 SSLSocketFactory 实现:
(继承自 JavaObject)
|
| IJavaPeerable.Finalized() |
具有多个额外功能的 SSLSocketFactory 实现:
(继承自 JavaObject)
|
| IJavaPeerable.JniObjectReferenceControlBlock |
具有多个额外功能的 SSLSocketFactory 实现:
(继承自 JavaObject)
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
具有多个额外功能的 SSLSocketFactory 实现:
(继承自 JavaObject)
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
具有多个额外功能的 SSLSocketFactory 实现:
(继承自 JavaObject)
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
具有多个额外功能的 SSLSocketFactory 实现:
(继承自 JavaObject)
|
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
具有多个额外功能的 SSLSocketFactory 实现:
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |