ESP8266 – WiFiClientSecure库 – getLastSSLError

位置导航: ESP8266库 / WiFiClientSecure库 / 本页

说明

ESP8266通过HTTPS协议进行物联网通讯时，我们可以使用getLastSSLError获取通讯报错信息。这些报错信息将以错误代码的形式通过getLastSSLError返回。

如需了解报错代码的详细说明，您可以参考以下两个文件中相应部分。

bearssl_ssl.h
bearssl_x509.h

语法

httpsClient.getLastSSLError()

参数

无

返回值

错误代码值，（类型： int）

示例程序

请将以下示例程序中的Wifi联网信息进行调整并将程序上传给ESP8266。程序上传完毕后，ESP8266将会自动连接 WiFi并通过HTTPS协议尝试与必应网站服务器进行通讯。由于我们故意将服务器认证的指纹信息改为错误的，连接将会失败，同时程序中使用了httpsClient.getLastSSLError()来获取连接失败的报错信息。具体操作方法，请见以下示例程序中的高亮代码部分。

如需了解报错代码的详细说明，您可以参考以下两个文件中相应部分。

bearssl_ssl.h
bearssl_x509.h

/**********************************************************************
项目名称/Project          : 零基础入门学用物联网
程序名称/Program name     : ESP8266-WiFiClientSecure-getLastSSLError
团队/Team                : 太极创客团队 / Taichi-Maker (www.taichi-maker.com)
作者/Author              : CYNO朔
日期/Date（YYYYMMDD）     : 20200418
程序目的/Purpose          : 
此程序用于演示如何使用WiFiClientSecure库中的getLastSSLError函数来获取
连接出错信息。
程序中故意将服务器指纹改为错误的。这么做是为了让getLastSSLError返回出错数据信息。
-----------------------------------------------------------------------
本示例程序为太极创客团队制作的《零基础入门学用物联网》中示例程序。
该教程为对物联网开发感兴趣的朋友所设计和制作。如需了解更多该教程的信息，请参考以下网页：
http://www.taichi-maker.com/homepage/esp8266-nodemcu-iot/
***********************************************************************/
#include <ESP8266WiFi.h>
#include <WiFiClientSecure.h> 
#include <ESP8266WebServer.h>

//WiFi连接信息（注意：需要自行修改以下内容否则ESP8266无法连接WiFi）
#define ssid "taichimaker"   //WiFi名称 
#define password "12345678"  //WiFi密码

//测试HTTPS通讯的网站
const char *host = "cn.bing.com"; 

//HTTPS端口443
const int httpsPort = 443;  

//注意：出于安全原因，网站服务器会定期更新证书指纹信息。因此本程序
//中的证书指纹可能已经过期。请使用浏览器获取最新的服务器证书指纹
//并复制粘贴到此处。如需了解如何执行这一操作，请参考太极创客网站中
//“获取网站证书指纹”页面(网址见下):
//http://www.taichi-maker.com/homepage/iot-development/iot-dev-reference/esp8266-c-plus-plus-reference/http-client-secure/certificate-fingerprint/

//const char *fingerprint = "62914576dc0afac83c4804bcc2c1b700a61139fe"; // 正确指纹
const char *fingerprint = "62914576dc0afac83c4804bcc2c1b700a69fe123";// 错误指纹

void setup() {
  Serial.begin(9600);
  WiFi.mode(WIFI_STA);        //设置ESP8266为无线终端工作模式
  
  WiFi.begin(ssid, password); //连接WiFi
  Serial.println("");
 
  Serial.println("Connecting"); Serial.println("");
  
  // 等待连接
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
 
  //成功连接后通过串口监视器显示WiFi名称以及ESP8266的IP地址。
  Serial.println("");
  Serial.print("Connected to ");
  Serial.println(ssid);
  Serial.print("IP address: ");
  Serial.println(WiFi.localIP()); 

  // 实现HTTPS通讯
  httpsCom();
}
 
void loop(){}

