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¶
connect_to_peer ( PacketPeerUDP packet_peer, bool validate_certs=true, String for_hostname="", X509Certificate valid_certificate=null ) |
|
void |
|
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¶
Error connect_to_peer ( PacketPeerUDP packet_peer, bool validate_certs=true, String for_hostname="", X509Certificate valid_certificate=null )
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.
Status get_status ( ) const
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.