將 GenerateRandom 與 AWS SDK 或 CLI 搭配使用

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

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

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

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

根據預設，AWS KMS 會產生隨機數字。不過，如果您指定自訂金鑰存放區，隨機位元組字串會在與自訂金鑰存放區相關聯的 AWS CloudHSM 叢集中產生。

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

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

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