GenerateRandom 搭配 AWS SDK 或 CLI 使用 - AWS Key Management Service

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

GenerateRandom 搭配 AWS SDK 或 CLI 使用

下列程式碼範例示範如何使用 GenerateRandom

CLI
AWS CLI

範例 1:產生 256 位元隨機位元組字串 (Linux 或 macOs)

下列generate-random範例會產生 256 位元 (32 位元組)、Base64 編碼的隨機位元組字串。此範例會解碼位元組字串,並將其儲存在隨機檔案中。

當您執行此命令時,必須使用 number-of-bytes 參數以位元組為單位指定隨機值的長度。

當您執行此命令時,不會指定 KMS 金鑰。隨機位元組字串與任何 KMS 金鑰無關。

根據預設, AWS KMS 會產生隨機數字。不過,如果您指定自訂金鑰存放區<https://docs.aws.amazon.com/kms/latest/developerguide/custom-key-store-overview.html>,隨機位元組字串會在與自訂金鑰存放區相關聯的 AWS CloudHSM 叢集中產生。

此範例使用下列參數和值:

它使用值為 的必要--number-of-bytes參數32來請求 32 位元組 (256 位元) string.It 使用值為 的 --output 參數text來指示 AWS CLI 以文字形式傳回輸出。 而不是 JSON.It 使用 從 response.It 管道 ( | ) --query parameter擷取 Plaintext 屬性的值,命令的輸出到 base64 公用程式, 解碼擷取的 output.It 使用重新導向運算子 ( > ) 將解碼後的位元組字串儲存到 ExampleRandom file.It 使用重新導向運算子 ( > ) 將二進位加密文字儲存到檔案。

aws kms generate-random \ --number-of-bytes 32 \ --output text \ --query Plaintext | base64 --decode > ExampleRandom

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS Key Management Service API 參考中的 GenerateRandom

範例 2:產生 256 位元隨機數字 (Windows 命令提示)

下列範例使用 generate-random命令來產生 256 位元 (32 位元組)、Base64 編碼的隨機位元組字串。此範例會解碼位元組字串,並將其儲存在隨機檔案中。此範例與上一個範例相同,除了在將隨機位元組字串儲存到 檔案之前,它在 Windows 中使用 certutil 公用程式來對隨機位元組字串進行 base64 解碼。

首先,產生 base64 編碼的隨機位元組字串,並將其儲存在暫存檔案 中ExampleRandom.base64

aws kms generate-random \ --number-of-bytes 32 \ --output text \ --query Plaintext > ExampleRandom.base64

由於generate-random命令的輸出會儲存在檔案中,因此此範例不會產生輸出。

現在,請使用 certutil -decode命令來解碼 ExampleRandom.base64 檔案中的 base64 編碼位元組字串。然後,它會將解碼後的位元組字串儲存在 ExampleRandom 檔案中。

certutil -decode ExampleRandom.base64 ExampleRandom

輸出:

Input Length = 18 Output Length = 12 CertUtil: -decode command completed successfully.

如需詳細資訊,請參閱 AWS Key Management Service API 參考中的 GenerateRandom

  • 如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 GenerateRandom

Rust
SDK for Rust
注意

GitHub 上提供更多範例。尋找完整範例,並了解如何在 AWS 程式碼範例儲存庫中設定和執行。

async fn make_string(client: &Client, length: i32) -> Result<(), Error> { let resp = client .generate_random() .number_of_bytes(length) .send() .await?; // Did we get an encrypted blob? let blob = resp.plaintext.expect("Could not get encrypted text"); let bytes = blob.as_ref(); let s = base64::encode(bytes); println!(); println!("Data key:"); println!("{}", s); Ok(()) }
  • 如需 API 詳細資訊,請參閱 SDK AWS for Rust API 參考中的 GenerateRandom

如需 AWS SDK 開發人員指南和程式碼範例的完整清單,請參閱 將此服務與 搭配使用 AWS SDK。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。