Teilen Sie:
){kind=small}
Julia hat es sich zur Aufgabe gemacht, andere Entwickler durch die Erstellung von Tutorials, Anleitungen und praktischen Ressourcen zu unterstützen. Mit ihrem Hintergrund in den Bereichen Öffentlichkeitsarbeit und Bildung möchte sie Technologien zugänglicher machen und die Erfahrung von Entwicklern insgesamt verbessern. Man kann sie oft bei lokalen Veranstaltungen antreffen.
cURL, HTTPS und die Nexmo SMS API - Hinter den Kulissen
Das Versenden einer SMS mit der Nexmo API ist so einfach wie eine Anfrage an die URL: https://rest.nexmo.com/sms/json. Aber haben Sie sich jemals gefragt, was hinter den Kulissen passiert? Was macht Ihr Computer, wenn Sie etwas aus dem Internet anfordern? Was macht der Server?
Diese Fragen wollen wir im Folgenden beantworten, also folgen Sie uns, wenn Sie sich selbst ein Bild machen wollen.
Bevor wir beginnen, brauchen Sie ein paar Dinge:
Die cURL Kommandozeilentool zum Senden und Empfangen von Daten.
Um dieses Tutorial durchzuführen, benötigen Sie ein Vonage API-Konto. Wenn Sie noch keines haben, können Sie sich noch heute anmelden und mit einem kostenlosen Guthaben beginnen. Sobald Sie ein Konto haben, finden Sie Ihren API-Schlüssel und Ihr API-Geheimnis oben auf dem Vonage-API-Dashboard.
Das Senden einer https Anfrage an die Nexmo SMS API ist ganz einfach. Ersetzen Sie einfach die folgenden Variablen im untenstehenden Beispiel, und die Nachricht sollte auf dem Weg sein.
| KEY | DESCRIPTION |
|---|---|
NEXMO_KEY |
Your Nexmo API key, shown in your account overview. |
NEXMO_SECRET |
Your Nexmo API secret, shown in your account overview. |
TO_NUMBER |
The number you are sending the SMS to in E.164 format. For example 447401234567. |
SENDER_ID |
The number or text shown on a handset when it displays your message. You can set a custom Alphanumeric SENDER_ID to represent your brand better if this feature is supported in your country. |
Sie können curl mit folgenden Optionen aufrufen Befehlszeilenoptionen aufrufen, um die URL(s) zu begleiten. Diese Optionen geben Informationen darüber an curl weiter, wie es sich verhalten soll.
Die Nexmo-Dokumentation verwendet -d um Zeichenketten von Daten in einer POST-Anfrage an einen Server zu senden, und wir fügen -v/--verbose um den ausführlichen Modus einzuschalten.
Letzteres ermöglicht es uns, die zusätzlichen Informationen zu sehen, die uns von den curl-Interna gegeben werden, zusammen mit allen Headern, die es sendet und empfängt. Außerdem wird --trace-time damit cURL allen ausführlichen Ausgaben einen hochauflösenden Timer für den Zeitpunkt des Ausdrucks der Zeile voranstellt.
Werfen wir nun einen Blick auf die Ausgabe:
Wenn es Ihnen so geht wie mir und Sie vielleicht einen "Freund" haben, der eine Zeit lang das commandLineMyNemesis GitHub-Handle für eine Weile besaß, sollten Sie sich diese Ausgabe vielleicht noch einmal ansehen. Zerlegen wir sie in einzelne Schritte und sehen wir uns an, was jeder von ihnen tut.
Das von uns verwendete HTTPS-Protokoll spricht TCP (Transmission Control Protocol). Mit TCP muss cURL zuerst die IP-Adresse des angeforderten Hosts herausfinden: Trying 173.193.199.22..., dann eine Verbindung zu ihm herstellen: Connected to rest.nexmo.com (173.193.199.22) port 443 (#0). Dabei führt es einen TCP-Protokoll-Handshake.
Der '(#0)Teil zeigt an, welche interne Nummer cURL dieser Verbindung gegeben hat.
TCP_NODELAY ist set standardmäßig aktiviert, was eine Segmentpufferung ermöglicht, damit die Daten so schnell wie möglich gesendet werden können. Sie wird in der Regel verwendet, um die Netzauslastung zu erhöhen.
HTTPS steht für "Secure HTTP", was bedeutet, dass die TCP-Transportschicht erweitert wird, um Authentifizierung, Verschlüsselung und Datenintegrität unter Verwendung von TLS (Transport Layer Security) zu bieten.
Die TLS-Verbindung beginnt mit einem "Handshake", einer Verhandlung zwischen dem Client (cURL, das auf Ihrem PC läuft) und dem Server, in der die Details des weiteren Vorgehens geklärt werden. Der Handshake legt fest, welche Cipher Suite verwendet wird, verifiziert den Server und stellt sicher, dass eine sichere Verbindung hergestellt wird, bevor die eigentliche Datenübertragung beginnt.
Wir sind darüber informiert, dass Nexmo die “TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256” aus den von uns angebotenen Chiffriersuiten auswählte. Das bedeutet, dass das ECDHE Protokoll gewählt wurde, wird es den RSA Public-Key-Algorithmus zur Verifizierung von Zertifikatsignaturen und zum Schlüsselaustausch, den AES Algorithmus in GCM um Daten zu verschlüsseln, und den SHA256 um den Inhalt von Nachrichten zu verifizieren.
Die Gewissheit, dass Sie mit dem richtigen Host kommunizieren, ist ebenso wichtig wie eine sichere Verbindung. Während des TLS-Handshakes erhält cURL das Zertifikat des entfernten Servers und überprüft dessen Signatur, indem es es mit seinem eigenen CA-Zertifikatspeicher vergleicht. Dies geschieht, um sicherzustellen, dass wir mit dem richtigen TLS-Server kommunizieren - der Nexmo-Server ist also tatsächlich der Nexmo-Server.
Eine von einem Client gesendete HTTP-Anfrage beginnt mit einer Anfragezeile: POST /sms/json HTTP/1.1gefolgt von Kopfzeilen und einem optionalen Textkörper, der von den Kopfzeilen durch eine Leerzeile getrennt ist.
Die Kopfzeilen der Anfrage enthalten Informationen über den Server, mit dem wir kommunizieren, über unsere Softwareversion, über die Inhaltstypen, die wir verstehen können, und über den Inhalt des Anfragekörpers.
Die Anfrage, die wir gesendet haben, erhält eine entsprechende HTTP-Antwort vom Server. Sie enthält eine Reihe von Kopfzeilen und einen Antwortkörper, getrennt durch eine Leerzeile.
Die erste Zeile zeigt einen Statuscode, in diesem Fall, 200 OKan, der uns mitteilt, dass die Anfrage erfolgreich war.
Die Header enthalten Metadaten des Nexmo-Servers, die uns sagen, dass er nginx als Webserver-Plattform verwendet, dass er den Inhalt in einem JSON-Format zurücksendet und dass der Inhalt gechunked ist, so dass wir nicht mit einem Content-Length Header erwarten (wie cURL ihn im Request-Header sendet).
Der Connection: keep-alive Teil lässt uns wissen, dass TCP's keepalive Funktion verwendet wird. cURL tut dies standardmäßig, so dass "Ping-Frames" hin und her geschickt werden, wenn die Verbindung sonst völlig untätig wäre. Dies hilft, Unterbrechungen von Verbindungen zu erkennen, auch wenn kein Datenverkehr stattfindet, und hilft den Zwischensystemen zu verstehen, dass die Verbindung noch besteht.
Es gibt auch ein paar sicherheitsrelevante Header darin, X-Frame-Options: deny erlaubt es einem Browser nicht, diese URL in einem <frame>, <iframe> oder <object> darzustellen. Nexmo nutzt dies, um Clickjacking-Angriffe zu verhindern, indem sichergestellt wird, dass der Inhalt nicht in andere Websites eingebettet wird. X-XSS-Protection: 1; mode=block; aktiviert die XSS-Filterung, so dass der Browser das Rendering der Seite verhindert, wenn ein Angriff erkannt wird.
Die letzte Zeile ist leer, das ist die Markierung, die das HTTP-Protokoll verwendet, um das Ende der Header zu signalisieren.
Der Antwortkörper enthält Informationen über den gesendeten Text, beginnend mit der Anzahl der Nachrichten: "message-count": "1", gefolgt von einer "messages": Array von Objekten mit Details zu jeder einzelnen Nachricht. Die Elemente dieses Arrays sind wie folgt: die Nummer, an die die Nachricht gesendet wurde, die ID der Nachricht, der Status der Nachricht, das verbleibende Guthaben auf dem Nexmo Account, die Kosten der Nachricht und die ID des Empfängernetzes.
Connection #0 to host rest.nexmo.com left intact lässt uns wissen, dass die Verbindung nicht als Folge der Übertragung geschlossen wird. Sobald cURL jedoch zur Kommandozeile zurückkehrt, wird die Verbindung geschlossen.
Auch wenn es weniger als 2 Sekunden gedauert hat, eine SMS zu versenden, gibt es eine Menge, was auf den ersten Blick nicht zu erkennen ist. Ich hoffe, dass es mir gelungen ist, etwas Licht ins Dunkel zu bringen, und dass Sie jetzt besser verstehen, was bei einer HTTPS-Anfrage an die Nexmo SMS API wirklich passiert. Wenn Sie noch Fragen haben, die unbeantwortet geblieben sind, können Sie mich gerne mich auf Twitter zu erreichen.
Wenn Sie noch tiefer in die genannten Technologien eintauchen möchten, sollten Sie sich diese Ressourcen ansehen Die ersten paar Millisekunden einer HTTPS-Verbindung, HTTP-Kopfzeilen, HTTP über TLS, Das TLS-Protokoll, Alles cURL und die Nexmo SMS API.
Teilen Sie:
Julia hat es sich zur Aufgabe gemacht, andere Entwickler durch die Erstellung von Tutorials, Anleitungen und praktischen Ressourcen zu unterstützen. Mit ihrem Hintergrund in den Bereichen Öffentlichkeitsarbeit und Bildung möchte sie Technologien zugänglicher machen und die Erfahrung von Entwicklern insgesamt verbessern. Man kann sie oft bei lokalen Veranstaltungen antreffen.