Step 2: Create the Azure AD app registration

Recap You have downloaded the Terraform template declaring the Azure Active Directory (AD) application registration, federated identity credential, and service principal for Snyk. Now you need to provision the infrastructure.

To scan an Azure subscription, Snyk takes the permissions of a service principal with a Reader role that allows Snyk to scan the configuration of your subscription resources.

Additionally, Snyk has a security feature that locks the federated credential for a subscription and tenant to the Organization that onboards it. This ensures that nobody can guess the credential's name and onboard it into a separate Organization to see those resources.

Create the infrastructure with Terraform or the Azure CLI

You can create the app registration, federated identity credential, and service principal using one of the following tools, according to the type of file you downloaded from Snyk:

  • Terraform: Terraform CLI

  • Bash: Azure CLI, installed locally or accessed via Cloud Shell

Create Azure app registration infrastructure using Terraform

Before you use the Terraform CLI, ensure you configure it to use your Azure credentials. Your user must have either the Application Administrator or Global Administrator directory role. This is required to create the federated identity credential and service principal via Terraform.

  1. In your terminal, navigate to the directory containing the Terraform file you downloaded (named snyk-permissions-azure.tf if downloaded from the Snyk Web UI).

  2. Using the Terraform CLI, initialize the Terraform Project:

terraform init
  1. Review and apply the Terraform plan:

terraform apply
  1. Enter yes when Terraform asks if you want to perform the actions.

Terraform then provisions the infrastructure. When it is finished, you will see the following output:

Apply complete! Resources: 4 added, 0 changed, 0 destroyed.

Outputs:

application_id = 12345678-9012-3456-7890-12345678abcd

Copy the application ID for use in the next step.

Create Azure app registration infrastructure using the Azure CLI

If you use the Azure CLI locally, ensure you have logged in with az login first. This step is not necessary when you are using the CLI in the Azure Cloud Shell.

  1. In your terminal or in the Cloud Shell, navigate to the directory containing your .sh file.

  2. Make the Bash script executable using the chmod command:

chmod 755 snyk-permissions-azure.sh
  1. Run the script:

./snyk-permissions-azure.sh

The Azure CLI then creates the AD app registration, federated identity credential, and service principal. When it is finished, you will see JSON output with information about the created infrastructure.

Copy the application ID, the last item in the output:

{
  "application_id": "12345678-9012-3456-7890-12345678abcd"
}

Copy this application ID for use in the next step.

What's next?

The next step is to create and scan the Cloud Environment. See Step 3: Create and scan a Cloud Environment for Azure (Web UI).

Last updated

More information

Snyk privacy policy

© 2023 Snyk Limited | All product and company names and logos are trademarks of their respective owners.