Extension API enterprise.platformKeys.

chrome/common/extensions/api/enterprise_platform_keys.json

+// Copyright 2014 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+[{

[not at google - send to devlin, 2014/05/02 18:31:56]

why is this JSON while the other is IDL?

[pneubeck (no reviews), 2014/05/05 20:09:35]

I preferred IDL over JSON. However, I feared that our IDL parser doesn't provide
some features that I might need...

Happy to change this to IDL as well, if JSON isn't necessary.

+  "namespace" : "enterprise.platformKeys",
+  "description" : "none",
+  "platforms" : ["chromeos"],
+  "types" :[
+    {
+      "id" : "Token",
+      "type" : "object",
+      "properties" : {
+        "id" : {"type" : "string"},
+        "subtleCrypto" : {
+          "$ref" : "SubtleCrypto",
+          "description" : "SubtleCrypto backed by platform's TPM",
+          "nocompile" : true
+        }
+      }
+    },
+    {
+      "id" : "SubtleCrypto",

[not at google - send to devlin, 2014/05/02 18:31:56]

SubtleCrypto is something that's supposed to be defined in a standard somewhere?
if you're going to mimic the interface then you might want to "nodoc" this and
point to the spec.

might :) up to yuo.

[pneubeck (no reviews), 2014/05/05 20:09:35]

Is there a canonical way to declare this as a reference to an external type
(WebCrypto's in this case)?

Changed to nodoc for now. I might still declare the methods that I actually
implement and describe the additional restrictions that apply.

[not at google - send to devlin, 2014/05/05 21:09:24]

isInstanceOf should do it, which in IDL is instanceOf:
https://code.google.com/p/chromium/codesearch#chromium/src/chrome/common/exte...

there isn't anything in here which looks unsupported by IDL.

+      "type" : "object",
+      "properties" : {
+        "generateKey" : {
+          "type" : "function",
+          "parameters" : [{
+            "name" : "algorithm",
+            "type" : "object",
+            "properties" : {}
+          }]
+        }
+      }
+    }
+  ],
+  "properties" : {},
+  "functions" :[
+    {
+      "name" : "getTokens",
+      "type" : "function",
+      "description" : "Gets all available Tokens.",
+      "nocompile" : true,
+      "parameters" : [{
+        "name" : "callback",
+        "type" : "function",
+        "description" : "Callback to which the available Tokens are passed.",
+        "parameters" : [{
+          "name" : "tokens",
+          "type" : "array",
+          "items" : {"$ref" : "Token"}
+        }]
+      }]
+    },
+    {
+      "name" : "getCertificates",
+      "type" : "function",
+      "description" : "Gets all certificates of the provided token.",
+      "parameters" :[
+        {"name" : "tokenId", "type" : "string"},
+        {
+          "name" : "callback",
+          "type" : "function",
+          "description" : "Callback to which the certificates are passed.",
+          "parameters" : [{
+            "name" : "certificates",
+            "type" : "array",
+            "items" :
+                {"type" : "binary", "isInstanceOf" : "ArrayBuffer"}
+          }]
+        }
+      ]
+    },
+    {
+      "name" : "importCertificate",
+      "type" : "function",
+      "description" : "Import a certificate",
+      "parameters" :[
+        {"name" : "tokenId", "type" : "string"},
+        {
+          "name" : "certificate",
+          "type" : "binary",
+          "isInstanceOf" : "ArrayBuffer"
+        },
+        {
+          "name" : "callback",
+          "type" : "function",
+          "description" : "Called when the import is done.",
+          "optional" : true,
+          "parameters" : []
+        }
+      ]
+    },
+    {
+      "name" : "removeCertificate",
+      "type" : "function",
+      "description" : "Remove a certificate",
+      "parameters" :[
+        {"name" : "tokenId", "type" : "string"},
+        {
+          "name" : "certificate",
+          "type" : "binary",
+          "isInstanceOf" : "ArrayBuffer"
+        },
+        {
+          "name" : "callback",
+          "type" : "function",
+          "description" : "Called when the removal is done.",
+          "optional" : true,
+          "parameters" : []
+        }
+      ]
+    }
+  ]
+}]