Create signatures

This page shows you how to use the Google Cloud signBlob method to create a signature from a string-to-sign or policy document. Signatures are used as credentials in certains requests, such as signed URLs. This guide uses RSA keys for creating signatures.

Important: The Google-managed service account keys used by the signBlob method are rotated regularly. If you set an expiration time for a signature that is greater than 12 hours and generate the signature using the signBlob method, the signature is usable for at least 12 hours, but might stop working prior to the expiration time due to key rotation. Signatures generated using the signBlob method are best used for short-lived access to resources.

Before you begin

1. You must have the iam.serviceAccounts.signBlob permission for the service account that you use in this guide. The iam.serviceAccounts.signBlob permission is included in the roles/iam.serviceAccountTokenCreator role.

2. The service account that you use in this guide must have permission to perform the request encoded within the signature. For example, if the signature will be used to read object data from a bucket, the service account must have permission to read the object data.

Create a signature

1. Have gcloud CLI installed and initialized, in order to generate an access token for the Authorization header.

   Alternatively, you can create an access token using the OAuth 2.0 Playground and include it in the Authorization header.

2. Create a JSON file that contains the following information:

   {
     "payload": "REQUEST_INFORMATION"
   }

   Where:

   • REQUEST_INFORMATION is a string-to-sign or a policy document. For both, content must be base64-encoded.

3. Use cURL to call the IAM API with a signBlob request:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT_EMAIL:signBlob"

   Where:

   • JSON_FILE_NAME is the name of the file you created in Step 2.

   • SERVICE_ACCOUNT_EMAIL is the email address of the service account you want to use to create the signature. For example, [e-mail].

If successful, the signature is returned in the signedBlob field in the response.

What's next

• See the reference page for signing blobs with the Google Cloud CLI.
• Create a signed URL manually, using the signature you created.
• Create a signed URL with Google Cloud tools.
• Learn more about signatures.