RTCPeerConnection: generateCertificate() statische Methode

keygenAlgorithm

Ein Web Crypto API AlgorithmIdentifier-String oder ein Algorithm-subklassiertes Objekt, das einen Algorithmus spezifiziert, der für die Erstellung des Zertifikatschlüssels verwendet werden soll.

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

Ein Promise, das zu einem neuen RTCCertificate-Objekt mit einem neuen Schlüssel, basierend auf den angegebenen Optionen, aufgelöst wird.

NotSupportedError DOMException

Wird ausgelöst, wenn die normalisierte Form von keygenAlgorithm einen Algorithmus oder Algorithmen-Einstellungen spezifiziert, die der Browser nicht unterstützt oder deren Verwendung er in Verbindung mit einer RTCPeerConnection nicht erlaubt.

Es können weitere Fehler auftreten; beispielsweise, wenn das angegebene keygenAlgorithm nicht erfolgreich in ein RTCCertificateExpiration-Dictionary umgewandelt werden kann, wird der Fehler ausgelöst, der während dieser Umwandlung auftritt.

Wenn ein String angegeben wird, muss es ein mit der Web Crypto API kompatibler Algorithmusname sein. Alternativ können Sie spezifische Details für die Konfiguration des Algorithmus angeben, indem Sie ein Objekt basierend auf einer der Unterklassen der Algorithm-Klasse der Web Crypto API bereitstellen.

Alle Browser sind verpflichtet, die folgenden zwei Konfigurationen zu unterstützen. Es ist völlig möglich, dass die Standard-Einstellungen eines Browsers abweichen, 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 expires auf einen Wert von 2592000000 Millisekunden, oder 30 Tagen, konfiguriert. Die Ablaufzeit darf 31536000000 Millisekunden, oder 365 Tage, nicht überschreiten. Es ist auch nützlich zu beachten, 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 spezifiziert einen String, der ein ECDSA-Zertifikat anfordert.

RTCPeerConnection.generateCertificate("ECDSA");

• WebRTC API
• Web Crypto API
• Website-Sicherheit
• Web-Sicherheit
• Symmetrische Verschlüsselung
• Crypto