Integrating with Azure API Management

This feature is available with Invicti API Security Standalone or Bundle

Integrating Azure API Management with Invicti Enterprise allows you to fetch Swagger2 and OpenAPI3 specification files from Azure API Management and provide them as inputs to our DAST scanners. The imported specification files are used to build an inventory of API endpoints that can be scanned for vulnerabilities.

Before setting up the Azure API Management integration in Invicti Enterprise, you need to register Invicti Enterprise as an app in Microsoft Azure and add permissions and secrets. Follow the steps below in each section to prepare your Azure app for integration with Invicti Enterprise.

Step 1: Register your Invicti Enterprise app in Azure API Management

1. In Microsoft Azure, select App registrations.

2. Select New registration.

3. Enter a name for the application and set who can see this application or access this API in the Supported account types section.

4. Select Register to complete the registration.

You have now registered your application. The next step is to add it as a member and assign a role.

Step 2: Add your application as a member and assign a role

1. After app registration is completed, go to the home page and select API Management services.

2. Select one item from the list of API Management services.

3. In the new window, select Access control (IAM).

4. Select the Role assignments tab.

5. Use the Add button to add a new role assignment.

6. In the Members tab, click Select members.

7. Search for the application you created earlier, click on it to select it, then click Select at the bottom of the page.

8. On the Role tab, use the search field to search for API Management Service Reader Role Read-only access to service and APIs.

9. Select the Job function role of API Management Service Reader Role/Read-only access to service and APIs, and click Review + assign.

10. You are taken to the Review + assign tab, click the Review + assign button.

The application has been added to your API Management Service. Continue with the steps in the next section to set permissions.

Step 3: Add permissions

1. Return to the home page and select App registrations. Click the All applications tab, then select the app you created earlier.

2. Select Manage > API permissions from the left-side menu.

3. Click Add a permission and select Azure Service Management.

4. Under Permissions, select the user_impersonation checkbox, then click Add permissions.

After adding the permissions, you need to create a secret for the app to prove its identity. Continue with the steps listed in the following section.

Step 4: Add a client secret

1. Staying within the same application you created earlier (App registrations > All applications > click on your app), select Manage > Certificates & secrets from the left-side menu.

2. Select New client secret.

3. Enter a description and expiry date, then click Add.

4. Use the copy buttons to copy both the Value and the Secret ID of the client secret. Paste the information in a location where you can access them later as you will need them in step 5 when configuring the import source in Invicti Enterprise. Copying this information now is important as it can only be viewed at this step.

You now have the necessary information to set up the API integration in Invicti Enterprise. Continue with the instructions in the next section.

Step 5: Configure the API import source in Invicti Enterprise

1. Log in to Invicti Enterprise.
2. Select APIs > Sources from the left-side menu.
3. Click Add new source.

4. Enter a Name for the API integration and select Azure as the source type.
5. The Client Id, Client Secret, and Tenant Id can be found in Azure Service Management in App registrations > Overview.

6. Click Authenticate and Save.

Your Azure API Management integration is now displayed on the APIs > Sources page.

Step 6: Synchronize the API import

1. On the APIs > Sources page in Invicti Enterprise, click the sync icon to start importing your API specification files from Azure API Management into your Invicti Enterprise API Inventory.

2. When the sync is complete, your API specification files will be displayed on the API Inventory page in Invicti Enterprise. From this page, you can link your API specification files to targets so they can be scanned for vulnerabilities. For more information, refer to Linking and unlinking discovered APIs to targets.

Azure is now integrated with Invicti Enterprise. After the initial synchronization, the integration will automatically sync your API specifications once every 24 hours.