設定信標

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);
                        

請參閱完整的代碼示例：VirtualBeaconSearchableEncryptionExample.java

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);

請參閱完整的代碼示例：VirtualBeaconSearchableEncryptionExample.cs

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

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

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

定義為的標準信標只PartOnly能用來定義複合信標的加密部分。您無法直接查詢標PartOnly準信標。

根據預設，每個標準信標都會產生一個唯一的 HMAC 金鑰來計算信標。因此，您無法對來自兩個不同標準信標的加密欄位執行相等搜尋。定義為Shared使用其他標準信標的 HMAC 金鑰進行計算的標準信標。

例如，如果您需要將beacon1欄位與欄位進beacon2行比較，請定義beacon2為使用 HMAC 金鑰進行計算beacon1的Shared信標。

根據預設，如果欄位值是集合， AWS 資料庫加密 SDK 會計算集合的單一標準信標。因此，您無法執行加密欄位的查詢CONTAINS(a, :value)。a標準信標 (Beacon) 定義為AsSet計算集合中每個個別元素的個別標準信標值，並以集合形式儲存在項目中的信標值。這可讓資 AWS 料庫加密 SDK 執行查詢CONTAINS(a, :value)。

若要定義AsSet標準信標，集合中的元素必須來自相同的人口，以便它們都可以使用相同的信標長度。如果在計算信標值時發生衝突，信標集合的元素可能會少於純文字集。

定義為SharedSet結合Shared和AsSet函數的標準信標，以便您可以對集合和欄位的加密值執行相等搜尋。這使得 AWS 數據庫加密 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()
);

請參閱完整的程式碼範例：BeaconConfig.cs

複合信標配置

下列範例會在複合信標組態中於本機定義加密和已簽署的零件清單。

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
            }
        }
    }
};