비컨 구성

List<StandardBeacon> standardBeaconList = new ArrayList<>();
StandardBeacon exampleStandardBeacon = StandardBeacon.builder()
    .name("beaconName")
    .length(beaconLengthInBits)
    .build();
standardBeaconList.add(exampleStandardBeacon);

var standardBeaconList = new List<StandardBeacon>();
StandardBeacon exampleStandardBeacon = new StandardBeacon
  {
    Name = "beaconName",
    Length = 10
  };
standardBeaconList.Add(exampleStandardBeacon);
                        

전체 코드 예제.java를 참조하십시오. VirtualBeaconSearchableEncryptionExample

List<VirtualPart> virtualPartList = new ArrayList<>();
    virtualPartList.add(sourceField1);
    virtualPartList.add(sourceField2);

VirtualField virtualFieldName = VirtualField.builder()
    .name("virtualFieldName")
    .parts(virtualPartList)
    .build();

List<VirtualField> virtualFieldList = new ArrayList<>();
    virtualFieldList.add(virtualFieldName);

전체 코드 예제 참조: .cs VirtualBeaconSearchableEncryptionExample

var virtualPartList = new List<VirtualPart> { sourceField1, sourceField2 };

var virtualFieldName = new VirtualField
{
    Name = "virtualFieldName",
    Parts = virtualPartList
};

var virtualFieldList = new List<VirtualField> { virtualFieldName };

로 정의된 표준 비콘은 복합 비콘의 암호화된 부분을 정의하는 데만 사용할 PartOnly 수 있습니다. PartOnly표준 비콘은 직접 쿼리할 수 없습니다.

기본적으로 모든 표준 비콘은 비콘 계산을 위한 고유한 HMAC 키를 생성합니다. 따라서 두 개의 개별 표준 비콘에서 암호화된 필드에 대해 동등 검색을 수행할 수 없습니다. 로 정의된 표준 비콘은 다른 표준 비콘의 HMAC 키를 계산에 Shared 사용합니다.

예를 들어 beacon1 필드를 필드와 비교해야 하는 경우 beacon2 Shared 계산에 HMAC 키를 사용하는 beacon2 비콘으로 정의하십시오. beacon1

기본적으로 필드 값이 집합인 경우 AWS 데이터베이스 암호화 SDK는 집합에 대한 단일 표준 비콘을 계산합니다. 따라서 암호화된 a 필드가 CONTAINS(a, :value) 있는 경우 쿼리를 수행할 수 없습니다. 로 정의된 표준 비콘은 세트의 각 개별 요소에 대한 개별 표준 비콘 값을 AsSet 계산하여 항목의 비콘 값을 세트로 저장합니다. 이렇게 하면 AWS 데이터베이스 암호화 SDK에서 쿼리를 수행할 수 있습니다. CONTAINS(a, :value)

AsSet표준 비콘을 정의하려면 세트의 요소가 모두 같은 비콘 길이를 사용할 수 있도록 동일한 모집단에서 가져온 것이어야 합니다. 신호 값을 계산할 때 충돌이 발생한 경우 비콘 집합의 요소 수가 일반 텍스트 집합보다 적을 수 있습니다.

로 정의된 표준 비콘은 Shared 및 AsSet 함수를 SharedSet 결합하여 집합과 필드의 암호화된 값에 대해 동등 검색을 수행할 수 있도록 합니다. 이렇게 하면 AWS Database Encryption SDK가 쿼리를 수행할 수 있습니다. CONTAINS(a, b) 여기서 a 는 암호화된 집합이고 필드는 암호화된 b 필드입니다.

복합 비콘 구성

다음 예에서는 복합 비콘 구성 내에서 암호화되고 서명된 부품 목록을 로컬로 정의합니다.

List<CompoundBeacon> compoundBeaconList = new ArrayList<>();
CompoundBeacon exampleCompoundBeacon = CompoundBeacon.builder()
    .name("compoundBeaconName")
    .split(".")
    .encrypted(encryptedPartList) 
    .signed(signedPartList)                       
    .constructors(constructorList) 
    .build();
compoundBeaconList.add(exampleCompoundBeacon);

비콘 버전 정의

다음 예제는 비콘 버전에서 암호화되고 서명된 부품 목록을 전역적으로 정의합니다. 비콘 버전 정의에 대한 자세한 내용은 비콘 사용을 참조하십시오.

 List<BeaconVersion> beaconVersions = new ArrayList<>();
beaconVersions.add(
    BeaconVersion.builder()
        .standardBeacons(standardBeaconList)
        .compoundBeacons(compoundBeaconList)
        .encryptedParts(encryptedPartList)
        .signedParts(signedPartList)
        .version(1) // MUST be 1
        .keyStore(keyStore)
        .keySource(BeaconKeySource.builder()
            .single(SingleKeyStore.builder()
                .keyId(branchKeyId)
                .cacheTTL(6000)
                .build())
            .build())
        .build()
);

전체 코드 샘플: .cs를 참조하십시오. BeaconConfig

복합 비콘 구성

다음 예에서는 복합 비콘 구성 내에서 암호화되고 서명된 부품 목록을 로컬로 정의합니다.

var compoundBeaconList = new List<CompoundBeacon>();       
var exampleCompoundBeacon = new CompoundBeacon
 {
    Name = "compoundBeaconName",
    Split = ".",
    Encrypted = encryptedPartList,
    Signed = signedPartList,                        
    Constructors = constructorList 
 };
compoundBeaconList.Add(exampleCompoundBeacon);

비콘 버전 정의

다음 예제는 비콘 버전에서 암호화되고 서명된 부품 목록을 전역적으로 정의합니다. 비콘 버전 정의에 대한 자세한 내용은 비콘 사용을 참조하십시오.

var beaconVersions = new List<BeaconVersion>
{
    new BeaconVersion
    {
        StandardBeacons = standardBeaconList,
        CompoundBeacons = compoundBeaconList,
        EncryptedParts = encryptedPartsList,
        SignedParts = signedPartsList,
        Version = 1, // MUST be 1
        KeyStore = keyStore,
        KeySource = new BeaconKeySource
        {
            Single = new SingleKeyStore
            {
                KeyId = branchKeyId,
                CacheTTL = 6000
            }
        }
    }
};