IpSecManager.ApplyTransportModeTransform Método

[Android.Runtime.Register("applyTransportModeTransform", "(Ljava/io/FileDescriptor;ILandroid/net/IpSecTransform;)V", "GetApplyTransportModeTransform_Ljava_io_FileDescriptor_ILandroid_net_IpSecTransform_Handler", ApiSince=28)]
public virtual void ApplyTransportModeTransform(Java.IO.FileDescriptor socket, Android.Net.IpSecTransportDirection direction, Android.Net.IpSecTransform transform);

[<Android.Runtime.Register("applyTransportModeTransform", "(Ljava/io/FileDescriptor;ILandroid/net/IpSecTransform;)V", "GetApplyTransportModeTransform_Ljava_io_FileDescriptor_ILandroid_net_IpSecTransform_Handler", ApiSince=28)>]
abstract member ApplyTransportModeTransform : Java.IO.FileDescriptor * Android.Net.IpSecTransportDirection * Android.Net.IpSecTransform -> unit
override this.ApplyTransportModeTransform : Java.IO.FileDescriptor * Android.Net.IpSecTransportDirection * Android.Net.IpSecTransform -> unit

Parámetros

Atributos

RegisterAttribute

Comentarios

Esto aplica la encapsulación del modo de transporte al socket especificado. Una vez aplicado, la E/S del socket se encapsulará según los parámetros de IpSecTransform. Cuando la transformación se quita del socket mediante una llamada a #removeTransportModeTransforms, el tráfico desprotegido se puede reanudar en ese socket.

