Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

6.3 OpenSSL-Basisfunktionalität 341
Um für die neue SSL-Verbindung von Haus aus die weiter oben beschriebenen
Wiederholungsanforderungen zu vermeiden, die im Falle der SSL-
Kommunikation auch bei der blockierenden Ein-/Ausgabe auftreten können,
wird im Normalfall für die Verbindung noch vor deren Aufbau das Flag
SSL_MODE_AUTO_RETRY gesetzt. Diese Option wird über die SSL-Funktion
SSL_set_mode(), auf die wir in Kapitel 7 noch eingehen werden, gesetzt. Die
Funktion benötigt dazu Zugriff auf die zum BIO assoziierte SSL-Datenstruktur,
die sich ggf. durch BIO_get_ssl() ermitteln läßt. Die Funktion bzw. das Makro
BIO_get_ssl() liefert die mit dem BIO b verknüpfte SSL-Struktur im
Parameter ssl zurück. Der Parameter ist dazu als Zeiger auf einen Zeiger
ausgelegt.
Sobald nun die Vorbereitungen für eine neue SSL-Verbindung abgeschlossen
sind, kann für das BIO bzw. die BIO-Kette b der Verbindungsaufbau inklusive
SSL-Handshake über die Funktion BIO_do_handshake() explizit angestoßen
werden. Die Funktion liefert den Rückgabewert 1, wenn der Verbindungsaufbau
geklappt hat und das Handshake-Verfahren erfolgreich abgeschlossen
wurde. Ein Wert ≤ 0 zeigt an, daß der Aufbau der neuen SSL-Verbindung
nicht erfolgreich beendet werden konnte.
Das nachfolgende Programmfragment faßt die wesentlichen Schritte für den
clientseitigen Aufbau einer neuen SSL-Verbindung kurz zusammen, verzichtet
dabei aber der Übersichtlichkeit halber erneut auf die Fehlerbehandlung:
1 /* SSL-BIO erstellen , SSL-Kontext bereits initialisiert */
2 ssl_bio = BIO_new_ssl_connect( ctx );
3
4 /* assoziierte SSL-Struktur ermitteln */
5 BIO_get_ssl( ssl_bio , &ssl );
6
7 /* Wiederholungsanforderungen für Verbindung verhindern */
8 SSL_set_mode( ssl, SSL_MODE_AUTO_RETRY );
9
10 /* entfernten Endpunkt setzen: Host indien , Port 443 */
11 BIO_set_conn_hostname( ssl_bio , "indien:https" );
12
13 /* TCP-Verbindung aufbauen und SSL-Handshake durchführen */
14 BIO_do_handshake( ssl_bio );
15
16 /* HTTP-Request schicken */
17 BIO_puts( ssl_bio , "GET / HTTP/1.0\n\n" );
1–2
Der Aufruf der BIO_new_ssl_connect() setzt in ctx einen bereits initialisierten
SSL-Kontext voraus und erzeugt unter Verwendung dieses Kontexts
eine neue BIO-Kette bestehend aus einem SSL-BIO und einem nachfolgenden
Connect-BIO.