Preparing webhook deployment

Once you've created your webhook endpoint, you can set it up in the Indent dashboard.

For change management webhooks

1. Sign into your Indent space.
2. Go to your configuration.
3. Expand the "Webhook Output" and enter your "Webhook URL" and turn off the "Testing Mode" option.
4. If you set any authorization headers, you can add them under "Headers" to include in requests. (Recommended)
5. Click "Save" in the top right.

In September 2021, Admins can add and manage change management webhooks like they can for pulling updates.

For pull update webhooks

1. Sign into your Indent space.
2. Go to the webhooks page.
3. Click "New" and select the kind of webhook you'd like to create.
4. Update the signing secret in your deployed endpoint and enter the webhook URL.
5. Once you've successfully deployed your webhook, disable "Testing Mode" and try making a request.

This section will be expanded to provide more guidance on best practices when deploying a webhook.

Deploying on AWS

• Select the AWS account where you'd like to deploy the webhooks.
• Create an AWS IAM user and credentials to use for deployment.

Deploying on Google Cloud

• Select the Google Cloud project with the required APIs enabled:
  • Google Cloud Functions API
  • Google Cloud Build API

Choose an authentication method

CLI

Log in to Google Cloud SDK from the command line:

gcloud auth application-default login

Follow the prompts to log in to your Google Cloud SDK Account. Then,configure the project you want to use to deploy Indent webhooks:

gcloud config set project my-project

Service Account

Create a Google Cloud Service Account.

After you create the service account, create a JSON Service Account Key:

• Select a project
• Click the email address of the service account you want to create a key for.
• Click the "Keys" tab.
• Click the "Add key" dropdown, then select "Create new key."
• Select "JSON" as the "Key Type" and click "Create."
• Save the key to terraform/secrets/terraform-deploy-key.json in your Indent webhook folder.

Example key format

{
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "key-id",
  "private_key": "-----BEGIN PRIVATE KEY-----\nprivate-key\n-----END PRIVATE KEY-----\n",
  "client_email": "service-account-email",
  "client_id": "client-id",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/service-account-email"
}