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

Comentários

Isso aplica o encapsulamento do modo de transporte ao soquete especificado. Uma vez aplicado, a E/S no soquete será encapsulada de acordo com os parâmetros do IpSecTransform. Quando a transformação é removida do soquete chamando #removeTransportModeTransforms, o tráfego desprotegido pode ser retomado nesse soquete.

Por motivos de segurança, o endereço de destino de qualquer tráfego no soquete deve corresponder ao remoto InetAddress do IpSecTransform. As tentativas de enviar tráfego para qualquer outro endereço IP resultarão em uma IOException. Além disso, leituras e gravações no soquete gerarão IOException se o usuário desativar a transformação (chamando IpSecTransform#close()) sem chamar #removeTransportModeTransforms.

Observe que, quando aplicado aos soquetes TCP, chamar IpSecTransform#close() uma transformação aplicada antes da conclusão do desligamento normal pode resultar na falha na conclusão da sequência de desligamento. Dessa forma, os aplicativos que exigem desligamento normal devem fechar o soquete antes de desativar a transformação aplicada. O fechamento do soquete pode ser executado de forma assíncrona (em lotes), portanto, o retorno de uma função próxima não garante o desligamento de um soquete. A configuração de um tempo limite SO_LINGER resulta no fechamento do soquete sendo executado de forma síncrona e é suficiente para garantir o desligamento.

Especificamente, se a transformação for desativada (chamando IpSecTransform#close()), antes do soquete ser fechado, os pacotes padrão [FIN - FIN/ACK - ACK] ou de redefinição [RST] serão descartados devido à falta de uma Transformação válida. Da mesma forma, se um soquete sem o conjunto de opções SO_LINGER for fechado, os pacotes FIN atrasados/em lote poderão ser descartados.

<Procedimento> de rechaveamento h4</h4>

Ao aplicar uma nova transforma a um soquete na direção de saída, a transformação anterior será removida e a nova transformação entrará em vigor imediatamente, enviando todo o tráfego na nova transformação; no entanto, ao aplicar uma transformação na direção de entrada, o tráfego na transformação antiga continuará a ser descriptografado e entregue até que essa transformação seja desalocada chamando IpSecTransform#close(). Essa sobreposição permite procedimentos de rechaveamento sem perdas em que ambas as transformações são válidas até que ambos os pontos de extremidade estejam usando a nova transformação e todos os pacotes em pré-lançamento tenham sido recebidos.

Java documentação para android.net.IpSecManager.applyTransportModeTransform(java.io.FileDescriptor, int, android.net.IpSecTransform).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

[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

Comentários

Isso aplica o encapsulamento do modo de transporte ao soquete especificado. Uma vez aplicado, a E/S no soquete será encapsulada de acordo com os parâmetros do IpSecTransform. Quando a transformação é removida do soquete chamando #removeTransportModeTransforms, o tráfego desprotegido pode ser retomado nesse soquete.

Por motivos de segurança, o endereço de destino de qualquer tráfego no soquete deve corresponder ao remoto InetAddress do IpSecTransform. As tentativas de enviar tráfego para qualquer outro endereço IP resultarão em uma IOException. Além disso, leituras e gravações no soquete gerarão IOException se o usuário desativar a transformação (chamando IpSecTransform#close()) sem chamar #removeTransportModeTransforms.

<Procedimento> de rechaveamento h4</h4>

Ao aplicar uma nova transforma a um soquete na direção de saída, a transformação anterior será removida e a nova transformação entrará em vigor imediatamente, enviando todo o tráfego na nova transformação; no entanto, ao aplicar uma transformação na direção de entrada, o tráfego na transformação antiga continuará a ser descriptografado e entregue até que essa transformação seja desalocada chamando IpSecTransform#close(). Essa sobreposição permite procedimentos de rechaveamento sem perdas em que ambas as transformações são válidas até que ambos os pontos de extremidade estejam usando a nova transformação e todos os pacotes em pré-lançamento tenham sido recebidos.

Java documentação para android.net.IpSecManager.applyTransportModeTransform(java.net.DatagramSocket, int, android.net.IpSecTransform).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

[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

Comentários

Isso aplica o encapsulamento do modo de transporte ao soquete especificado. Uma vez aplicado, a E/S no soquete será encapsulada de acordo com os parâmetros do IpSecTransform. Quando a transformação é removida do soquete chamando #removeTransportModeTransforms, o tráfego desprotegido pode ser retomado nesse soquete.

Por motivos de segurança, o endereço de destino de qualquer tráfego no soquete deve corresponder ao remoto InetAddress do IpSecTransform. As tentativas de enviar tráfego para qualquer outro endereço IP resultarão em uma IOException. Além disso, leituras e gravações no soquete gerarão IOException se o usuário desativar a transformação (chamando IpSecTransform#close()) sem chamar #removeTransportModeTransforms.

Observe que, quando aplicado aos soquetes TCP, chamar IpSecTransform#close() uma transformação aplicada antes da conclusão do desligamento normal pode resultar na falha na conclusão da sequência de desligamento. Dessa forma, os aplicativos que exigem desligamento normal devem fechar o soquete antes de desativar a transformação aplicada. O fechamento do soquete pode ser executado de forma assíncrona (em lotes), portanto, o retorno de uma função próxima não garante o desligamento de um soquete. A configuração de um tempo limite SO_LINGER resulta no fechamento do soquete sendo executado de forma síncrona e é suficiente para garantir o desligamento.

Especificamente, se a transformação for desativada (chamando IpSecTransform#close()), antes do soquete ser fechado, os pacotes padrão [FIN - FIN/ACK - ACK] ou de redefinição [RST] serão descartados devido à falta de uma Transformação válida. Da mesma forma, se um soquete sem o conjunto de opções SO_LINGER for fechado, os pacotes FIN atrasados/em lote poderão ser descartados.

<Procedimento> de rechaveamento h4</h4>

Ao aplicar uma nova transforma a um soquete na direção de saída, a transformação anterior será removida e a nova transformação entrará em vigor imediatamente, enviando todo o tráfego na nova transformação; no entanto, ao aplicar uma transformação na direção de entrada, o tráfego na transformação antiga continuará a ser descriptografado e entregue até que essa transformação seja desalocada chamando IpSecTransform#close(). Essa sobreposição permite procedimentos de rechaveamento sem perdas em que ambas as transformações são válidas até que ambos os pontos de extremidade estejam usando a nova transformação e todos os pacotes em pré-lançamento tenham sido recebidos.

Java documentação para android.net.IpSecManager.applyTransportModeTransform(java.net.Socket, int, android.net.IpSecTransform).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.