ESP8266 – WiFiClientSecure库 – setCiphers

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

说明

setCiphers可用来设置ESP8266的HTTPS通讯加密方式。与使用setTrustAnchors函数来对服务器根证书认证比较,setCiphers安全性能要更低。但是此使用setCiphers可以降低ESP8266的运算工作。因此ESP8266的能耗也会相应降低。如果您的项目使用电池为ESP8266供电且需要降低ESP8266能耗,可以考虑采用此方法实现ESP8266的HTTPS通讯。如需了解更多加密方式,请参考ESP8266库源文件中WiFiClientSecureBearSSL.cpp中相关信息。

语法

httpsClient.setCiphers(cipherList)

参数

cipherList: 加密方式

返回值

成功设置加密方式,则返回true。否则返回false。返回值为布尔型。

示例程序

以下程序将实现ESP8266建立与网站的HTTPS通讯,并且将网站服务器响应状态码以及响应头信息显示于串口监视器中。

请将以下示例程序中的Wifi联网信息进行调整并将程序上传给ESP8266。程序上传完毕后,ESP8266将会自动连接 WiFi并通过HTTPS协议与必应网站服务器进行通讯。服务器响应状态码以及响应头信息显示于串口监视器中以便我们查阅。

在以下示例程序中,我们在使用setCiphers前需要首先使用httpsClient.setInsecure()来设置ESP8266。接下来使用 httpsClient.setCiphers(myCustomList)来设置具体加密方式。具体操作方法,请见以下程序中高亮语句部分。

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