OLD | NEW |
1 // Copyright 2015 The Chromium Authors. All rights reserved. | 1 // Copyright 2015 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 // Internal API for to implement the platformKeys and enterprise.platformKeys | 5 // Internal API for to implement the platformKeys and enterprise.platformKeys |
6 // APIs. | 6 // APIs. |
7 [ implemented_in = "chrome/browser/extensions/api/platform_keys/platform_keys_ap
i.h" ] | 7 [ implemented_in = "chrome/browser/extensions/api/platform_keys/platform_keys_ap
i.h" ] |
8 namespace platformKeysInternal { | 8 namespace platformKeysInternal { |
9 callback SelectCallback = void (platformKeys.Match[] certs); | 9 callback SelectCallback = void (platformKeys.Match[] certs); |
10 | 10 |
11 // Invoked by <code>sign</code>. | 11 // Invoked by <code>sign</code>. |
12 // |signature| The signature, a octet string. | 12 // |signature| The signature, a octet string. |
13 callback SignCallback = void(ArrayBuffer signature); | 13 callback SignCallback = void(ArrayBuffer signature); |
14 | 14 |
15 // Called back by <code>getPublicKey</code>. | |
16 // |publicKey| The Subject Public Key Info (see X.509) of the requested | |
17 // certificate. | |
18 // |algorithm| A partial WebCrypto KeyAlgorithm containing all information | |
19 // that is available from the Subject Public Key Info. It does not contain | |
20 // signature/hash parameters. | |
21 callback GetPublicKeyCallback = void(ArrayBuffer publicKey, object algorithm); | |
22 | |
23 interface Functions { | 15 interface Functions { |
24 // See documentation in platformKeys. | 16 // See documentation in platformKeys. |
25 static void selectClientCertificates( | 17 static void selectClientCertificates( |
26 platformKeys.SelectDetails details, | 18 platformKeys.SelectDetails details, |
27 SelectCallback callback); | 19 SelectCallback callback); |
28 | 20 |
29 // Internal version of platformKeys.subtleCrypto.sign and | 21 // Internal version of platformKeys.subtleCrypto.sign and |
30 // enterprise.platformKeys.Token.subtleCrypto.sign. | 22 // enterprise.platformKeys.Token.subtleCrypto.sign. |
31 // |tokenId| The id of a Token returned by |getTokens|. | 23 // |tokenId| The id of a Token returned by |getTokens|. |
32 // |publicKey| The Subject Public Key Info of a key previously generated by | 24 // |publicKey| The Subject Public Key Info of a key previously generated by |
33 // |generateKey| in DER encoding. | 25 // |generateKey| in DER encoding. |
34 // |hashAlgorithmName| The recognized algorithm name of the hash algorithm, | 26 // |hashAlgorithmName| The recognized algorithm name as specified by |
35 // as specified by WebCrypto, that will be used to digest |data| | 27 // WebCrypto of the hash algorithm that will be used to digest |data| |
36 // before signing. Currently supported are: SHA-{1,256,384,512}. | 28 // before signing. Currently supported are: SHA-{1,256,384,512}. |
37 // If instead the algorithm name "none" is provided, no hashing will be | |
38 // applied, the data is PKCS#1 v1.5 padded but not hashed. | |
39 // TODO(pneubeck): use an enum once supported: | 29 // TODO(pneubeck): use an enum once supported: |
40 // http://www.crbug.com/385539 . | 30 // http://www.crbug.com/385539 . |
41 // |data| The data to sign. | 31 // |data| The data to sign. |
42 // |callback| Called back with the signature of |data|. | 32 // |callback| Called back with the signature of |data|. |
43 // TODO: Instead of ArrayBuffer should be (ArrayBuffer or ArrayBufferView), | 33 // TODO: Instead of ArrayBuffer should be (ArrayBuffer or ArrayBufferView), |
44 // or at least (ArrayBuffer or Uint8Array). | 34 // or at least (ArrayBuffer or Uint8Array). |
45 static void sign(DOMString tokenId, | 35 static void sign(DOMString tokenId, |
46 ArrayBuffer publicKey, | 36 ArrayBuffer publicKey, |
47 DOMString hashAlgorithmName, | 37 DOMString hashAlgorithmName, |
48 ArrayBuffer data, | 38 ArrayBuffer data, |
49 SignCallback callback); | 39 SignCallback callback); |
50 | |
51 // Calls back <code>callback</code> with details about the key certified by | |
52 // <code>certificate</code>. | |
53 static void getPublicKey(ArrayBuffer certificate, | |
54 GetPublicKeyCallback callback); | |
55 }; | 40 }; |
56 }; | 41 }; |
OLD | NEW |