RTCPeerConnection: generateCertificate() statische Methode

keygenAlgorithm

Ein Web Crypto API AlgorithmIdentifier-String oder ein Algorithm-unterklassiertes Objekt, das einen Algorithmus angibt, der bei der Erstellung des Schlüssels für das Zertifikat verwendet werden soll.

Note: generateCertificate() ist eine statische Methode und wird daher immer auf das RTCPeerConnection-Interface selbst aufgerufen, nicht auf eine Instanz davon.

Ein Promise, das auf ein neues RTCCertificate-Objekt auflöst, das einen neuen Schlüssel basierend auf den angegebenen Optionen enthält.

NotSupportedError DOMException

Wird ausgelöst, wenn die normalisierte Form von keygenAlgorithm einen Algorithmus oder Algorithmenparameter spezifiziert, die der Browser nicht unterstützt oder deren Verwendung mit einer RTCPeerConnection nicht erlaubt ist.

Andere Fehler können auftreten; zum Beispiel, wenn das angegebene keygenAlgorithm nicht erfolgreich in ein RTCCertificateExpiration-Wörterbuch umgewandelt werden kann, wird der während dieser Umwandlung auftretende Fehler ausgelöst.

Wenn ein String angegeben wird, muss es sich um einen mit der Web Crypto API kompatiblen Algorithmusnamen-String handeln. Alternativ können Sie bestimmte Details zur Konfiguration des Algorithmus angeben, indem Sie ein Objekt basierend auf einer der Unterklassen der Algorithm-Klasse der Web Crypto API bereitstellen.

Alle Browser müssen die folgenden zwei Konfigurationen unterstützen. Es ist völlig möglich, dass die Standard-Einstellungen eines Browsers unterschiedlich sind, aber diese werden immer unterstützt.

RSASSA-PKCS1-v1_5

let stdRSACertificate = {
  name: "RSASSA-PKCS1-v1_5",
  modulusLength: 2048,
  publicExponent: new Uint8Array([1, 0, 1]),
  hash: "SHA-256",
};

ECDSA

let stdECDSACertificate = {
  name: "ECDSA",
  namedCurve: "P-256",
};

Standardmäßig wird das neue Zertifikat mit einem expires-Wert von 2592000000 Millisekunden oder 30 Tagen konfiguriert. Die Ablaufzeit darf 31536000000 Millisekunden oder 365 Tage nicht überschreiten. Es ist auch nützlich zu wissen, dass Browser die Ablaufzeit von Zertifikaten weiter einschränken können, wenn sie dies wünschen.

Dieses Beispiel fordert ein neues RSASSA-PKCS1-v1_5-Zertifikat mit einem SHA-256-Hash und einer Moduluslänge von 2048 an.

RTCPeerConnection.generateCertificate({
  name: "RSASSA-PKCS1-v1_5",
  hash: "SHA-256",
  modulusLength: 2048,
  publicExponent: new Uint8Array([1, 0, 1]),
}).then((cert) => {
  const pc = new RTCPeerConnection({ certificates: [cert] });
});

Das folgende Beispiel gibt einen String an, der ein ECDSA-Zertifikat anfordert.

RTCPeerConnection.generateCertificate("ECDSA");

• WebRTC API
• Web Crypto API
• Website-Sicherheit
• Web-Sicherheit
• Symmetrische Kryptographie
• Crypto