From 6f3b7e2b7ac173336981f4c1fa3dedb0cd32ba19 Mon Sep 17 00:00:00 2001
From: Bernard Aboba <bernard.aboba@gmail.com>
Date: Wed, 14 Mar 2018 11:15:29 -0700
Subject: [PATCH] Handling of KeyingMaterial internal slot

Rebase of https://github.com/w3c/webrtc-pc/pull/1723

Clarification for Issues https://github.com/w3c/webrtc-pc/issues/1694 and https://github.com/w3c/webrtc-pc/issues/1739

See also #1089
---
 webrtc.html | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/webrtc.html b/webrtc.html
index 44ba138e4..79e671cbb 100644
--- a/webrtc.html
+++ b/webrtc.html
@@ -4672,14 +4672,18 @@ <h2>Methods</h2>
           </section>
         </div>
         <p>For the purposes of this API, the <a>[[\Certificate]]</a> slot
-        contains unstructured binary data.</p>
-        <p>Note that an <code>RTCCertificate</code> might not directly hold
-        private keying material, this might be stored in a secure module.</p>
-        <p>The <code>RTCCertificate</code> object can be stored and retrieved
-        from persistent storage by an application. When a <a>user agent</a> is
-        required to obtain a structured clone [[!HTML51]] of an
-        <code>RTCCertificate</code> object, it performs the following
-        steps:</p>
+        contains unstructured binary data. No mechanism is provided for
+        applications to access the <a>[[\KeyingMaterial]]</a> internal slot.
+        Implementations MUST support applications storing and retrieving
+        <code>RTCCertificate</code> objects from persistent storage.
+        In implementations where an <code>RTCCertificate</code> might not
+        directly hold private keying material (it might be stored in a
+        secure module), a reference to the private key can be held in
+        the <a>[[\KeyingMaterial]]</a> internal slot, allowing the
+        private key to be stored and used.</p>
+        <p>When a <a>user agent</a> is required to obtain a structured
+        clone [[!HTML51]] of an <code>RTCCertificate</code> object,
+        it performs the following steps:</p>
         <ol>
           <li>Let <var>input</var> and <var>memory</var> be the corresponding
           inputs defined by the internal structured cloning algorithm, where