PacketPeerDTLS

Inherits: PacketPeer < Reference < Object

Paquete de pares DTLS.

Descripción

This class represents a DTLS peer connection. It can be used to connect to a DTLS server, and is returned by DTLSServer.take_connection.

Warning: SSL/TLS certificate revocation and certificate pinning are currently not supported. Revoked certificates are accepted as long as they are otherwise valid. If this is a concern, you may want to use automatically managed certificates with a short validity period.

Métodos

Error

connect_to_peer ( PacketPeerUDP packet_peer, bool validate_certs=true, String for_hostname="", X509Certificate valid_certificate=null )

void

disconnect_from_peer ( )

Status

get_status ( ) const

void

poll ( )

Enumeraciones

enum Status:

  • STATUS_DISCONNECTED = 0 --- Un estado que representa un PacketPeerDTLS que está desconectado.

  • STATUS_HANDSHAKING = 1 --- Un estado que representa un PacketPeerDTLS que está actualmente realizando el handshake con un par remoto.

  • STATUS_CONNECTED = 2 --- Un estado que representa un PacketPeerDTLS que está conectado a un par remoto.

  • STATUS_ERROR = 3 --- Un estado que representa un PacketPeerDTLS en un estado de error genérico.

  • STATUS_ERROR_HOSTNAME_MISMATCH = 4 --- Un estado de error que muestra una falta de coincidencia en el dominio del certificado DTLS presentado por el host y el dominio solicitado para la validación.

Descripciones de Métodos

Conecta un peer comenzando el handshake de DTLS usando el PacketPeerUDP subyacente que debe ser conectado (ver PacketPeerUDP.connect_to_host). Si validate_certs es true, PacketPeerDTLS validará que el certificado presentado por el par remoto y lo hará coincidir con el argumento for_hostname. Puede especificar un X509Certificate personalizado para utilizarlo en la validación mediante el argumento valid_certificate.

  • void disconnect_from_peer ( )

Desconecta este par, terminando la sesión de DTLS.

Devuelve el estado de la conexión. Ver Status para los valores.

  • void poll ( )

Sondea la conexión para comprobar si hay paquetes entrantes. Llama a esto con frecuencia para actualizar el estado y mantener la conexión en funcionamiento.