RTCCertificate, RTCPeerConnection.generateCertificate (WebRTC JavaScript) added.

third_party/WebKit/public/platform/WebRTCCertificateGenerator.h

 /*
  * Copyright (C) 2015 Google Inc. All rights reserved.
- * Copyright (C) 2015 Intel Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
  * copyright notice, this list of conditions and the following disclaimer
  * in the documentation and/or other materials provided with the
  * distribution.
  *     * Neither the name of Google Inc. nor the names of its
  * contributors may be used to endorse or promote products derived from
  * this software without specific prior written permission.
  *
  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-#ifndef PerformanceRenderTiming_h
-#define PerformanceRenderTiming_h
+#ifndef WebRTCCertificateGenerator_h
+#define WebRTCCertificateGenerator_h
 
-#include "core/timing/PerformanceEntry.h"
-#include "platform/heap/Handle.h"
-#include "wtf/Forward.h"
-#include "wtf/text/WTFString.h"
+#include "public/platform/WebCallbacks.h"
+#include "public/platform/WebRTCCertificate.h"
+#include "public/platform/WebRTCKeyParams.h"
+#include "public/platform/WebURL.h"
 
 namespace blink {
 
-class Document;
+// Interface defining a class that can generate WebRTCCertificates asynchronously.
+class WebRTCCertificateGenerator {
+public:
+    virtual ~WebRTCCertificateGenerator() {}
 
-class PerformanceRenderTiming final : public PerformanceEntry {
-    DEFINE_WRAPPERTYPEINFO();
-public:
-    static PerformanceRenderTiming* create(Document* requestingDocument, unsigned sourceFrame, double startTime, double finishTime)
-    {
-        return new PerformanceRenderTiming(requestingDocument, sourceFrame, startTime, finishTime);
-    }
+    // Start generating a certificate asynchronously. Which thread invokes the
+    // |observer| when the operation completes is implementation-specific.

[Ryan Sleevi, 2015/10/10 04:04:48]

That seems like an _extremely_ dangerous API contract.

Making code multi-threaded like this is a huge cause of crashes and abuse. You
should make the contract very clear (that it's the same thread)

[hbos_chromium, 2015/10/14 13:00:50]

Good point, I'll say it must be the same thread.

+    virtual void generateCertificate(
+        const WebRTCKeyParams&,
+        const WebURL& /*url*/,

[Guido Urdaneta, 2015/10/08 11:13:03]

don't put the parameter names inside /**/ comments. 

[hbos_chromium, 2015/10/14 13:00:50]

Done.

+        const WebURL& /*firstPartyForCookies*/,
+        WebCallbacks<WebRTCCertificate*, void>* observer) = 0;
 
-    unsigned sourceFrame() const;
-
-    DECLARE_VIRTUAL_TRACE();
-
-private:
-    PerformanceRenderTiming(Document* requestingDocument, unsigned sourceFrame, double startTime, double finishTime);
-    ~PerformanceRenderTiming() override;
-
-    unsigned m_sourceFrame;
-    RefPtrWillBeMember<Document> m_requestingDocument;
+    // Determines if the parameters should be considered valid for certificate generation.
+    // For example, if the number of bits of some parameter is too small or too large we
+    // may want to reject it for security or performance reasons.
+    virtual bool isValidKeyParams(const WebRTCKeyParams&) = 0;
 };
 
 } // namespace blink
 
-#endif // PerformanceRenderTiming_h
+#endif // WebRTCCertificateGenerator_h