gecko-dev/dom/base/SubtleCrypto.h
Javier Fernández García-Boente 83c38a9417 Bug 1793429 - Make the deriveBits's length argument Nullable r=keeler,webidl,smaug
The PR#345 [1] of the WebCrypto API specification changed the type
of the deriveBits's length argument to become 'optional' and with
'null' as default value.

The affected WebCrypto algorithms (HKDF, PBKDF2, ECDH and X25519)
will be adapted to handle the case of a null length properly.

[1] https://github.com/w3c/webcrypto/pull/345

Differential Revision: https://phabricator.services.mozilla.com/D217532
2024-08-07 09:17:48 +00:00

112 lines
4.6 KiB
C++

/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef mozilla_dom_SubtleCrypto_h
#define mozilla_dom_SubtleCrypto_h
#include "nsCycleCollectionParticipant.h"
#include "nsWrapperCache.h"
#include "nsIGlobalObject.h"
#include "mozilla/dom/CryptoKey.h"
#include "js/TypeDecls.h"
namespace mozilla::dom {
class ObjectOrString;
class Promise;
typedef ArrayBufferViewOrArrayBuffer CryptoOperationData;
class SubtleCrypto final : public nsISupports, public nsWrapperCache {
~SubtleCrypto() = default;
public:
NS_DECL_CYCLE_COLLECTING_ISUPPORTS
NS_DECL_CYCLE_COLLECTION_WRAPPERCACHE_CLASS(SubtleCrypto)
public:
explicit SubtleCrypto(nsIGlobalObject* aParent);
nsIGlobalObject* GetParentObject() const { return mParent; }
virtual JSObject* WrapObject(JSContext* aCx,
JS::Handle<JSObject*> aGivenProto) override;
already_AddRefed<Promise> Encrypt(JSContext* cx,
const ObjectOrString& algorithm,
CryptoKey& key,
const CryptoOperationData& data,
ErrorResult& aRv);
already_AddRefed<Promise> Decrypt(JSContext* cx,
const ObjectOrString& algorithm,
CryptoKey& key,
const CryptoOperationData& data,
ErrorResult& aRv);
already_AddRefed<Promise> Sign(JSContext* cx, const ObjectOrString& algorithm,
CryptoKey& key,
const CryptoOperationData& data,
ErrorResult& aRv);
already_AddRefed<Promise> Verify(JSContext* cx,
const ObjectOrString& algorithm,
CryptoKey& key,
const CryptoOperationData& signature,
const CryptoOperationData& data,
ErrorResult& aRv);
already_AddRefed<Promise> Digest(JSContext* cx,
const ObjectOrString& aAlgorithm,
const CryptoOperationData& aData,
ErrorResult& aRv);
already_AddRefed<Promise> ImportKey(JSContext* cx, const nsAString& format,
JS::Handle<JSObject*> keyData,
const ObjectOrString& algorithm,
bool extractable,
const Sequence<nsString>& keyUsages,
ErrorResult& aRv);
already_AddRefed<Promise> ExportKey(const nsAString& format, CryptoKey& key,
ErrorResult& aRv);
already_AddRefed<Promise> GenerateKey(JSContext* cx,
const ObjectOrString& algorithm,
bool extractable,
const Sequence<nsString>& keyUsages,
ErrorResult& aRv);
already_AddRefed<Promise> DeriveKey(
JSContext* cx, const ObjectOrString& algorithm, CryptoKey& baseKey,
const ObjectOrString& derivedKeyType, bool extractable,
const Sequence<nsString>& keyUsages, ErrorResult& aRv);
already_AddRefed<Promise> DeriveBits(JSContext* cx,
const ObjectOrString& algorithm,
CryptoKey& baseKey,
const Nullable<uint32_t>& length,
ErrorResult& aRv);
already_AddRefed<Promise> WrapKey(JSContext* cx, const nsAString& format,
CryptoKey& key, CryptoKey& wrappingKey,
const ObjectOrString& wrapAlgorithm,
ErrorResult& aRv);
already_AddRefed<Promise> UnwrapKey(
JSContext* cx, const nsAString& format,
const ArrayBufferViewOrArrayBuffer& wrappedKey, CryptoKey& unwrappingKey,
const ObjectOrString& unwrapAlgorithm,
const ObjectOrString& unwrappedKeyAlgorithm, bool extractable,
const Sequence<nsString>& keyUsages, ErrorResult& aRv);
private:
nsCOMPtr<nsIGlobalObject> mParent;
};
} // namespace mozilla::dom
#endif // mozilla_dom_SubtleCrypto_h