Firmar y verificar datos

El AO realiza operaciones de firma y verificación a través de Google Distributed Cloud (GDC) aislado por aire al KMS mediante un cliente gRPC.

Antes de empezar

Para obtener los permisos necesarios para firmar datos, pide al administrador de gestión de identidades y accesos de tu organización que te conceda el rol Desarrollador de KMS (kms-developer) en el espacio de nombres de tu proyecto.

Datos de firma

Para firmar datos, usa el comando gdcloud kms keys asymmetric-sign. Este comando crea una firma digital de un archivo de entrada con la clave Signing y guarda la firma codificada en base64.

  • Para firmar tus datos, introduce el nombre de la clave y lo siguiente:

    gdcloud kms keys asymmetric-sign \
namespaces/NAMESPACE/signingKeys/KEY_NAME \
--input-file=INPUT_PATH \
--signature-file=SIGNATURE_FILE

    Sustituye las siguientes variables:

    • NAMESPACE: el espacio de nombres del proyecto. Por ejemplo: kms-test1.
    • KEY_NAME: el nombre de la clave utilizada para firmar. Por ejemplo, key-1.
    • INPUT_PATH: la ruta del archivo de entrada que quieres firmar.
    • SIGNATURE_FILE: la ruta del archivo de salida donde se guardará la firma codificada en Base64.

    Después de ejecutar el comando, verás un archivo de salida que has especificado en la marca --signature-file y que contiene la firma codificada en base64.

Verificar datos

Después de firmar los datos, verifica la firma digital en base64 con el comando gdcloud kms keys asymmetric-verify. Este comando verifica si la firma digital codificada en base64 que recibes después de ejecutar el comando gdcloud kms keys asymmetric-sign es válida o no.

  • Para verificar la firma, envía el archivo de firma y lo siguiente:

    gdcloud kms keys asymmetric-verify \
namespaces/NAMESPACE/signingKeys/KEY_NAME \
  --input-file=INPUT_PATH \
  --signature-file=SIGNATURE_FILE

    Después de ejecutar el comando, verás el resultado Verification OK si se ha completado correctamente. Si no se resuelve correctamente, verás el resultado del error Verification Failure.