// Copyright 2023 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // //////////////////////////////////////////////////////////////////////////////// #ifndef TINK_MAC_HMAC_KEY_H_ #define TINK_MAC_HMAC_KEY_H_ #include #include #include #include "absl/types/optional.h" #include "tink/mac/hmac_parameters.h" #include "tink/mac/mac_key.h" #include "tink/partial_key_access_token.h" #include "tink/restricted_data.h" #include "tink/util/statusor.h" namespace crypto { namespace tink { class HmacKey : public MacKey { public: // Copyable and movable. HmacKey(const HmacKey& other) = default; HmacKey& operator=(const HmacKey& other) = default; HmacKey(HmacKey&& other) = default; HmacKey& operator=(HmacKey&& other) = default; // Creates a new HMAC key. If the parameters specify a variant that uses // a prefix, then the id is used to compute this prefix. static util::StatusOr Create(const HmacParameters& parameters, const RestrictedData& key_bytes, absl::optional id_requirement, PartialKeyAccessToken token); // Returns the underlying HMAC key bytes. util::StatusOr GetKeyBytes( PartialKeyAccessToken token) const { return key_bytes_; } absl::string_view GetOutputPrefix() const override { return output_prefix_; } const HmacParameters& GetParameters() const override { return parameters_; } absl::optional GetIdRequirement() const override { return id_requirement_; } bool operator==(const Key& other) const override; private: HmacKey(const HmacParameters& parameters, const RestrictedData& key_bytes, absl::optional id_requirement, std::string output_prefix) : parameters_(parameters), key_bytes_(key_bytes), id_requirement_(id_requirement), output_prefix_(std::move(output_prefix)) {} static util::StatusOr ComputeOutputPrefix( const HmacParameters& parameters, absl::optional id_requirement); HmacParameters parameters_; RestrictedData key_bytes_; absl::optional id_requirement_; std::string output_prefix_; }; } // namespace tink } // namespace crypto #endif // TINK_MAC_HMAC_KEY_H_