Por motivos de seguridad, la dirección de destino de cualquier tráfico del socket debe coincidir con el remoto InetAddress de IpSecTransform. Los intentos de enviar tráfico a cualquier otra dirección IP darán lugar a una ioException. Además, las lecturas y escrituras en el socket producirán IOException si el usuario desactiva la transformación (llamando a IpSecTransform#close()) sin llamar a #removeTransportModeTransforms.

Tenga en cuenta que, cuando se aplica a sockets TCP, llamar a IpSecTransform#close() en una transformación aplicada antes de que finalice el apagado correcto puede dar lugar a que la secuencia de apagado no se complete. Por lo tanto, las aplicaciones que requieren apagado correcto DEBEN cerrar el socket antes de desactivar la transformación aplicada. El cierre del socket se puede realizar de forma asincrónica (en lotes), por lo que la devolución de una función de cierre no garantiza el apagado de un socket. Si se establece una SO_LINGER tiempo de espera, el cierre del socket se realiza de forma sincrónica y es suficiente para garantizar el apagado.

En concreto, si la transformación se desactiva (llamando IpSecTransform#close()a ), antes de que se cierre el socket, se quitan los paquetes estándar [FIN - FIN - FIN/ACK - ACK] o los paquetes de restablecimiento [RST] debido a la falta de una transformación válida. Del mismo modo, si se cierra un socket sin el conjunto de opciones de SO_LINGER, se pueden quitar los paquetes FIN retrasados o por lotes.

<h4>Procedimiento< de reclave/h4>

Al aplicar un nuevo transformulario a un socket en la dirección de salida, se quitará la transformación anterior y la nueva transformación surtirá efecto inmediatamente, enviando todo el tráfico en la nueva transformación; Sin embargo, al aplicar una transformación en la dirección de entrada, el tráfico de la transformación anterior seguirá descifrado y se entregará hasta que esa transformación se desasigne llamando a IpSecTransform#close(). Esta superposición permite procedimientos de reclave sin pérdida en los que ambas transformaciones son válidas hasta que ambos puntos de conexión usen la nueva transformación y se hayan recibido todos los paquetes en curso.

Java documentación para android.net.IpSecManager.applyTransportModeTransform(java.io.FileDescriptor, int, android.net.IpSecTransform).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

[Android.Runtime.Register("applyTransportModeTransform", "(Ljava/net/DatagramSocket;ILandroid/net/IpSecTransform;)V", "GetApplyTransportModeTransform_Ljava_net_DatagramSocket_ILandroid_net_IpSecTransform_Handler", ApiSince=28)]
public virtual void ApplyTransportModeTransform(Java.Net.DatagramSocket socket, Android.Net.IpSecTransportDirection direction, Android.Net.IpSecTransform transform);

[<Android.Runtime.Register("applyTransportModeTransform", "(Ljava/net/DatagramSocket;ILandroid/net/IpSecTransform;)V", "GetApplyTransportModeTransform_Ljava_net_DatagramSocket_ILandroid_net_IpSecTransform_Handler", ApiSince=28)>]
abstract member ApplyTransportModeTransform : Java.Net.DatagramSocket * Android.Net.IpSecTransportDirection * Android.Net.IpSecTransform -> unit
override this.ApplyTransportModeTransform : Java.Net.DatagramSocket * Android.Net.IpSecTransportDirection * Android.Net.IpSecTransform -> unit

Parámetros

Atributos

RegisterAttribute

Comentarios

Esto aplica la encapsulación del modo de transporte al socket especificado. Una vez aplicado, la E/S del socket se encapsulará según los parámetros de IpSecTransform. Cuando la transformación se quita del socket mediante una llamada a #removeTransportModeTransforms, el tráfico desprotegido se puede reanudar en ese socket.

Por motivos de seguridad, la dirección de destino de cualquier tráfico del socket debe coincidir con el remoto InetAddress de IpSecTransform. Los intentos de enviar tráfico a cualquier otra dirección IP darán lugar a una ioException. Además, las lecturas y escrituras en el socket producirán IOException si el usuario desactiva la transformación (llamando a IpSecTransform#close()) sin llamar a #removeTransportModeTransforms.

<h4>Procedimiento< de reclave/h4>

Al aplicar un nuevo transformulario a un socket en la dirección de salida, se quitará la transformación anterior y la nueva transformación surtirá efecto inmediatamente, enviando todo el tráfico en la nueva transformación; Sin embargo, al aplicar una transformación en la dirección de entrada, el tráfico de la transformación anterior seguirá descifrado y se entregará hasta que esa transformación se desasigne llamando a IpSecTransform#close(). Esta superposición permite procedimientos de reclave sin pérdida en los que ambas transformaciones son válidas hasta que ambos puntos de conexión usen la nueva transformación y se hayan recibido todos los paquetes en curso.

Java documentación para android.net.IpSecManager.applyTransportModeTransform(java.net.DatagramSocket, int, android.net.IpSecTransform).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

[Android.Runtime.Register("applyTransportModeTransform", "(Ljava/net/Socket;ILandroid/net/IpSecTransform;)V", "GetApplyTransportModeTransform_Ljava_net_Socket_ILandroid_net_IpSecTransform_Handler", ApiSince=28)]
public virtual void ApplyTransportModeTransform(Java.Net.Socket socket, Android.Net.IpSecTransportDirection direction, Android.Net.IpSecTransform transform);

[<Android.Runtime.Register("applyTransportModeTransform", "(Ljava/net/Socket;ILandroid/net/IpSecTransform;)V", "GetApplyTransportModeTransform_Ljava_net_Socket_ILandroid_net_IpSecTransform_Handler", ApiSince=28)>]
abstract member ApplyTransportModeTransform : Java.Net.Socket * Android.Net.IpSecTransportDirection * Android.Net.IpSecTransform -> unit
override this.ApplyTransportModeTransform : Java.Net.Socket * Android.Net.IpSecTransportDirection * Android.Net.IpSecTransform -> unit

Parámetros

Atributos

RegisterAttribute

Comentarios

Esto aplica la encapsulación del modo de transporte al socket especificado. Una vez aplicado, la E/S del socket se encapsulará según los parámetros de IpSecTransform. Cuando la transformación se quita del socket mediante una llamada a #removeTransportModeTransforms, el tráfico desprotegido se puede reanudar en ese socket.

Por motivos de seguridad, la dirección de destino de cualquier tráfico del socket debe coincidir con el remoto InetAddress de IpSecTransform. Los intentos de enviar tráfico a cualquier otra dirección IP darán lugar a una ioException. Además, las lecturas y escrituras en el socket producirán IOException si el usuario desactiva la transformación (llamando a IpSecTransform#close()) sin llamar a #removeTransportModeTransforms.

Tenga en cuenta que, cuando se aplica a sockets TCP, llamar a IpSecTransform#close() en una transformación aplicada antes de que finalice el apagado correcto puede dar lugar a que la secuencia de apagado no se complete. Por lo tanto, las aplicaciones que requieren apagado correcto DEBEN cerrar el socket antes de desactivar la transformación aplicada. El cierre del socket se puede realizar de forma asincrónica (en lotes), por lo que la devolución de una función de cierre no garantiza el apagado de un socket. Si se establece una SO_LINGER tiempo de espera, el cierre del socket se realiza de forma sincrónica y es suficiente para garantizar el apagado.

En concreto, si la transformación se desactiva (llamando IpSecTransform#close()a ), antes de que se cierre el socket, se quitan los paquetes estándar [FIN - FIN - FIN/ACK - ACK] o los paquetes de restablecimiento [RST] debido a la falta de una transformación válida. Del mismo modo, si se cierra un socket sin el conjunto de opciones de SO_LINGER, se pueden quitar los paquetes FIN retrasados o por lotes.

<h4>Procedimiento< de reclave/h4>

Al aplicar un nuevo transformulario a un socket en la dirección de salida, se quitará la transformación anterior y la nueva transformación surtirá efecto inmediatamente, enviando todo el tráfico en la nueva transformación; Sin embargo, al aplicar una transformación en la dirección de entrada, el tráfico de la transformación anterior seguirá descifrado y se entregará hasta que esa transformación se desasigne llamando a IpSecTransform#close(). Esta superposición permite procedimientos de reclave sin pérdida en los que ambas transformaciones son válidas hasta que ambos puntos de conexión usen la nueva transformación y se hayan recibido todos los paquetes en curso.

Java documentación para android.net.IpSecManager.applyTransportModeTransform(java.net.Socket, int, android.net.IpSecTransform).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.