Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

340 6 Netzwerkprogrammierung mit SSL
sich am serverseitigen oder clientseitigen Ende der Verbindung befinden wird.
Dies geschieht über die Funktion BIO_set_ssl_mode(), welchedasBIO b
bzw. die mittels BIO_set_ssl() assoziierte SSL-Datenstruktur noch vor dem
Verbindungsaufbau in den Client- oder Servermodus versetzt. Hat der Parameter
client den Wert 0, so handelt es sich um die Serverseite, hat der
Parameter dagegen den Wert 1, so sitzt das BIO auf der Clientseite der aufzubauenden
SSL-Verbindung.
#include
#include
BIO_METHOD *BIO_f_ssl( void );
long BIO_set_ssl( BIO *b, SSL *ssl, long flags );
long BIO_set_ssl_mode( BIO *b, long client );
BIO *BIO_new_ssl( SSL_CTX *ctx, int client );
BIO *BIO_new_ssl_connect( SSL_CTX *ctx );
BIO *BIO_new_buffer_ssl_connect( SSL_CTX *ctx );
long BIO_do_handshake( BIO *b );
long BIO_get_ssl( BIO *b, SSL **ssl );
Den gleichen Zweck erfüllt der client-Parameter bei der BIO_new_ssl()-
Funktion, die die beiden Aufrufe von BIO_new() und BIO_set_ssl() in einem
Funktionsaufruf zusammenfaßt. Die Funktion leitet dazu aus der übergebenen
SSL_CTX-Datenstruktur ctx, dem sogenannten SSL-Kontext, eine passende
SSL-Datenstruktur ab und assoziiert diese mit dem neuen BIO-Objekt. 21 Je
nach Wert des client-Parameters wird das neue BIO schließlich in den Clientoder
Servermodus versetzt. BIO_new_ssl() liefert als Ergebnis entweder ein
neues SSL-BIO oder bei Mißerfolg einen Nullzeiger.
Für die Clientseite einer SSL-Verbindung gibt es zwei weitere, äußerst praktische
Abkürzungen: Die beiden Hilfsfunktionen BIO_new_ssl_connect() und
BIO_new_buffer_ssl_connect() erstellen gleich eine ganze BIO-Kette, bestehend
entweder aus einem SSL-BIO gefolgt von einem Connect-BIO oder
sogar aus einem Puffer-BIO gefolgt von einem SSL- und einem Connect-BIO.
Das SSL-BIO der neuen BIO-Kette befindet sich jeweils im Clientmodus. Die
beiden Funktionen stellen damit für SSL-Clients bei der Vorbereitung einer
neuen SSL-Verbindung meist die erste Wahl dar, denn mit ihrer Hilfe entfällt
das sonst übliche manuelle Aneinanderreihen dieser für SSL-Verbindungen typischen
BIO-Objekte. Die beiden Funktionen liefern als Ergebnis entweder ein
neues SSL-BIO oder bei Mißerfolg einen Nullzeiger.
21 Was es mit dem SSL-Kontext auf sich hat, erfahren wir in Kapitel 7.