StreamPeerTLS
Eredita: StreamPeer < RefCounted < Object
Un peer di flusso che gestisce le connessioni TLS.
Descrizione
Un peer di flusso che gestisce le connessioni TLS. Questo oggetto può essere utilizzato per connettersi a un server TLS o accettare una singola connessione client TLS.
Nota: Quando si esporta su Android, assicurarsi di abilitare l'autorizzazione INTERNET nella preimpostazione d'esportazione Android prima di esportare il progetto o di utilizzare la distribuzione con un clic. Altrimenti, qualsiasi tipo di comunicazione di rete sarà bloccata da Android.
Tutorial
Metodi
accept_stream(stream: StreamPeer, server_options: TLSOptions) |
|
connect_to_stream(stream: StreamPeer, common_name: String, client_options: TLSOptions = null) |
|
void |
|
get_status() const |
|
get_stream() const |
|
void |
poll() |
Enumerazioni
enum Status: 🔗
Status STATUS_DISCONNECTED = 0
Uno stato che rappresenta uno StreamPeerTLS disconnesso.
Status STATUS_HANDSHAKING = 1
Uno stato che rappresenta uno StreamPeerTLS durante l'handshake.
Status STATUS_CONNECTED = 2
Uno stato che rappresenta uno StreamPeerTLS connesso a un host.
Status STATUS_ERROR = 3
Uno stato che rappresenta uno StreamPeerTLS in stato di errore.
Status STATUS_ERROR_HOSTNAME_MISMATCH = 4
Uno stato di errore che indica una mancata corrispondenza tra il dominio del certificato TLS presentato dall'host e il dominio richiesto per la convalida.
Descrizioni dei metodi
Error accept_stream(stream: StreamPeer, server_options: TLSOptions) 🔗
Accetta una connessione peer come server, utilizzando le opzioni server_options. Vedi TLSOptions.server().
Error connect_to_stream(stream: StreamPeer, common_name: String, client_options: TLSOptions = null) 🔗
Si connette a un peer utilizzando il stream StreamPeer sottostante e verificando che il certificato remoto sia firmato correttamente per il nome comune common_name. È possibile passare il parametro facoltativo client_options per personalizzare le autorità di certificazione attendibili o disabilitare la verifica del nome comune. Vedi TLSOptions.client() e TLSOptions.client_unsafe().
void disconnect_from_stream() 🔗
Si disconnette dall'host.
Restituisce lo stato della connessione.
StreamPeer get_stream() const 🔗
Restituisce la connessione StreamPeer sottostante, utilizzata in accept_stream() o nel connect_to_stream().
void poll() 🔗
Interroga la connessione per verificare i byte in arrivo. Chiamalo subito prima di StreamPeer.get_available_bytes() affinché funzioni correttamente.