穩(wěn)定性: 3 - 穩(wěn)定
HTTPS 是基于 TLS/SSL 的 HTTP 協(xié)議。在 Node 里作為單獨的模塊來實現(xiàn)。
這是 tls.Server 的子類,并且和 http.Server 一樣觸發(fā)事件。更多信息參見 http.Server 。
詳情參見 http.Server#setTimeout().
詳情參見 http.Server#timeout.
返回一個新的 HTTPS 服務(wù)器對象。其中 options 類似于 [tls.createServer()][tls.md#tls_tls_createserver_options_secureconnectionlistener]。 requestListener 函數(shù)自動加到 'request' 事件里。
例如:
// curl -k https://localhost:8000/
var https = require('https');
var fs = require('fs');
var options = {
key: fs.readFileSync('test/fixtures/keys/agent2-key.pem'),
cert: fs.readFileSync('test/fixtures/keys/agent2-cert.pem')
};
https.createServer(options, function (req, res) {
res.writeHead(200);
res.end("hello world\n");
}).listen(8000);
或
var https = require('https');
var fs = require('fs');
var options = {
pfx: fs.readFileSync('server.pfx')
};
https.createServer(options, function (req, res) {
res.writeHead(200);
res.end("hello world\n");
}).listen(8000);
詳情參見 http.listen()。
詳情參見 http.close()。
發(fā)送請求到安全 web 服務(wù)器。
options 可以是一個對象或字符串。如果 options 是字符串。會被 url.parse() 解析。
所有來自 http.request() 選項都是經(jīng)過驗證的。
例如:
var https = require('https');
var options = {
hostname: 'encrypted.google.com',
port: 443,
path: '/',
method: 'GET'
};
var req = https.request(options, function(res) {
console.log("statusCode: ", res.statusCode);
console.log("headers: ", res.headers);
res.on('data', function(d) {
process.stdout.write(d);
});
});
req.end();
req.on('error', function(e) {
console.error(e);
});
option 參數(shù)有以下的值:
host: 請求的服務(wù)器域名或 IP 地址,默認:'localhost'hostname: 用于支持 url.parse()。 hostname 優(yōu)于 hostport: 遠程服務(wù)器端口。 默認: 443.method: 指定 HTTP 請求方法。 默認: 'GET'.path: 請求路徑。 默認: '/'。如果有查詢字符串,則需要包含。比如 '/index.html?page=12'headers: 包含請求頭的對象auth: 用于計算認證頭的基本認證,即user:passwordagent: 控制Agent的行為。當(dāng)使用了一個Agent的時候,請求將默認為Connection: keep-alive??赡艿闹禐椋?undefined (default): 在這個主機和端口上使用 [global Agent][]Agent object: 在Agent中顯式使用 passed.false: 選擇性停用連接池,默認請求為: Connection: closetls.connect() 的參數(shù)也能指定。但是,globalAgent 會忽略他們。
pfx: SSL 使用的證書,私鑰,和證書Certificate, 默認 null.key: SSL 使用的私鑰. 默認 null.passphrase: 私鑰或 pfx 的口令字符串. 默認 null.cert: 所用公有 x509 證書. 默認 null.ca: 用于檢查遠程主機的證書頒發(fā)機構(gòu)或包含一系列證書頒發(fā)機構(gòu)的數(shù)組。ciphers: 描述要使用或排除的密碼的字符串,格式請參閱
http://www.openssl.org/docs/apps/ciphers.html#CIPHER_LIST_FORMATrejectUnauthorized: 如為 true 則服務(wù)器證書會使用所給 CA 列表驗證。如果驗證失敗則會觸發(fā) error 事件。驗證過程發(fā)生于連接層,在 HTTP 請求發(fā)送之前。缺省為 true.secureProtocol: 所用的 SSL 方法,比如 TLSv1_method 強制使用 TLS version 1??扇≈等Q于您安裝的 OpenSSL, 和定義于 SSL_METHODS 的常量。要指定這些選項,使用一個自定義 Agent.
例如:
var options = {
hostname: 'encrypted.google.com',
port: 443,
path: '/',
method: 'GET',
key: fs.readFileSync('test/fixtures/keys/agent2-key.pem'),
cert: fs.readFileSync('test/fixtures/keys/agent2-cert.pem')
};
options.agent = new https.Agent(options);
var req = https.request(options, function(res) {
...
}
或者不使用 Agent.
例如:
var options = {
hostname: 'encrypted.google.com',
port: 443,
path: '/',
method: 'GET',
key: fs.readFileSync('test/fixtures/keys/agent2-key.pem'),
cert: fs.readFileSync('test/fixtures/keys/agent2-cert.pem'),
agent: false
};
var req = https.request(options, function(res) {
...
}
和 http.get() 類似,不過是 HTTPS 版本的.
options 可以是字符串對象. 如果 options 是字符串, 會自動使用 url.parse() 解析。
例如:
var https = require('https');
https.get('https://encrypted.google.com/', function(res) {
console.log("statusCode: ", res.statusCode);
console.log("headers: ", res.headers);
res.on('data', function(d) {
process.stdout.write(d);
});
}).on('error', function(e) {
console.error(e);
});
HTTPS 的 Agent 對象,和 http.Agent 類似。 詳情參見 https.request()。
所有 HTTPS 客戶端請求的 https.Agent 全局實例。