| 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 |