Azure integration

Create an Azure integration with SuperAnnotate to add items from your Azure storage to SuperAnnotate. SuperAnnotate will have read-only access to your data; your items are stored in your Azure storage and are only displayed in SuperAnnotate.

🚧

Permissions

Only Team Owners and Team Admins can create and manage integrations.

🚧

Enable CORS for Text Projects

You’ll need to enable CORS in your storage to add items in your Text Projects. Learn more.

Step 1: Go to the integrations page

  1. In Integrations, click New Integration.
  2. On the setup page, type the name of your integration under Integration Name.
  3. You can add the integration to a selected team or multiple teams. The integration will be available in the selected team(s) only. Note that this step is optional. If you don’t select a team, then the integration won’t be added to any team. You can always add the integration to a team from the Integrations list.

❗️

Adding or removing a team allows or restricts access to the data related to this integration.

Step 2: Create a storage account

You can create a storage account or use an existing one. If you have an account, skip to Step 3.

  1. Go to your Azure portal.
  2. Under Azure services, select Storage accounts.
  3. Click Create storage account.
  4. Under Project details, choose a subscription and a resource group.
  5. Under Instance details, type a storage account name.
  6. Click Review + create.
  7. Click Create.

Wait for the system to validate your storage account.

Step 3: Enter your storage account name

In the integration setup page in SuperAnnotate, enter your storage account name.

Step 4: Create an Azure container

You can create an Azure container or use an existing one. If you have a container, skip to Step 5.

  1. Go to your storage account.
  2. Under Data storage, select Containers.
  3. Click +Container.
  4. Enter a container name.
  5. Click Create.

Step 5: Enter your container name

In the integration setup page in SuperAnnotate, enter your container name.

Step 6: Register a single-tenant application

  1. In your Azure portal, go home and select App registrations under Azure services.
  2. Click New registration.
  3. Enter your application’s name.
  4. Click Register.

Step 7: Enter the Application (client) ID and Directory (tenant) ID

In the integration setup page in SuperAnnotate, enter the Application (client) ID and Directory (tenant) ID. You can find them in the application you just created.

Step 8: Create a client secret for the registered application

  1. In your Azure portal, go to the Certificates & secrets section of the application you just registered.
  2. Click New client secret.
  3. Enter a description.
  4. Choose when the client secret expires.
  5. Click Add.
  6. Copy the value under Value. Note that client secret values can’t be viewed, except for immediately after creation. Save the secret before refreshing or leaving the page.

Step 9: Enter the client secret value for the registered application

In the integration setup page in SuperAnnotate, enter the client secret value for the registered application.

Step 10: Grant access to the registered application

Grant access to the registered application by assigning the following roles at a particular scope:

  • Storage Blob Delegator in Storage account
  • Storage Blob Data Reader in Container

Storage Blob Delegator in Storage account

  1. In your Azure portal, go home and select Storage accounts under Azure services.
  2. Go to your storage.
  3. Go to Access Control (IAM).
  4. Under Grant access to this resource, click Add role assignment.
  5. Find the Storage Blob Delegator role.
  6. Select Storage Blob Delegator.
  7. Click Next.
  8. Click Select members.
  9. Select the application you just created.
  10. Click Select.
  11. Click Review + assign.

Storage Blob Data Reader in Container

  1. In your Azure portal, go home and select Storage accounts under Azure services.
  2. Go to your storage.
  3. Go to Containers.
  4. Choose your container.
  5. Go to Access Control (IAM).
  6. Under Grant access to this resource, click Add role assignment.
  7. Find the Storage Blob Data Reader role.
  8. Select Storage Blob Data Reader.
  9. Click Next.
  10. Click Select members.
  11. Select the application you just created.
  12. Click Select.
  13. Click Review + assign.

Step 11: Create the integration

In the integration setup page in SuperAnnotate, click Create.

📘

Messages

  • If the integration is created successfully, you'll see this message: You've successfully created the integration.
  • If the integration couldn't be created, you'll see this message: Oh no! The integration couldn’t be created.

📘

Who can create and use integrations?

  • Only Team Owners can create integrations.
  • Only Team Owners, Team Admins, and Project Admins (with permission) can use integrations.
    To allow Project Admins to use integrations, check the Upload box under Project Admin Permissions in Settings.

🚧

Limitations

  • You can't upload more than 50,000 items to the root or a folder. The remaining items will be skipped.
  • A project can't contain more than 500,000 items.
  • A folder name can't exceed 120 characters and can't contain the following characters: / \ : * ? " < > |

Validate integration

To validate your Azure integration:

  1. In Integrations, find your integration.
  2. Click the three dots button.
  3. Select Check connection.
    • If the integration is valid, you’ll see a success message that says: “The connection of the integration “[your integration name]” is valid.”
    • If the integration is invalid, you’ll see an error message that says: “The connection of the integration “[your integration name]” is invalid.”

📘

Messages

  • If the connection is valid, you'll see this message: The connection is valid.
  • If the connection isn't valid, you'll see this message: The connection is not valid.

Edit team

To add or remove an integration to a team or multiple teams:

  1. In Integrations, find your integration.
  2. Click the three dots button.
  3. Select Edit team.
  4. Add or remove teams.
  5. Click Save.

Delete integration

To delete an integration:

  1. In Integrations, find your integration.
  2. Click the three dots button.
  3. Select Delete Integration.
  4. In the popup, click Delete.

📘

Messages

If the integration is successfully deleted, you'll see this message: You've successfully deleted the integration.

📘

Who can delete integrations?

Only Team Owners can delete integrations.

Add items with Azure integration

You can add items from your Azure storage to Image Projects, Video Projects, and Text Projects.

  1. In Data, click Add.
  2. Select Upload Images, Upload Video (with frames), Upload Videos, or Upload Documents (depending on your project type).
  3. Go to External Storage.
  4. In Integrations, choose an integration (mandatory) and type a folder path (optional).
  5. Click Upload.

🚧

Folder paths

Note that when you type in a folder path, all items within that folder will be uploaded. You won't be able to select and choose specific files from the folder.

When you add items from an integrated Azure storage to SuperAnnotate, you can’t:

  • Run Smart Segmentation
  • Run Smart Prediction
  • Create models and run trainings
  • Export in the COCO format
  • Set the upload quality in Settings