本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
在 S3 Vectors 中設定加密
本主題說明如何設定 S3 向量儲存貯體和索引的加密組態。
開始前,請確定您具有下列項目:
-
檢視儲存貯體和索引屬性的適當許可。
設定向量儲存貯體的加密
-
開啟位於 https://console.aws.amazon.com/s3/
的 Amazon S3 主控台。 -
在導覽窗格中,選擇向量儲存貯體。
-
選擇建立向量儲存貯體。
-
針對 Bucket name (儲存貯體名稱),輸入儲存貯體的名稱。
儲存貯體名稱必須;
在此 AWS 區域的帳戶中是唯一的
長度必須介於 3 與 63 個字元之間
只能由小寫字母、數字和連字號 (-) 組成
-
針對加密,選擇
-
指定加密類型 – 選擇特定的加密方法:
-
使用 Amazon S3 受管金鑰 (SSE-S3) 的伺服器端加密 – 透過 SSE-S3,Amazon S3 會自動處理加密金鑰的產生、輪換和管理。
-
使用 AWS Key Management Service 金鑰 (SSE-KMS) 的伺服器端加密 – 類似於 SSE-S3,但在 AWS KMS 中使用客戶受管金鑰 (CMKs),可讓您進一步控制金鑰。如需有關客戶自管金鑰的詳細資訊,請參閱《AWS Key Management Service 開發人員指南》中的客戶自管金鑰。
如果您選取此選項,請在 AWS KMS 金鑰下選擇下列其中一個選項:
從 AWS KMS 金鑰中選擇 – 從下拉式清單中選擇現有的 KMS 金鑰
輸入 AWS KMS 金鑰 ARN – 輸入 KMS 金鑰的 Amazon Resource Name (ARN)
建立 KMS 金鑰 – 在 AWS KMS 主控台中建立新的客戶受管金鑰。如需詳細資訊,請參閱《AWS Key Management Service 開發人員指南》中的建立對稱客戶自管金鑰。
-
注意
下列要求適用於 KMS 金鑰:
AWS KMS 金鑰 ID 不得空白
您的 KMS 金鑰必須位於建立此儲存貯體的相同區域
AWS KMS 金鑰 ARN 必須以 "arn:aws:kms:" 開頭
重要
加密設定無法在建立向量儲存貯體後進行變更。
-
-
如果您選擇輸入 AWS KMS 金鑰 ARN,請在提供的文字欄位中輸入 ARN。
-
如果您選擇建立 KMS 金鑰,主控台會在新索引標籤中開啟 AWS KMS 主控台。如需有關建立 KMS 金鑰的指示,請參閱《AWS Key Management Service 開發人員指南》中的建立對稱客戶自管金鑰。
-
選擇建立向量儲存貯體。
重要
使用 KMS 加密時,請確定需要存取儲存貯體中的物件的 IAM 主體,具有所選 KMS 金鑰的必要 KMS 許可 (kms:Decrypt)。
設定向量索引的加密
開啟位於 https://console.aws.amazon.com/s3/
的 Amazon S3 主控台。 在導覽窗格中,選擇向量儲存貯體。
在向量儲存貯體清單中,選擇您要建立向量索引的儲存貯體名稱。
選擇建立向量索引。
針對向量索引名稱,輸入向量索引的名稱。
向量索引名稱在向量儲存貯體中必須是唯一的。索引名稱長度必須介於 3 到 63 個字元之間。有效字元為小寫字母 (a-z)、數字 (0-9)、連字號 (-) 和點 (.)。如需向量索引命名要求的詳細資訊,請參閱 向量儲存貯體命名規則。
針對維度,輸入每個向量中的值數目。
注意
維度的值決定了每個向量將包含的數值。
新增至此索引的所有向量,必須具有此數目的值。
維度必須介於 1 到 4096 之間。
較大的維度需要更多的儲存空間。
根據您的嵌入模型輸出維度做選擇。
如需有關維度要求的詳細資訊,請參閱 限制。
針對距離指標,選擇以下其中一個選項:
餘弦 - 測量向量之間角度的餘弦。標準化向量以及當方向比大小重要時的最佳選擇
歐氏幾何 - 測量向量之間的直線距離。當方向和大小都很重要時的最佳選擇。
(選用) 在不可篩選的中繼資料下,設定要儲存但不用於篩選的中繼資料索引鍵:
新增不可篩選的中繼資料索引鍵:
選擇 Add key (新增金鑰)。
輸入索引鍵名稱 (1-63 個字元,是此向量索引中的唯一)。
重複以新增其他索引鍵 (最多 10 個索引鍵)。
-
針對加密,選擇指定加密類型,然後選擇下列其中一個選項:
-
使用儲存貯體設定進行加密 – Amazon S3 會套用向量儲存貯體加密設定來加密向量索引中的向量資料。
-
覆寫加密的儲存貯體設定 – 指定向量索引的特定加密類型:
-
使用 Amazon S3 受管金鑰 (SSE-S3) 的伺服器端加密 – 透過 SSE-S3,Amazon S3 會自動處理加密金鑰的產生、輪換和管理。
-
使用 AWS Key Management Service 金鑰 (SSE-KMS) 的伺服器端加密 – 類似於 SSE-S3,但在 AWS KMS 中使用客戶受管金鑰 (CMKs),可讓您進一步控制金鑰。如需有關客戶自管金鑰的詳細資訊,請參閱《AWS Key Management Service 開發人員指南》中的客戶自管金鑰。
如果您選取此選項,請在 AWS KMS 金鑰下選擇下列其中一個選項:
從 AWS KMS 金鑰中選擇 – 從下拉式清單中選擇現有的 KMS 金鑰
輸入 AWS KMS 金鑰 ARN – 輸入 KMS 金鑰的 Amazon Resource Name (ARN)
建立 KMS 金鑰 – 在 AWS KMS 主控台中建立新的客戶受管金鑰。如需詳細資訊,請參閱《AWS Key Management Service 開發人員指南》中的建立對稱客戶自管金鑰。
注意
下列要求適用於 KMS 金鑰:
-
AWS KMS 金鑰 ID 不得空白。
-
您的 KMS 金鑰必須位於建立此儲存貯體的相同區域中。
-
AWS KMS 金鑰 ARN 必須以 "arn:aws:kms:" 開頭
重要
建立向量索引後,就無法變更加密設定。
如果您選擇輸入 AWS KMS 金鑰 ARN,請在提供的文字欄位中輸入 ARN。
如果您選擇建立 KMS 金鑰,主控台會在新索引標籤中開啟 AWS KMS 主控台。如需有關建立 KMS 金鑰的指示,請參閱《AWS Key Management Service 開發人員指南》中的建立對稱客戶自管金鑰。
重要
使用 KMS 加密時,請確定需要存取儲存貯體中的物件的 IAM 主體,具有所選 KMS 金鑰的必要 KMS 許可 (kms:Decrypt)。
-
-
在標籤 (選用) 下,您可以將標籤新增為鍵值對,以協助使用 AWS Billing and Cost Management 追蹤和組織向量索引成本。輸入 Key (索引鍵) 和 Value (數值)。若要新增其他標籤,選擇 Add Tag (新增標籤)。您可以為向量索引輸入最多 50 個標籤。如需詳細資訊,請參閱搭配 S3 向量儲存貯體使用標籤。
仔細檢閱您的組態。
注意
這些設定在建立後便無法變更。
選擇建立向量索引。
下列範例示範如何使用 AWS CLI,建立具有 SSE-S3 加密組態的向量儲存貯體。若要使用此範例,請以您自己的資訊取代使用者輸入預留位置。
aws s3vectors create-vector-bucket \ --vector-bucket-name "amzn-s3-demo-vector-bucket" \ --encryption-configuration '{"sseType": "AES256"}'
下列範例示範如何建立向量儲存貯體,該儲存貯體使用 SSE-KMS 加密組態和客戶自管金鑰。若要使用此範例,請以您自己的資訊取代使用者輸入預留位置。
aws s3vectors create-vector-bucket \ --vector-bucket-name "amzn-s3-demo-vector-bucket" \ --encryption-configuration '{"sseType": "aws:kms", "kmsKeyArn": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"}'
下列範例示範如何使用 建立具有 SSE-S3 加密組態的向量索引 AWS CLI。若要使用此範例,請以您自己的資訊取代使用者輸入預留位置。
aws s3vectors create-index \ --vector-bucket-name"amzn-s3-demo-vector-bucket"\ --index-name"amzn-s3-demo-vector-index"\ --encryption-configuration '{"sseType": "AES256"}'
下列範例示範如何建立向量索引,該索引使用 SSE-KMS 加密組態搭配客戶受管金鑰。若要使用此範例,請以您自己的資訊取代使用者輸入預留位置。
aws s3vectors create-index \ --vector-bucket-name"amzn-s3-demo-vector-bucket"\ --index-name"amzn-s3-demo-vector-index"\ --encryption-configuration '{"sseType": "aws:kms", "kmsKeyArn":"arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890abc"}'
下列範例顯示 將使用向量儲存貯體的加密設定建立向量索引。若要使用此範例,請以您自己的資訊取代使用者輸入預留位置。
aws s3vectors create-index \ --vector-bucket-name"amzn-s3-demo-vector-bucket"\ --index-name"amzn-s3-demo-vector-index"\