ESP8266 – WiFiClientSecure库 – connect

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

说明

connect函数用于ESP8266开发板通过HTTPS协议连接网络服务器。

语法

httpsClient.connect(ip, port)
httpsClient.connect(host, port)
注:请参考本页的示例程序部分获取更多应用说明信息。此函数在示例程序中被高亮标记以便您查阅。

参数

ip: 所要连接的服务器的IP地址。类型:IPAddress。
host:所要连接的服务器域名,可使用字符串类型。
port:所要连接的服务器端口号,允许使用int类型。

返回值

连接失败返回0,连接成功返回1。返回值数据类型是bool型。

示例程序

示例1:ESP8266实现HTTPS通讯(指纹认证)

以下程序将实现ESP8266建立与网站的HTTPS通讯,并且将网站服务器响应信息显示于串口监视器中。本程序使用了指纹认证方式。比起本页的“示例2:ESP8266实现HTTPS通讯(证书认证)”,示例1所采用的指纹认证不如证书认证安全性高。

请将以下示例程序中的Wifi联网信息进行调整并将程序上传给ESP8266。程序上传完毕后,ESP8266将会自动连接 WiFi并通过HTTPS协议与www.howsmyssl.com网站服务器进行通讯(该网站专门用于HTTPS通讯测试)。服务器响应信息将会通过串口监视器显示以便我们查阅。程序运行结果如下图所示。

ESP8266-HTTPS-Client-Example-Result-1
ESP8266-HTTPS-Client-Example-Result-1

此程序使用了语句httpsClient.connect(host, httpsPort)实现ESP8266与服务器连接。具体操作方法,请见以下示例程序的高亮部分。

注意:出于安全原因,网站服务器会定期更新证书指纹信息。因此本程序中的证书指纹可能已经过期。请使用浏览器获取最新的服务器证书指纹并复制粘贴到程序中相应位置。如需了解如何执行这一操作,请参考太极创客网站“查看网站证书指纹”页面。

示例2:ESP8266实现HTTPS通讯(证书认证)

本实例所实现的功能与示例1相同。唯一区别是本示例中在ESP8266与服务器的HTTPS通信中,使用证书认证而不是指纹认证。使用本示例中的证书认证可以提高HTTPS通讯安全性。

如需了解本示例程序的操作方法和运行结果,请参考示例1中的相应内容。

注意:出于安全原因,CA会定期更新根证书信息。因此本程序中的证书可能已经过期。请使用浏览器获取最新的网站根证书并复制粘贴到程序中相应位置。如需了解如何执行这一操作,请参考太极创客网站中
查看网站根证书”页面。

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