RTCCertificateStats
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Das RTCCertificateStats Wörterbuch der WebRTC API wird verwendet, um Informationen über ein Zertifikat zu melden, das von einem RTCDtlsTransport und seinem zugrunde liegenden RTCIceTransport verwendet wird.
Der Bericht kann erhalten werden, indem man das RTCStatsReport durchläuft, das von RTCPeerConnection.getStats() zurückgegeben wird, bis Sie einen Eintrag mit dem type certificate finden.
Instanzeigenschaften
base64Certificate-
Ein String, der die base-64-Darstellung des DER-kodierten Zertifikats enthält.
fingerprint-
Ein String, der den Fingerabdruck des Zertifikats enthält, der mit der in
fingerprintAlgorithmangegebenen Hash-Funktion berechnet wird. fingerprintAlgorithm-
Ein String, der die Hash-Funktion enthält, die zur Berechnung des Zertifikats-
fingerprintverwendet wird, wie beispielsweise "sha-256". issuerCertificateId-
Ein String, der die
iddesRTCCertificateStats-Objekts in diesem Bericht enthält, das das nächste Zertifikat in der Zertifizierungskette enthält. Dieser Wert wird nicht gesetzt, wenn es sich bei dem aktuellen Zertifikat um ein selbstsigniertes Zertifikat handelt oder um das Ende der Zertifizierungskette (ein Stammzertifikat).
Allgemeine Instanzeigenschaften
Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam (siehe RTCStatsReport für mehr Informationen).
id-
Ein String, der das Objekt eindeutig identifiziert, das überwacht wird, um diesen Satz von Statistiken zu erzeugen.
timestamp-
Ein
DOMHighResTimeStamp-Objekt, das angibt, zu welchem Zeitpunkt die Probe für dieses Statistikobjekt genommen wurde. type-
Ein String mit dem Wert
"certificate", der den Typ der Statistiken angibt, den das Objekt enthält.
Beispiele
Grundlegende Verwendung
Angenommen, Sie haben eine Variable myPeerConnection, die eine Instanz von RTCPeerConnection ist. Der untenstehende Code verwendet await, um auf den Statistikbericht zu warten und durchläuft diesen dann mit RTCStatsReport.forEach().
Er filtert dann die Wörterbücher nur für die Berichte heraus, die den Typ certificate haben, und protokolliert das Ergebnis.
const stats = await myPeerConnection.getStats();
stats.forEach((report) => {
if (report.type === "certificate") {
// Log the certificate information
console.log(report);
}
});
Spezifikationen
| Spezifikation |
|---|
| Identifiers for WebRTC's Statistics API # dom-rtcstatstype-certificate |