void httpsCom(){
  WiFiClientSecure httpsClient;    //建立WiFiClientSecure对象
  
  Serial.println(host);
   
  Serial.printf("Using fingerprint '%s'\n", fingerprint);
  httpsClient.setFingerprint(fingerprint);
  httpsClient.setTimeout(15000);  
  delay(1000);
  
  Serial.println("HTTPS Connecting");Serial.println("");
  int r=0;  // 尝试连接服务器并等待
  while((!httpsClient.connect(host, httpsPort)) && (r < 30)){
     
      Serial.print("httpsClient.getLastSSLError() = ");
      Serial.println(httpsClient.getLastSSLError());
      
      delay(100);
      Serial.print(".");
      r++;
  }
  // 连接超时后输出"连接失败"信息并返回
  if(r==30) { 
    Serial.println("Connection failed");
    return;
  } else { // 连接成功则输出“连接成功”信息
    Serial.println("Connected...");
  }
  
  Serial.print("requesting: ");
  Serial.println(host);
  
  // 建立HTTPS请求信息字符串
  String request =  String("GET /a/check") + " HTTP/1.1\r\n" +
                        "Host: " + host + "\r\n" +
                        "Connection: close\r\n" +
                        "\r\n";
  // 向服务器发送请求                   
  httpsClient.print(request);
  
  Serial.println("request sent");

  // 检查服务器响应信息。通过串口监视器输出服务器状态码和响应头信息
  // 从而确定ESP8266已经成功连接服务器
  while (httpsClient.connected()) {
    String line = httpsClient.readStringUntil('\n');
    //Serial.println(line);
    if (line == "\r") {
      Serial.println("headers received");
      break;
    }
  }
  
  Serial.println("Now disconect from the server..."); 
  
  //操作结束，断开服务器连接 
  httpsClient.stop();
  Serial.println("closing connection");  
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

/**********************************************************************

项目名称/Project : 零基础入门学用物联网

程序名称/Program name : ESP8266-WiFiClientSecure-getLastSSLError

团队/Team : 太极创客团队 / Taichi-Maker (www.taichi-maker.com)

作者/Author : CYNO朔

日期/Date（YYYYMMDD） : 20200418

程序目的/Purpose :

此程序用于演示如何使用WiFiClientSecure库中的getLastSSLError函数来获取

连接出错信息。

程序中故意将服务器指纹改为错误的。这么做是为了让getLastSSLError返回出错数据信息。

-----------------------------------------------------------------------

本示例程序为太极创客团队制作的《零基础入门学用物联网》中示例程序。

该教程为对物联网开发感兴趣的朋友所设计和制作。如需了解更多该教程的信息，请参考以下网页：

http://www.taichi-maker.com/homepage/esp8266-nodemcu-iot/

***********************************************************************/

#include <ESP8266WiFi.h>

#include <WiFiClientSecure.h>

#include <ESP8266WebServer.h>

//WiFi连接信息（注意：需要自行修改以下内容否则ESP8266无法连接WiFi）

#define ssid "taichimaker" //WiFi名称

#define password "12345678" //WiFi密码

//测试HTTPS通讯的网站

const char *host = "cn.bing.com";

//HTTPS端口443

const int httpsPort = 443;

//注意：出于安全原因，网站服务器会定期更新证书指纹信息。因此本程序

//中的证书指纹可能已经过期。请使用浏览器获取最新的服务器证书指纹

//并复制粘贴到此处。如需了解如何执行这一操作，请参考太极创客网站中

//“获取网站证书指纹”页面(网址见下):

//http://www.taichi-maker.com/homepage/iot-development/iot-dev-reference/esp8266-c-plus-plus-reference/http-client-secure/certificate-fingerprint/

//const char *fingerprint = "62914576dc0afac83c4804bcc2c1b700a61139fe"; // 正确指纹

const char *fingerprint = "62914576dc0afac83c4804bcc2c1b700a69fe123";// 错误指纹

void setup() {

Serial.begin(9600);

WiFi.mode(WIFI_STA); //设置ESP8266为无线终端工作模式

WiFi.begin(ssid, password); //连接WiFi

Serial.println("");

Serial.println("Connecting"); Serial.println("");

// 等待连接

while (WiFi.status() != WL_CONNECTED) {

delay(500);

Serial.print(".");

}

//成功连接后通过串口监视器显示WiFi名称以及ESP8266的IP地址。

Serial.println("");

Serial.print("Connected to ");

Serial.println(ssid);

Serial.print("IP address: ");

Serial.println(WiFi.localIP());

// 实现HTTPS通讯

httpsCom();

}

void loop(){}

void httpsCom(){

WiFiClientSecure httpsClient; //建立WiFiClientSecure对象

Serial.println(host);

Serial.printf("Using fingerprint '%s'\n", fingerprint);

httpsClient.setFingerprint(fingerprint);

httpsClient.setTimeout(15000);

delay(1000);

Serial.println("HTTPS Connecting");Serial.println("");

int r=0; // 尝试连接服务器并等待

while((!httpsClient.connect(host, httpsPort)) && (r < 30)){

Serial.print("httpsClient.getLastSSLError() = ");

Serial.println(httpsClient.getLastSSLError());

delay(100);

Serial.print(".");

r++;

}

// 连接超时后输出"连接失败"信息并返回

if(r==30) {

Serial.println("Connection failed");

return;

} else { // 连接成功则输出“连接成功”信息

Serial.println("Connected...");

}

Serial.print("requesting: ");

Serial.println(host);

// 建立HTTPS请求信息字符串

String request = String("GET /a/check") + " HTTP/1.1\r\n" +

"Host: " + host + "\r\n" +

"Connection: close\r\n" +

"\r\n";

// 向服务器发送请求

httpsClient.print(request);

Serial.println("request sent");

// 检查服务器响应信息。通过串口监视器输出服务器状态码和响应头信息

// 从而确定ESP8266已经成功连接服务器

while (httpsClient.connected()) {

String line = httpsClient.readStringUntil('\n');

//Serial.println(line);

if (line == "\r") {

Serial.println("headers received");

break;

}

Serial.println("Now disconect from the server...");

//操作结束，断开服务器连接

httpsClient.stop();

Serial.println("closing connection");

}

位置导航: ESP8266库 / WiFiClientSecure库 / 本页