gcloud: Tue Mar 1 04:29:52 UTC 2022

gcloud/beta/kms/mac-sign

@@ -0,0 +1,71 @@
+NAME
+    gcloud beta kms mac-sign - sign a user input file using a MAC key version
+
+SYNOPSIS
+    gcloud beta kms mac-sign --input-file=INPUT_FILE
+        --signature-file=SIGNATURE_FILE [--key=KEY] [--keyring=KEYRING]
+        [--location=LOCATION] [--skip-integrity-verification]
+        [--version=VERSION] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (BETA) Creates a digital signature of the input file using the provided MAC
+    signing key version and saves the base64 encoded signature.
+
+    The required flag signature-file indicates the path to store signature.
+
+    By default, the command performs integrity verification on data sent to and
+    received from Cloud KMS. Use --skip-integrity-verification to disable
+    integrity verification.
+
+EXAMPLES
+    The following command will read the file '/tmp/my/file.to.sign', and sign
+    it using the symmetric MAC CryptoKey dont-panic Version 3, and save the
+    signature in base64 format to '/tmp/my/signature'.
+
+        $ gcloud beta kms mac-sign \
+        --location=us-central1 \
+        --keyring=hitchhiker \
+        --key=dont-panic \
+        --version=3 \
+        --input-file=/tmp/my/file.to.sign \
+        --signature-file=/tmp/my/signature
+
+REQUIRED FLAGS
+     --input-file=INPUT_FILE
+        Path to the input file to sign.
+
+     --signature-file=SIGNATURE_FILE
+        Path to the signature file to output.
+
+OPTIONAL FLAGS
+     --key=KEY
+        to use for signing.
+
+     --keyring=KEYRING
+        Key ring of the key.
+
+     --location=LOCATION
+        Location of the keyring.
+
+     --skip-integrity-verification
+        Skip integrity verification on request and response API fields.
+
+     --version=VERSION
+        Version to use for signing.
+
+GCLOUD WIDE FLAGS
+    These flags are available to all commands: --access-token-file, --account,
+    --billing-project, --configuration, --flags-file, --flatten, --format,
+    --help, --impersonate-service-account, --log-http, --project, --quiet,
+    --trace-token, --user-output-enabled, --verbosity.
+
+    Run $ gcloud help for details.
+
+NOTES
+    This command is currently in beta and might change without notice. These
+    variants are also available:
+
+        $ gcloud kms mac-sign
+
+        $ gcloud alpha kms mac-sign
+