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 雲端HSM叢集中產生。

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

它使用值為 的必要--number-of-bytes參數32來請求 32 位元組 （256 位元） string.It 使用值為 的 --output 參數text來指示 AWS CLI將輸出傳回為文字， 而不是 JSON。它使用 從 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

此命令不會產生輸出。

如需詳細資訊，請參閱 金鑰管理服務參考 GenerateRandom 中的 。 AWS API

範例 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.

如需詳細資訊，請參閱 金鑰管理服務參考 GenerateRandom 中的 。 AWS API

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