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 berichten, das von einem RTCDtlsTransport und dessen zugrundeliegendem RTCIceTransport genutzt wird.
Der Bericht kann erhalten werden, indem der RTCStatsReport durchlaufen wird, welcher von RTCPeerConnection.getStats() zurückgegeben wird, bis Sie einen Eintrag mit dem type certificate finden.
Instanz-Eigenschaften
base64Certificate-
Ein String, der die Base-64-Darstellung des DER-kodierten Zertifikats enthält.
fingerprint-
Ein String, der den Zertifikat-Fingerprint enthält, welcher mit der in
fingerprintAlgorithmangegebenen Hash-Funktion berechnet wird. fingerprintAlgorithm-
Ein String, der die Hash-Funktion enthält, die verwendet wird, um den Zertifikats-
fingerprintzu berechnen, wie zum Beispiel "sha-256". issuerCertificateId-
Ein String, der die
iddesRTCCertificateStatsObjekts in diesem Bericht enthält, welches das nächste Zertifikat in der Zertifikatskette enthält. Dies wird nicht gesetzt, wenn das aktuelle Zertifikat ein selbstsigniertes Zertifikat oder das Ende der Zertifikatskette (ein Stammzertifikat) ist.
Allgemeine Instanz-Eigenschaften
Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam (Weitere Informationen finden Sie unter RTCStatsReport).
id-
Ein String, der das Objekt, das überwacht wird, eindeutig identifiziert, um diesen Satz von Statistiken zu erzeugen.
timestamp-
Ein
DOMHighResTimeStampObjekt, das angibt, zu welchem Zeitpunkt die Stichprobe für dieses Statistikobjekt genommen wurde. type-
Ein String mit dem Wert
"certificate", der den Typ der Statistiken angibt, die das Objekt enthält.
Beispiele
Grundlegende Verwendung
Angenommen, myPeerConnection ist eine Instanz von RTCPeerConnection, verwendet der nachstehende Code await, um auf den Statistikbericht zu warten, und durchläuft diesen dann mit RTCStatsReport.forEach().
Anschließend werden die Wörterbücher gefiltert, um nur jene Berichte herauszufiltern, die den Typ certificate haben, und das Ergebnis wird protokolliert.
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 |