翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ビーコンの計画
<a name="plan-searchable-encryption"></a>


****  

|  | 
| --- |
| クライアント側の暗号化ライブラリの名前が AWS Database Encryption SDK に変更されました。このデベロッパーガイドでは、引き続き [DynamoDB Encryption Client](legacy-dynamodb-encryption-client.md) に関する情報を提供します。 | 

ビーコンは、データが入力されていない新しいデータベースに実装されるように設計されています。既存のデータベースで設定されたビーコンは、データベースに書き込まれる新しいレコードのみをマッピングします。ビーコンはフィールドのプレーンテキストの値から計算されます。フィールドが暗号化されると、ビーコンは既存のデータをマッピングできなくなります。ビーコンを持つ新しいレコードを書き込んだ後に、そのビーコンの設定を更新することはできません。ただし、レコードに追加する新しいフィールドに新しいビーコンを追加できます。

検索可能な暗号化を実装するには、[AWS KMS 階層キーリング](use-hierarchical-keyring.md)を使用して、レコードを保護するために使用されるデータキーを生成、暗号化、および復号する必要があります。詳細については、「[検索可能な暗号化のための階層キーリングの使用](use-hierarchical-keyring.md#searchable-encryption-hierarchical-keyrings)」を参照してください。

検索可能な暗号化のために[ビーコン](searchable-encryption.md#beacon-definition)を設定する前に、暗号化要件、データベースのアクセスパターン、および脅威モデルを確認して、データベースに最適なソリューションを決定する必要があります。

設定する[ビーコンのタイプ](beacons.md)によって、実行できるクエリのタイプが決まります。標準ビーコン設定で指定する[ビーコンの長さ](choosing-beacon-length.md)によって、特定のビーコンについて生成される誤検知の想定数が決まります。ビーコンを設定する前に、実行する必要があるクエリのタイプを特定して計画することを強くお勧めします。ビーコンを使用した後に設定を更新することはできません。

ビーコンを設定する前に、次のタスクを確認および完了することを強くお勧めします。
+ [ビーコンがデータセットに適しているかどうかを判断する](searchable-encryption.md#are-beacons-right-for-me)
+ [ビーコンのタイプを選択する](choosing-beacon-type.md)
+ [ビーコンの長さを選択する](choosing-beacon-length.md)
+ [ビーコン名を選択する](choosing-beacon-name.md)

データベースのために検索可能な暗号化ソリューションを計画する際には、ビーコンの一意性に関する次の要件に留意してください。
+ **すべての標準ビーコンには固有の[ビーコンソース](beacons.md#beacon-source)が必要です**

  同じ暗号化されたフィールドまたは仮想フィールドから複数の標準ビーコンを構築することはできません。

  ただし、単一の標準ビーコンを使用して複数の複合ビーコンを構築することはできます。
+ **既存の標準ビーコンと重複するソースフィールドを含む仮想フィールドを作成しないようにしてください**

  別の標準ビーコンを作成するために使用されたソースフィールドを含む仮想フィールドから標準ビーコンを構築すると、両方のビーコンのセキュリティが低下する可能性があります。

  詳細については、「[仮想フィールドのセキュリティに関する考慮事項](configure-beacons.md#virtual-field-considerations)」を参照してください。

## マルチテナンシーデータベースに関する考慮事項
<a name="planning-multitenant-beacons"></a>

マルチテナンシーデータベースで設定されたビーコンをクエリするには、レコードを暗号化したテナンシーに関連付けられた `branch-key-id` を格納するフィールドをクエリに含める必要があります。このフィールドは、[ビーコンキーソースを定義](use-hierarchical-keyring.md#beacon-key-source)する際に定義します。クエリが成功するには、このフィールドの値が、ビーコンの再計算に必要となる適切なビーコンキーマテリアルを識別する必要があります。

ビーコンを設定する前に、クエリに `branch-key-id` をどのように含めるかを決定する必要があります。クエリに `branch-key-id` を含めるさまざまな方法の詳細については、「[マルチテナンシーデータベース内のビーコンのクエリ](searchable-encryption-multitenant.md#query-multitenant-beacons)」を参照してください。