Files
nearby/presence/implementation/advertisement_decoder_impl.cc
T
hai007 00a2999269 Format all the files in CL786733783
PiperOrigin-RevId: 786873870
2025-07-24 16:25:18 -07:00

288 lines
10 KiB
C++

// Copyright 2022 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
//
// https://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.
#include "presence/implementation/advertisement_decoder_impl.h"
#include <cstddef>
#include <cstdint>
#include <string>
#include <utility>
#include <vector>
#include "absl/container/flat_hash_map.h"
#include "absl/status/status.h"
#include "absl/status/statusor.h"
#include "absl/strings/escaping.h"
#include "absl/strings/str_format.h"
#include "absl/strings/string_view.h"
#include "internal/platform/logging.h"
#include "presence/data_element.h"
#include "presence/implementation/action_factory.h"
#include "presence/implementation/advertisement_decoder.h"
#include "presence/implementation/base_broadcast_request.h"
#include "presence/implementation/ldt.h"
namespace nearby {
namespace presence {
namespace {
constexpr uint8_t kDataTypeMask =
(1 << DataElement::kDataElementLengthShift) - 1;
constexpr int kAdvertisementVersion = 0;
constexpr int kEncryptedIdentityAdditionalLength =
kSaltSize + kBaseMetadataSize;
constexpr int kEddystoneAdditionalLength = 20;
uint8_t GetDataElementType(uint8_t header) { return header & kDataTypeMask; }
size_t GetDataElementLength(uint8_t header) {
return header >> DataElement::kDataElementLengthShift;
}
// Verifies if the DE header describes a valid DE in v0 advertisement.
bool IsDataElementAllowed(uint8_t header) {
uint8_t data_type = GetDataElementType(header);
size_t length = GetDataElementLength(header);
switch (data_type) {
case DataElement::kSaltFieldType:
return length == 2;
case DataElement::kPublicIdentityFieldType:
return length == 0;
case DataElement::kPrivateGroupIdentityFieldType:
case DataElement::kContactsGroupIdentityFieldType:
return length >= 2 && length <= 6;
case DataElement::kTxPowerFieldType:
return length == 1;
case DataElement::kActionFieldType:
return length >= 1 && length <= 3;
case DataElement::kModelIdFieldType:
return length == 3;
case DataElement::kEddystoneIdFieldType:
return length == 0;
case DataElement::kAccountKeyDataFieldType:
return length <= 12;
case DataElement::kConnectionStatusFieldType:
return length <= 3;
case DataElement::kBatteryFieldType:
return length <= 3;
default:
return false;
}
}
bool IsEncryptedIdentity(int data_type) {
return data_type == DataElement::kPrivateGroupIdentityFieldType ||
data_type == DataElement::kContactsGroupIdentityFieldType;
}
bool IsIdentity(int data_type) {
return data_type == DataElement::kPublicIdentityFieldType ||
IsEncryptedIdentity(data_type);
}
internal::IdentityType GetIdentityType(int data_type) {
switch (data_type) {
case DataElement::kPrivateGroupIdentityFieldType:
return internal::IDENTITY_TYPE_PRIVATE_GROUP;
case DataElement::kContactsGroupIdentityFieldType:
return internal::IDENTITY_TYPE_CONTACTS_GROUP;
case DataElement::kPublicIdentityFieldType:
return internal::IDENTITY_TYPE_PUBLIC;
}
return internal::IDENTITY_TYPE_UNSPECIFIED;
}
// Returns the real length of a DE in v0 advertisement, which may be larger than
// the value in the header.
size_t GetDataElementTrueLength(uint8_t header) {
uint8_t data_type = GetDataElementType(header);
size_t length = GetDataElementLength(header);
if (IsEncryptedIdentity(data_type)) {
// The length of an encrypted DE is 16 bytes of overhead (salt + metadata
// key) + the actual payload, which is too long to fit in the 4-bit DE
// length field.
length += kEncryptedIdentityAdditionalLength;
} else if (data_type == DataElement::kEddystoneIdFieldType) {
// Length in the header is set to EID length minus 20, because EID is longer
// than 15 (the maximum length that can be stored in 4 bits.
length += kEddystoneAdditionalLength;
}
return length;
}
absl::StatusOr<DataElement> ParseDataElement(const absl::string_view input,
size_t& index) {
if (index >= input.size()) {
return absl::OutOfRangeError(absl::StrFormat(
"Data element (%s) is %d bytes long. Expected more than %d",
absl::BytesToHexString(input), input.size(), index));
}
uint8_t header = input[index];
if (!IsDataElementAllowed(header)) {
return absl::InvalidArgumentError(
absl::StrFormat("Unsupported Data Element 0x%x", header));
}
uint8_t data_type = GetDataElementType(header);
size_t length = GetDataElementTrueLength(header);
++index;
size_t start = index;
index += length;
if (index > input.size()) {
return absl::OutOfRangeError(absl::StrFormat(
"Data element (%s) is %d bytes long. Expected at least %d",
absl::BytesToHexString(input), input.size(), index));
}
VLOG(1) << "Type: " << static_cast<int>(data_type)
<< " length: " << static_cast<int>(length)
<< " DE: " << absl::BytesToHexString(input.substr(start, length));
return DataElement(data_type, input.substr(start, length));
}
} // namespace
void DecodeBaseAction(absl::string_view serialized_action,
Advertisement& decoded_advertisement) {
if (serialized_action.empty() || serialized_action.size() > 3) {
LOG(WARNING) << "Base NP action \'"
<< absl::BytesToHexString(serialized_action)
<< "\' has wrong length " << serialized_action.size()
<< " , expected size in range [1 - 3]";
return;
}
// Action, 0-2 bytes in Big Endian order.
Action action = {.action = 0};
for (int i = 0; i < serialized_action.size(); ++i) {
int offset = (sizeof(uint32_t) - 1 - i) * 8;
action.action |= serialized_action[i] << offset;
}
ActionFactory::DecodeAction(action, decoded_advertisement.data_elements);
}
absl::StatusOr<std::string> DecryptLdt(
const std::vector<internal::SharedCredential>& credentials,
absl::string_view salt, absl::string_view encrypted_contents,
Advertisement& decoded_advertisement) {
if (credentials.empty()) {
return absl::UnavailableError("No credentials");
}
for (const auto& credential : credentials) {
absl::StatusOr<LdtEncryptor> encryptor = LdtEncryptor::Create(
credential.key_seed(), credential.metadata_encryption_key_tag_v0());
if (encryptor.ok()) {
absl::StatusOr<std::string> result =
encryptor->DecryptAndVerify(encrypted_contents, salt);
if (result.ok() && result->size() > kBaseMetadataSize) {
decoded_advertisement.public_credential = credential;
decoded_advertisement.metadata_key =
result->substr(0, kBaseMetadataSize);
return result->substr(kBaseMetadataSize);
}
}
}
return absl::UnavailableError(
"Couldn't decrypt the message with any credentials");
}
absl::Status DecryptDataElements(
const std::vector<internal::SharedCredential>& credentials,
const DataElement& elem, Advertisement& decoded_advertisement) {
if (elem.GetValue().size() <= kEncryptedIdentityAdditionalLength) {
return absl::OutOfRangeError(absl::StrFormat(
"Encrypted identity data element is too short - %d bytes",
elem.GetValue().size()));
}
absl::string_view salt = elem.GetValue().substr(0, kSaltSize);
decoded_advertisement.data_elements.emplace_back(DataElement::kSaltFieldType,
salt);
absl::string_view encrypted = elem.GetValue().substr(kSaltSize);
absl::StatusOr<std::string> decrypted =
DecryptLdt(credentials, salt, encrypted, decoded_advertisement);
if (!decrypted.ok()) {
LOG(WARNING) << "Failed to decrypt advertisement, status: "
<< decrypted.status();
return decrypted.status();
}
size_t index = 0;
while (index < decrypted->size()) {
absl::StatusOr<DataElement> internal_elem =
ParseDataElement(*decrypted, index);
if (!internal_elem.ok()) {
LOG(WARNING) << "Failed to read data element, status: "
<< internal_elem.status();
return internal_elem.status();
}
if (internal_elem->GetType() == DataElement::kActionFieldType) {
DecodeBaseAction(internal_elem->GetValue(), decoded_advertisement);
} else {
decoded_advertisement.data_elements.push_back(*std::move(internal_elem));
}
}
return absl::OkStatus();
}
absl::StatusOr<Advertisement> AdvertisementDecoderImpl::DecodeAdvertisement(
absl::string_view advertisement) {
Advertisement decoded_advertisement = Advertisement{};
std::vector<DataElement> result;
LOG(INFO) << "Advertisement: " << absl::BytesToHexString(advertisement);
if (advertisement.empty()) {
return absl::OutOfRangeError("Empty advertisement");
}
uint8_t version = advertisement[0];
VLOG(1) << "Version: " << version;
if (version != kAdvertisementVersion) {
return absl::UnimplementedError(absl::StrFormat(
"Advertisement version (%d) is not supported", version));
}
decoded_advertisement.version = version;
size_t index = 1;
absl::StatusOr<std::string> decrypted;
while (index < advertisement.size()) {
absl::StatusOr<DataElement> elem = ParseDataElement(advertisement, index);
if (!elem.ok()) {
LOG(WARNING) << "Failed to read data element, status: " << elem.status();
return elem.status();
}
if (IsIdentity(elem->GetType())) {
decoded_advertisement.identity_type = GetIdentityType(elem->GetType());
}
if (IsEncryptedIdentity(elem->GetType())) {
if (credentials_map_ == nullptr) {
return absl::FailedPreconditionError("Missing credentials");
}
auto identity_type_specific_creds =
(*credentials_map_)[decoded_advertisement.identity_type];
absl::Status status = DecryptDataElements(identity_type_specific_creds,
*elem, decoded_advertisement);
if (!status.ok()) {
return status;
}
} else {
if (elem->GetType() == DataElement::kActionFieldType) {
DecodeBaseAction(elem->GetValue(), decoded_advertisement);
} else {
decoded_advertisement.data_elements.push_back(*std::move(elem));
}
}
}
return std::move(decoded_advertisement);
}
} // namespace presence
} // namespace nearby