Integrations

Integrations are connections to external systems which let you automatically import existing data into Revision. You can set up integrations from the integrations tab in an organization's settings.

Overview

Set up a connection, test it, and sync resources. Select the resources you would like to import, and press "Import to Revision".

Importing

You can import the same resource again to update its Revision component.

Imported components will be marked as such in Revision. When editing an imported component, Revision will inform you that any changes you make will be overwritten by any subsequent imports:

Microsoft Azure

Configuration

To sync resources from from Azure, an App Registration with the Reader permission is required. For Revision to able to use the App Registration and call the Azure API, it needs the following:

  • A Tenant ID,
  • a Subscription ID,
  • a Application (client) ID,
  • and a Client Secret.

Let's create an App Registration and get those values.

Step 1: Sign in to Azure Portal

  1. Go to https://portal.azure.com.
  2. Select Microsoft Entra ID  (formerly Azure Active Directory).

Step 2: Register a New Application

  1. In the Entra ID blade, go to App registrations > New registration         

  2. Enter:

    • Name: AzureResourceReaderApp (or any name you prefer)

    • Supported account types: “Accounts in this organizational directory only”

    • Leave the Redirect URI blank

  3. Click Register       

Step 3: Generate a Client Secret

  1. After registration, open your new app
  2. Go to Certificates & secrets  and add a new client secret
  3. Enter a description (e.g. “Reader secret”) and choose an expiration period
  4. Click Add       
  5. Copy the Client Secret value immediately — this is your generated secret, you won’t be able to see it again later
  6. Copy the Application (client) ID

Step 4: Copy all other values

  1. Navigate back to the Apps overview and copy the Tenant and Subscription IDs

Step 5: Assign Reader Role to the App

Finally, you need to grant the app read access to your Azure resources.

  1. Go to the Azure portal home
  2. Navigate to the subscription you want to read resources from
  3. Open Access control (IAM)  and  Add role assignment         
  4. Under Role, select Reader  and press "Next"
  5. Under Assign access to , choose "User, group, or service principal"
  6. Click Select members , search for your app’s name, and select it
  7. Click "Review + assign"

Resources

Revision will currently import the following types from Azure:

  • API Management
    • API Operation
  • Application Insight
  • Cosmos DB
  • Data Factory
  • Event Grid
  • Event Hubs
  • Function App
    • Function
  • Integration Account
  • Log Analytics Workspace
  • Logic Apps
  • Managed Instance SQL
  • Service Bus
    • Queue
    • Topic
    • Subscription
  • Storage Account
  • Web Apps
  • Virtual Network

The amount of listed resources may as such not be the same as the total resource count in Azure. Revision notes these as "excluded" resources:

Microsoft BizTalk Server

Configuration

A BizTalk integration requires uploading a "binding file." The BizTalk binding file can be exported at both the application and server levels; that is up to you.

Resources

Revision will currently import the following types from BizTalk:

  • Receive Port
  • Send Port

The amount of listed resources may as such not be the same as the total resource count in your binding file.

Related Articles