RTCPeerConnection: метод generateCertificate() статический

Статический метод generateCertificate() интерфейса RTCPeerConnection создаёт сертификат X.509 и соответствующий закрытый ключ, возвращая промис, который разрешается новым RTCCertificate, как только он будет сгенерирован.

keygenAlgorithm

Строка Web Crypto API AlgorithmIdentifier или объект, наследуемый от Algorithm, определяющий алгоритм, который будет использован при создании ключа сертификата.

Промис, который разрешается объектом нового RTCCertificate содержащего новый ключ на основе указанных опций.

NotSupportedError DOMException

Выбрасывается, если нормализованная форма keygenAlgorithm определяет алгоритм или параметры алгоритма, которые браузер не поддерживает или не разрешает использовать с RTCPeerConnection.

Могут возникнуть и другие ошибки; например, если указанный keygenAlgorithm не может быть успешно преобразован в словарь RTCCertificateExpiration, будет выброшена ошибка, возникшая во время этого преобразования.

Если указана строка, она должна быть строкой имени алгоритма, совместимого с Web Crypto API. В качестве альтернативы можно указать подробные сведения о конфигурации алгоритма, предоставив объект, базирующийся на одном из подклассов класса Algorithm Web Crypto API.

Все браузеры обязаны поддерживать следующие две конфигурации. Совершенно возможно, что стандартные настройки браузера могут отличаться, но эти конфигурации всегда поддерживаются.

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",
};

По умолчанию новый сертификат настроен с expires, установленным в значение 2592000000 миллисекунд или 30 дней. Срок действия не может превышать 31536000000 миллисекунд или 365 дней. Также полезно отметить, что браузеры могут дополнительно ограничить срок действия сертификатов по своему усмотрению.

В этом примере запрашивается новый сертификат RSASSA-PKCS1-v1_5 с использованием хеша SHA-256 и длиной модуля 2048.

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] });
});

В примере ниже указана строка, запрашивающая сертификат ECDSA.

RTCPeerConnection.generateCertificate("ECDSA");

• API WebRTC
• Web Crypto API
• Безопасность сайта
• Безопасность в сети Web
• Симметричное шифрование
• Crypto