OLD | NEW |
1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 // Use the <code>chrome.enterprise.platformKeys</code> API to generate | 5 // Use the <code>chrome.enterprise.platformKeys</code> API to generate |
6 // hardware-backed keys and to install certificates for these keys. The | 6 // hardware-backed keys and to install certificates for these keys. The |
7 // certificates will be available to the platform and can, for example, be used | 7 // certificates will be available to the platform and can, for example, be used |
8 // for TLS authentication and network access. | 8 // for TLS authentication and network access. |
9 [platforms = ("chromeos")] | 9 [platforms = ("chromeos")] |
10 namespace enterprise.platformKeys { | 10 namespace enterprise.platformKeys { |
11 [nocompile, noinline_doc] dictionary Token { | 11 [nocompile, noinline_doc] dictionary Token { |
12 // Uniquely identifies this <code>Token</code>. | 12 // Uniquely identifies this <code>Token</code>. |
13 // <p>Static IDs are <code>"user"</code> and <code>"device"</code>, | 13 // <p>Static IDs are <code>"user"</code> and <code>"system"</code>, |
14 // referring to the platform's user-specific and the device-wide hardware | 14 // referring to the platform's user-specific and the system-wide hardware |
15 // token, respectively. Any other tokens (with other identifiers) might be | 15 // token, respectively. Any other tokens (with other identifiers) might be |
16 // returned by $(ref:enterprise.platformKeys.getTokens).</p> | 16 // returned by $(ref:enterprise.platformKeys.getTokens).</p> |
17 DOMString id; | 17 DOMString id; |
18 | 18 |
19 // Implements the WebCrypto's | 19 // Implements the WebCrypto's |
20 // <a href="http://www.w3.org/TR/WebCryptoAPI/#subtlecrypto-interface">Subtl
eCrypto</a> | 20 // <a href="http://www.w3.org/TR/WebCryptoAPI/#subtlecrypto-interface">Subtl
eCrypto</a> |
21 // interface. The cryptographic operations, including key generation, are | 21 // interface. The cryptographic operations, including key generation, are |
22 // hardware-backed. | 22 // hardware-backed. |
23 // <p>Only non-extractable RSASSA-PKCS1-V1_5 keys with | 23 // <p>Only non-extractable RSASSA-PKCS1-V1_5 keys with |
24 // <code>modulusLength</code> up to 2048 can be generated. Each key can be | 24 // <code>modulusLength</code> up to 2048 can be generated. Each key can be |
(...skipping 15 matching lines...) Expand all Loading... |
40 // certificate. | 40 // certificate. |
41 callback GetCertificatesCallback = void(ArrayBuffer[] certificates); | 41 callback GetCertificatesCallback = void(ArrayBuffer[] certificates); |
42 | 42 |
43 // Invoked by importCertificate or removeCertificate when the respective | 43 // Invoked by importCertificate or removeCertificate when the respective |
44 // operation is finished. | 44 // operation is finished. |
45 callback DoneCallback = void(); | 45 callback DoneCallback = void(); |
46 | 46 |
47 interface Functions { | 47 interface Functions { |
48 // Returns the available Tokens. In a regular user's session the list will | 48 // Returns the available Tokens. In a regular user's session the list will |
49 // always contain the user's token with <code>id</code> <code>"user"</code>. | 49 // always contain the user's token with <code>id</code> <code>"user"</code>. |
50 // If a device-wide TPM token is available it will also contain the | 50 // If a system-wide TPM token is available, the returned list will also |
51 // device-wide token with <code>id</code> <code>"device"</code>. The | 51 // contain the system-wide token with <code>id</code> <code>"system"</code>. |
52 // device-wide token will be the same for all sessions on this device | 52 // The system-wide token will be the same for all sessions on this device |
53 // (device in the sense of e.g. a Chromebook). | 53 // (device in the sense of e.g. a Chromebook). |
54 [nocompile] static void getTokens(GetTokensCallback callback); | 54 [nocompile] static void getTokens(GetTokensCallback callback); |
55 | 55 |
56 // Returns the list of all client certificates available from the given | 56 // Returns the list of all client certificates available from the given |
57 // token. Can be used to check for the existence and expiration of client | 57 // token. Can be used to check for the existence and expiration of client |
58 // certificates that are usable for a certain authentication. | 58 // certificates that are usable for a certain authentication. |
59 // |tokenId|: The id of a Token returned by <code>getTokens</code>. | 59 // |tokenId|: The id of a Token returned by <code>getTokens</code>. |
60 // |callback|: Called back with the list of the available certificates. | 60 // |callback|: Called back with the list of the available certificates. |
61 static void getCertificates(DOMString tokenId, | 61 static void getCertificates(DOMString tokenId, |
62 GetCertificatesCallback callback); | 62 GetCertificatesCallback callback); |
(...skipping 15 matching lines...) Expand all Loading... |
78 // considered during authentication and do not clutter the certificate | 78 // considered during authentication and do not clutter the certificate |
79 // choice. Should be used to free storage in the certificate store. | 79 // choice. Should be used to free storage in the certificate store. |
80 // |tokenId|: The id of a Token returned by <code>getTokens</code>. | 80 // |tokenId|: The id of a Token returned by <code>getTokens</code>. |
81 // |certificate|: The DER encoding of a X.509 certificate. | 81 // |certificate|: The DER encoding of a X.509 certificate. |
82 // |callback|: Called back when this operation is finished. | 82 // |callback|: Called back when this operation is finished. |
83 static void removeCertificate(DOMString tokenId, | 83 static void removeCertificate(DOMString tokenId, |
84 ArrayBuffer certificate, | 84 ArrayBuffer certificate, |
85 optional DoneCallback callback); | 85 optional DoneCallback callback); |
86 }; | 86 }; |
87 }; | 87 }; |
OLD | NEW |