CRLSet.js (英语)
CRLSet.js是TypeScript中用于Node.js的轻量级CRLSet解析器和验证器. 它获取并解析存储器中最新的 Chrome CRLSet, 支持检查证书或其签发者是否已被吊销 .
A 类 CRLSet 软件 是谷歌汇总的证书吊销信息的集合,被克罗姆用来快速识别并屏蔽被吊销的证书. 与传统的证书撤销列表(CRLs)或在线证书状态协议(OCSP)不同,CRLSets提供了快速有效的机制来检查证书的撤销状态.
这个库处理从Google的"Omaha"代理中取取最新CRLSet的过程,验证其签名以确保其完整性,解析,并可供撤销检查使用. 它被设计为易于嵌入到HTTPS代理或TLS验证流中. 虽然它为大多数使用案例提供了一个简单的一行函数,但它也输出其核心组件用于更先进的自定义执行.
安装
npm install @gldywn/crlset.js
基本用途
此库的主要功能是确定一个给定的证书是否根据最新的 CRLSet 被吊销. 这是通过对照CRLSet中的块列表来检查证书的发证人和序列号来实现的.
完整、可操作的例子见 实例/核实.ts。 。 。 .
console.log('Loading the latest CRLSet...');
/*
* By default, `loadLatestCRLSet` verifies the CRX signature, checks for a newer version,
* and downloads it if available. The latest version is cached to avoid redundant downloads.
* For customization:
* - `verifySignature: false`: Disables CRX signature verification (not recommended).
* - `updateStrategy: 'on-expiry'`: Updates only when the cached version hard-expires (not recommended).
* e.g. `await loadLatestCRLSet({ verifySignature: false, updateStrategy: 'on-expiry' })`
*/
const crlSet = await loadLatestCRLSet();
console.log(
`Successfully loaded CRLSet ${crlSet.sequence} (${crlSet.getBlockedSpkiCount()} blocked SPKIs, ${crlSet.getRevocationCount()} revocations).`,
);
const revokedBySerialInfo = {
spkiHash: '03b4392598a10a3ff5695cf02a5775586b170f564a808a4d41568578a184e329',
serialNumber: '179cc56dc82dbded5573c7999997f646',
};
console.log(
`\nChecking certificate with issuer SPKI hash: ${revokedBySerialInfo.spkiHash} and serial number: ${revokedBySerialInfo.serialNumber}...`,
);
const status = crlSet.check(revokedBySerialInfo.spkiHash, revokedBySerialInfo.serialNumber);
console.log(`Certificate revocation status: ${RevocationStatus[status]}`); // REVOKED_BY_SERIAL
// [...]
crlSet.check(revokedBySpkiInfo.spkiHash, notRevokedInfo.serialNumber); // REVOKED_BY_SPKI
crlSet.check(notRevokedInfo.spkiHash, notRevokedInfo.serialNumber); // OK
高级使用
对于更具体的用例,您可以使用 CRLSet 类和其他直接导出函数。 这使得您可以构建一个 CRLSet 实例来自自定义数据或利用库的内部力学为您自己的逻辑。 这样一来 crlset.js 用于处理CRLSets的多功能"瑞士陆军刀".
外观检查
虽然 check 如果需要区分不同的撤销理由,您也可以直接调用基本方法:
const isRevokedBySpki = crlSet.isRevokedBySPKI(certificateInfo.spkiHash);
console.log(`Is certificate revoked by SPKI?: ${isRevokedBySpki}`);
const isRevokedBySerial = crlSet.isRevokedBySerial(certificateInfo.spkiHash, certificateInfo.serialNumber);
console.log(`Is certificate revoked by serial?: ${isRevokedBySerial}`);
直接 CRLSet 证据
您可以创建 CRLSet 实例,如果您有标题和撤销数据.
import { CRLSet, RevocationStatus } from '@gldywn/crlset.js';
import type { CRLSetHeader } from '@gldywn/crlset.js';
// Define the header and revocation data
const header: CRLSetHeader = {
Sequence: 1,
NumParents: 1,
BlockedSPKIs: [],
NotAfter: Math.floor(Date.now() / 1000) + 3600, // Expires in 1 hour
ContentType: 'CRLSet',
DeltaFrom: 0,
};
const revocations = new Map<string, Set<string>>();
const spkiHash = 'a_spki_hash_in_hex';
const serials = new Set(['a_serial_number_in_hex']);
revocations.set(spkiHash, serials);
// Create a new CRLSet instance
const crlSet = new CRLSet(header, revocations);
// Use it as usual
const status = crlSet.check(spkiHash, 'a_serial_number_in_hex');
console.log(RevocationStatus[status]); // REVOKED_BY_SERIAL
导出的工具函数
库输出其大部分内部功能, 允许您构建自定义逻辑 :
fetchCrxUrl():从Google的Omaha代理服务器获取最新CRLSet CRX文件的下载URL.downloadLatestCRLSetCrx():下载完整的 CRLSet CRX 文件,并作为缓冲器返回.fetchRemoteHeader(): 执行部分下载,只取最新 CRLSet 的页眉,用于快速版本检查.unpackCrx(crxBuffer): 解析出一个原始的 CRX 文件缓冲器,将Protobuf头与主要ZIP内容相分离.processCrx(crxBuffer, verifySignature):一个高级函数,可以解开一个 CRX 文件,可选地验证其签名,并解析包含的 CRLSet 数据.parseCRLSet(crlSetBuffer): 解析二进制 CRLSet 数据(crl-set从 ZIP 中生成一个结构化标题和一个撤销地图.parseCRLSetHeader(crlSetBuffer):一个轻量级解析器,只读取从CRLSet数据得到的JSON头.verifyCrxSignature(crxHeader, zipBuffer):验证CRX文件在标题中针对公钥的签名.
测试
该项目包括一个综合测试套件,以确保正确性和稳定性.
运行测试
要运行完整的测试套件 :
npm test
许可证
CRLSet.js根据麻省理工学院的许可证进行发售.