RTCPeerConnection.generateCertificate()

This article needs a technical review. How you can help.

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.

The generateCertificate() method of the RTCPeerConnection interface creates and stores an X.509 certificate and corresponding private key then returns an RTCCertificate, providing access to it.

SyntaxEdit

var cert = RTCPeerConnection.generateCertificate(keygenAlgorithm)

Parameters

keygenAlgorithm
A DOMString identifying the algorithm to use in creating the key.

RTCPeerConnection.generateCertificate() is a static method, so it is always called on the RTCPeerConnection interface itself, not an instance thereof.

Return value

A reference to an RTCCertificate object.

Example

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

SpecificationsEdit

Specification Status Comment
WebRTC 1.0: Real-time Communication Between Browser
The definition of 'generateCertificate()' in that specification.
Working Draft Initial definition.

Browser compatibilityEdit

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 48.0 [1] 42 (42) ? ? ?

[1] Behind a flag.

See alsoEdit

Document Tags and Contributors

 Contributors to this page: Sheppy, rolfedh, benbro, jpmedley
 Last updated by: Sheppy,