GenerateRandom 搭配 AWS SDK 或 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。

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(())
}