OCSP 节点API.js
各种 业务支助处- 相关API,用于节点.j.
此软件包是维护的叉 废物/垃圾,其中包含 gitHub分叉网络的校正和改进。 见[变相.md] 为完整的历史.
安装
$ npm install @haraka/ocsp
部件
- 探员
- 缓存
- 服务器
check()编号 :verify()request.generate()getOCSPURI()
探员
用法 :
const agent = new ocsp.Agent()
https.request({
method: ...,
host: ...,
port: ...,
path: ...,
// Other options
agent
}, (res) => {
// ...
})
以下代码片段将向指定的服务器执行请求,并且 使用 OCSP 验证服务器的证书( 要么进行分层, 要么从 (美国) 如果证书未发布 OCSP URL 的广告,则连接为 允许继续.
注:您可通过 options 对象 new ocsp.Agent(options)它可能
具有下列属性:
CACacheSize: 保存在缓存中的 CA 证书数量 。 (过失:1024)
缓存
用法 :
const cache = new ocsp.Cache()
const server = https.createServer({
cert: cert,
key: key
}, (req, res) => {
res.end('hello world')
})
server.on('OCSPRequest', (cert, issuer, cb) => {
ocsp.getOCSPURI(cert, (err, uri) => {
if (err) return cb(err)
if (uri === null) return cb()
const req = ocsp.request.generate(cert, issuer)
cache.probe(req.id, (err, cached) => {
if (err) return cb(err)
if (cached !== false) return cb(null, cached.response)
cache.request(req.id, { url: uri, ocsp: req.data }, cb)
})
})
})
应使用缓存提供 OCSP 安装 对客户的答复.
注:构造器接受一种 options 具有下列属性的对象:
probe: 覆盖.probe()方法store: 覆盖.store()方法filter数字 :filter(url, callback)要请求的白名单 CA URL
有下列方法:
.probe(id, callback)——检查响应是否被缓存.request(id, options, callback)获取并缓存新的OCSP响应.store(id, response, maxTime, callback)——手动存储响应.clear()——清除所有缓存回复并取消所有待决定时器
服务器
用法 :
const server = ocsp.Server.create({
caCert: cacert, // optional, defaults to `cert` if not supplied
cert: cert,
key: key
})
server.addCert(43, 'good')
server.addCert(44, 'revoked', {
revocationTime: new Date(),
revocationReason: 'CACompromise'
})
server.listen(8000)
OCSP 服务器,即为 OCSP 提供 OCSP 响应的 HTTP 服务器 请求.
有下列方法:
.addCert(serialNumber, status, info),其中:serialNumber可以是普通数字,也可以是bn.jsstatus这是其中之一good, (中文(简体) ),revokedinfo应该是空的good对象revoked(见上文实例);revocationReason这是:unspecified, (中文(简体) ),keyCompromise, (中文(简体) ),CACompromise, (中文(简体) ),affiliationChanged, (中文(简体) ),superseded, (中文(简体) ),cessationOfOperation, (中文(简体) ),certificateHold, (中文(简体) ),removeFromCRL, (中文(简体) ),privelegeWithdrawn, (中文(简体) ),AACompromise(中文(简体) )
- 全体人员
http.Server办法!
构造器选项 :
cert: 服务器证书( PEM 或缓冲)key: 服务器的私钥( PEM 或缓冲)caCert: 签发的 CA 证书( PEM 或缓冲); 默认为certnextUpdate: 毫秒到nextUpdate响应中的字段(默认值 :8640000024小时)
检查()
用法 :
ocsp.check({
cert: cert,
issuer: issuerCert
}, (err, res) => {
if (err) throw err
console.log(res)
})
向 CA 发送 OCSP 请求并询问证书是否仍然有效 . res
包含信息.
选项 :
cert:要检查的证书( PEM、 DER 缓冲或解析)issuer: 签发的 CA 证书( PEM、 DER 缓冲或解析)requestByGet: 如果true,则通过 HTTP GET 发送OCSP 请求,而不是 POST( 默认 :false(中文(简体) )
.核实()
用法 :
ocsp.verify({
request: request,
// Optional, `issuer: issuerCert,`
response: response
}, (err, res) => {
})
校对 response 与 request 并由CA签名.
选项 :
request: OCSP请求对象(来自request.generate()(中文(简体) )response: 原始OCSP响应缓冲issuer: 签发 CA 证书, 如果尚未在request.issuernudge: 时钟可容忍度以毫秒表示thisUpdate编号 :nextUpdate检查( 默认 :60000(中文(简体) )
请求.generate ()
用法 :
const req = ocsp.request.generate(cert, issuerCert)
生成 OCSP 请求 .verify() 或者用于手动发送到OCSP服务器.
获取OCSPURI ()
用法 :
ocsp.getOCSPURI(cert, (err, uri) => {
})
从证书中获取 OCSP 服务器的 URI .
归属
最初作者: 费多尔 作为 废物/垃圾。 。 。 . 继续 技术小组, (中文(简体) ), 拉尼耶里·马齐利,以及 马特·西默森,包含来自GitHub分叉网络的修饰.
自由主义
这个软件根据麻省理工学院的许可证获得许可.
版权所有 Fedor Indutny, 2015.
特此免费准许任何人获得 本软件和相关文档文件的复制件 “软件”,在软件中不受限制地处理,包括 不限制使用、复制、修改、合并、出版、, 软件的分发、分版和/或销售,并允许 提供软件的人 下列条件:
上述版权通知和本许可通知应当包括: 软件的所有副本或大部分.
软件被提供"AS IS", 没有任何恐惧, EXPRESS ,包括但不局限于 紧迫性,特别是目的和非目的的证明。 内 对于任何索赔, 都不得使用任何连锁电话或警察电话, 转让或其他责任,以契约、条约或 产生于、出自或与溶剂有关的 在软件中使用或其他交易.