ESP8266 NodeMCU HTTPS Secured POST Request

In this example we learn how to send Secured POST request to a secured https web page using NodeMCU or ESP8266? As we know all web pages are HTTP protocols, GET and POST are methods of communicating between web browser and the server. Also you look towards server side php Example coding. If you are looking for HTTPS GET method read here.

What is HTTPS?

HTTPS (HTTP over SSL or HTTP Secure) is the use of Secure Socket Layer (SSL) or Transport Layer Security (TLS) as a sublayer under regular HTTP application layering. HTTPS encrypts and decrypts user page requests as well as the pages that are returned by the Web server. The use of HTTPS protects against eavesdropping and man-in-the-middle attacks. HTTPS was developed by Netscape.

HTTPS and SSL support the use of X.509 digital certificates from the server so that, if necessary, a user can authenticate the sender. Unless a different port is specified, HTTPS uses port 443 instead of HTTP port 80 in its interactions with the lower layer, TCP/IP.

What is HTTP?

The Hypertext Transfer Protocol (HTTP) is designed to enable communications between clients and servers.

HTTP works as a request-response protocol between a client and server. Each Hypertext Transfer Protocol (HTTP) message is either a request or a response. A server listens on a connection for a request, parses each message received, interprets the message semantics in relation to the identified request target, and responds to that request with one or more response messages. A client constructs request messages to communicate specific intentions, examines received responses to see if the intentions were carried out, and determines how to interpret the results.

A web browser may be the client, and an application on a computer that hosts a web site may be the server.

Example: A client (browser) submits an HTTP request to the server; then the server returns a response to the client. The response contains status information about the request and may also contain the requested content.

Two HTTP Request Methods: GET and POST

Two commonly used methods for a request-response between a client and server are: GET and POST.

  • GET – Requests data from a specified resource
  • POST – Submits data to be processed to a specified resource

The POST Method

POST is used to send data to a server to create/update a resource.

The data sent to the server with POST is stored in the request body of the HTTP request:

POST /post HTTPS/1.1
Host:  postman-echo.com
name1=value1&name2=value2

POST is one of the most common HTTP methods.

Some other notes on POST requests:

  • POST requests are never cached
  • POST requests do not remain in the browser history
  • POST requests cannot be bookmarked
  • POST requests have no restrictions on data length

 

Before going directly to programming make sure you have latest version of ESP8266 boards

This example uses BearSSL which is now default (with the core release 2.5.0 to come, or the current git version, not with core-2.4.2 and older).

The example sketch for WiFiClientSecure fails to compile.
class axTLS::WiFiClientSecure' has no member named 'setFingerprint'

ESP8266 HTTPS POST Example Code

Make changes in wifi settings, SSID and password of your wifi network and change server ip. Also change GET request data as per your server requirements. and SHA1 fingerprint.

How to get SHA1 Fingerprint

Step1: Open the HTTPS link in web browser

https://postman-echo.com/get?foo1=bar1&foo2=bar2

Step2: Click on Green Lock Icon and click on more information or security certificate

Step3: Click on Security then View Certificate

Step 4: Copy SHA1 fingerprint and paste it in code, remove colons

Make required changes in code and upload.

Upload the code and open serial monitor, in case of any problem it will show errors.

NodeMCU Secured HTTPS POST

Few common problems and solutions

  1. Do not use http or https in front of host ink
  2. Error finger print not defined Update Board
  3. Error “-1” You are trying to connect with secure website HTTPS.
  4. Error Connection Failed You are using port 80 for HTTPS. HTTPS works on PORT 443

How to make POST request ? explained here

Leave a Reply