aosp12/system/bt/common/address_obfuscator.h

76 lines
2.0 KiB
C++

/******************************************************************************
*
* Copyright 2018 Google, Inc.
*
* 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.
*
******************************************************************************/
#pragma once
#include <array>
#include <mutex>
#include <string>
#include "raw_address.h"
namespace bluetooth {
namespace common {
class AddressObfuscator {
public:
static constexpr unsigned int kOctet32Length = 32;
using Octet32 = std::array<uint8_t, kOctet32Length>;
static AddressObfuscator* GetInstance() {
static auto instance = new AddressObfuscator();
return instance;
}
/**
* Return true if the input salt is valid
* Criteria:
* - Salt must be non-zero
*
* @param salt_256bit
* @return true if the salt is valid
*/
static bool IsSaltValid(const Octet32& salt_256bit);
/**
* Initialize this obfuscator with necessary parameters
*
* @param salt_256bit a 256 bit salt used to hash the fixed length address
*/
void Initialize(const Octet32& salt_256bit);
/**
* Return true if Initialize() was called earlier
*/
bool IsInitialized();
/**
* Obfuscate Bluetooth MAC address into an anonymous ID string
*
* @param address Bluetooth MAC address to be obfuscated
* @return the obfuscated MAC address in 256 bit
*/
std::string Obfuscate(const RawAddress& address);
private:
AddressObfuscator() : salt_256bit_({0}) {}
Octet32 salt_256bit_;
std::recursive_mutex instance_mutex_;
};
} // namespace common
} // namespace bluetooth