| Index: content/child/webcrypto/algorithm_implementation.h
|
| diff --git a/content/child/webcrypto/algorithm_implementation.h b/content/child/webcrypto/algorithm_implementation.h
|
| deleted file mode 100644
|
| index d1fb28232b7d53c8637dd5ffca99abf04c1fa193..0000000000000000000000000000000000000000
|
| --- a/content/child/webcrypto/algorithm_implementation.h
|
| +++ /dev/null
|
| @@ -1,226 +0,0 @@
|
| -// 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.
|
| -
|
| -#ifndef CONTENT_CHILD_WEBCRYPTO_ALGORITHM_IMPLEMENTATION_H_
|
| -#define CONTENT_CHILD_WEBCRYPTO_ALGORITHM_IMPLEMENTATION_H_
|
| -
|
| -#include <stdint.h>
|
| -#include <vector>
|
| -
|
| -#include "base/memory/scoped_ptr.h"
|
| -#include "third_party/WebKit/public/platform/WebCrypto.h"
|
| -
|
| -namespace content {
|
| -
|
| -namespace webcrypto {
|
| -
|
| -class CryptoData;
|
| -class GenerateKeyResult;
|
| -class Status;
|
| -
|
| -// AlgorithmImplementation is a base class for *executing* the operations of an
|
| -// algorithm (generating keys, encrypting, signing, etc.).
|
| -//
|
| -// This is in contrast to blink::WebCryptoAlgorithm which instead *describes*
|
| -// the operation and its parameters.
|
| -//
|
| -// AlgorithmImplementation has reasonable default implementations for all
|
| -// methods which behave as if the operation is it is unsupported, so
|
| -// implementations need only override the applicable methods.
|
| -//
|
| -// Unless stated otherwise methods of AlgorithmImplementation are responsible
|
| -// for sanitizing their inputs. The following can be assumed:
|
| -//
|
| -// * |algorithm.id()| and |key.algorithm.id()| matches the algorithm under
|
| -// which the implementation was registerd.
|
| -// * |algorithm| has the correct parameters type for the operation.
|
| -// * The key usages have already been verified. In fact in the case of calls
|
| -// to Encrypt()/Decrypt() the corresponding key usages may not be present
|
| -// (when wrapping/unwrapping).
|
| -class AlgorithmImplementation {
|
| - public:
|
| - virtual ~AlgorithmImplementation();
|
| -
|
| - // This method corresponds to Web Crypto's crypto.subtle.encrypt().
|
| - virtual Status Encrypt(const blink::WebCryptoAlgorithm& algorithm,
|
| - const blink::WebCryptoKey& key,
|
| - const CryptoData& data,
|
| - std::vector<uint8_t>* buffer) const;
|
| -
|
| - // This method corresponds to Web Crypto's crypto.subtle.decrypt().
|
| - virtual Status Decrypt(const blink::WebCryptoAlgorithm& algorithm,
|
| - const blink::WebCryptoKey& key,
|
| - const CryptoData& data,
|
| - std::vector<uint8_t>* buffer) const;
|
| -
|
| - // This method corresponds to Web Crypto's crypto.subtle.sign().
|
| - virtual Status Sign(const blink::WebCryptoAlgorithm& algorithm,
|
| - const blink::WebCryptoKey& key,
|
| - const CryptoData& data,
|
| - std::vector<uint8_t>* buffer) const;
|
| -
|
| - // This method corresponds to Web Crypto's crypto.subtle.verify().
|
| - virtual Status Verify(const blink::WebCryptoAlgorithm& algorithm,
|
| - const blink::WebCryptoKey& key,
|
| - const CryptoData& signature,
|
| - const CryptoData& data,
|
| - bool* signature_match) const;
|
| -
|
| - // This method corresponds to Web Crypto's crypto.subtle.digest().
|
| - virtual Status Digest(const blink::WebCryptoAlgorithm& algorithm,
|
| - const CryptoData& data,
|
| - std::vector<uint8_t>* buffer) const;
|
| -
|
| - // This method corresponds to Web Crypto's crypto.subtle.generateKey().
|
| - //
|
| - // Implementations MUST verify |usages| and return an error if it is not
|
| - // appropriate.
|
| - virtual Status GenerateKey(const blink::WebCryptoAlgorithm& algorithm,
|
| - bool extractable,
|
| - blink::WebCryptoKeyUsageMask usages,
|
| - GenerateKeyResult* result) const;
|
| -
|
| - // This method corresponds to Web Crypto's "derive bits" operation. It is
|
| - // essentially crypto.subtle.deriveBits() with the exception that the length
|
| - // can be "null" (|has_length_bits = true|).
|
| - //
|
| - // In cases where the length was not specified, an appropriate default for the
|
| - // algorithm should be used (as described by the spec).
|
| - virtual Status DeriveBits(const blink::WebCryptoAlgorithm& algorithm,
|
| - const blink::WebCryptoKey& base_key,
|
| - bool has_optional_length_bits,
|
| - unsigned int optional_length_bits,
|
| - std::vector<uint8_t>* derived_bytes) const;
|
| -
|
| - // This method corresponds with Web Crypto's "Get key length" operation.
|
| - //
|
| - // In the Web Crypto spec the operation returns either "null" or an
|
| - // "Integer". In this code "null" is represented by setting
|
| - // |*has_length_bits = false|.
|
| - virtual Status GetKeyLength(
|
| - const blink::WebCryptoAlgorithm& key_length_algorithm,
|
| - bool* has_length_bits,
|
| - unsigned int* length_bits) const;
|
| -
|
| - // -----------------------------------------------
|
| - // Key import
|
| - // -----------------------------------------------
|
| -
|
| - // VerifyKeyUsagesBeforeImportKey() must be called before either
|
| - // importing a key, or unwrapping a key.
|
| - //
|
| - // Implementations should return an error if the requested usages are invalid
|
| - // when importing for the specified format.
|
| - //
|
| - // For instance, importing an RSA-SSA key with 'spki' format and Sign usage
|
| - // is invalid. The 'spki' format implies it will be a public key, and public
|
| - // keys do not support signing.
|
| - //
|
| - // When called with format=JWK the key type may be unknown. The
|
| - // ImportKeyJwk() must do the final usage check.
|
| - virtual Status VerifyKeyUsagesBeforeImportKey(
|
| - blink::WebCryptoKeyFormat format,
|
| - blink::WebCryptoKeyUsageMask usages) const;
|
| -
|
| - // Dispatches to the format-specific ImportKey* method.
|
| - Status ImportKey(blink::WebCryptoKeyFormat format,
|
| - const CryptoData& key_data,
|
| - const blink::WebCryptoAlgorithm& algorithm,
|
| - bool extractable,
|
| - blink::WebCryptoKeyUsageMask usages,
|
| - blink::WebCryptoKey* key) const;
|
| -
|
| - // This method corresponds to Web Crypto's
|
| - // crypto.subtle.importKey(format='raw').
|
| - virtual Status ImportKeyRaw(const CryptoData& key_data,
|
| - const blink::WebCryptoAlgorithm& algorithm,
|
| - bool extractable,
|
| - blink::WebCryptoKeyUsageMask usages,
|
| - blink::WebCryptoKey* key) const;
|
| -
|
| - // This method corresponds to Web Crypto's
|
| - // crypto.subtle.importKey(format='pkcs8').
|
| - virtual Status ImportKeyPkcs8(const CryptoData& key_data,
|
| - const blink::WebCryptoAlgorithm& algorithm,
|
| - bool extractable,
|
| - blink::WebCryptoKeyUsageMask usages,
|
| - blink::WebCryptoKey* key) const;
|
| -
|
| - // This method corresponds to Web Crypto's
|
| - // crypto.subtle.importKey(format='spki').
|
| - virtual Status ImportKeySpki(const CryptoData& key_data,
|
| - const blink::WebCryptoAlgorithm& algorithm,
|
| - bool extractable,
|
| - blink::WebCryptoKeyUsageMask usages,
|
| - blink::WebCryptoKey* key) const;
|
| -
|
| - // This method corresponds to Web Crypto's
|
| - // crypto.subtle.importKey(format='jwk').
|
| - virtual Status ImportKeyJwk(const CryptoData& key_data,
|
| - const blink::WebCryptoAlgorithm& algorithm,
|
| - bool extractable,
|
| - blink::WebCryptoKeyUsageMask usages,
|
| - blink::WebCryptoKey* key) const;
|
| -
|
| - // -----------------------------------------------
|
| - // Key export
|
| - // -----------------------------------------------
|
| -
|
| - // Dispatches to the format-specific ExportKey* method.
|
| - Status ExportKey(blink::WebCryptoKeyFormat format,
|
| - const blink::WebCryptoKey& key,
|
| - std::vector<uint8_t>* buffer) const;
|
| -
|
| - virtual Status ExportKeyRaw(const blink::WebCryptoKey& key,
|
| - std::vector<uint8_t>* buffer) const;
|
| -
|
| - virtual Status ExportKeyPkcs8(const blink::WebCryptoKey& key,
|
| - std::vector<uint8_t>* buffer) const;
|
| -
|
| - virtual Status ExportKeySpki(const blink::WebCryptoKey& key,
|
| - std::vector<uint8_t>* buffer) const;
|
| -
|
| - virtual Status ExportKeyJwk(const blink::WebCryptoKey& key,
|
| - std::vector<uint8_t>* buffer) const;
|
| -
|
| - // -----------------------------------------------
|
| - // Structured clone
|
| - // -----------------------------------------------
|
| -
|
| - // The Structured clone methods are used for synchronous serialization /
|
| - // deserialization of a WebCryptoKey.
|
| - //
|
| - // This serialized format is used by Blink to:
|
| - // * Copy WebCryptoKeys between threads (postMessage to WebWorkers)
|
| - // * Copy WebCryptoKeys between domains (postMessage)
|
| - // * Copy WebCryptoKeys within the same domain (postMessage)
|
| - // * Persist the key to storage (IndexedDB)
|
| - //
|
| - // Implementations of structured cloning must:
|
| - // * Be threadsafe (structured cloning is called directly on the Blink
|
| - // thread, in contrast to the other methods of AlgorithmImplementation).
|
| - // * Use a stable format (a serialized key must forever be de-serializable,
|
| - // and be able to survive future migrations to crypto libraries)
|
| - // * Work for all keys (including ones marked as non-extractable).
|
| - //
|
| - // Tests to verify structured cloning are available in:
|
| - // LayoutTests/crypto/clone-*.html
|
| - virtual Status SerializeKeyForClone(
|
| - const blink::WebCryptoKey& key,
|
| - blink::WebVector<uint8_t>* key_data) const;
|
| -
|
| - virtual Status DeserializeKeyForClone(
|
| - const blink::WebCryptoKeyAlgorithm& algorithm,
|
| - blink::WebCryptoKeyType type,
|
| - bool extractable,
|
| - blink::WebCryptoKeyUsageMask usages,
|
| - const CryptoData& key_data,
|
| - blink::WebCryptoKey* key) const;
|
| -};
|
| -
|
| -} // namespace webcrypto
|
| -
|
| -} // namespace content
|
| -
|
| -#endif // CONTENT_CHILD_WEBCRYPTO_ALGORITHM_IMPLEMENTATION_H_
|
|
|