名称
WiFiClientSecure::connect()
説明
指定したホストのポートにTCP接続する。
書式
#include <WiFiClientSecure.h>
int WiFiClientSecure::connect(IPAddress ip, uint16_t port);
int WiFiClientSecure::connect(IPAddress ip, uint16_t port, int32_t timeout);
int WiFiClientSecure::connect(const char *host, uint16_t port);
int WiFiClientSecure::connect(const char *host, uint16_t port, int32_t timeout);
int WiFiClientSecure::connect(IPAddress ip, uint16_t port, const char *CA_cert, const char *cert, const char *private_key);
int WiFiClientSecure::connect(const char *host, uint16_t port, const char *CA_cert, const char *cert, const char *private_key);
int WiFiClientSecure::connect(IPAddress ip, uint16_t port, const char *pskIdent, const char *psKey);
int WiFiClientSecure::connect(const char *host, uint16_t port, const char *pskIdent, const char *psKey);
引数
| ip | IPアドレス。 |
| host | ホスト名。 |
| port | ポート番号。 |
| timeout | タイムアウト(単位:ミリ秒)。 |
| CA_cert | ルート証明書。 |
| cert | クライアント証明書(?)。 |
| private_key | クライアント証明書の秘密鍵(?)。 |
| pskIdent | PSKアイデンティティ。 |
| psKey | プリシェアードキー。 |
戻り値
接続に成功すると1、失敗すると0。
注意
Arduino core for the ESP32 2.0.1からは、HTTPS接続を行うためには、デフォルトで、証明書による検証が必須となったようです。証明書による検証を行わない場合は、WiFiClientSecure::setInsecure()を呼び出せばいいようです。
使用例
バージョン
| Hardware: | ESP-WROOM-32 |
| Software: | Arduino core for the ESP32 2.0.2 |
最終更新日
December 29, 2021