Skip to main content

Cross4Security

To integrate the Microsoft Azure provider to use the Cross4Report service you are required to perform some operations in Microsoft Azure. The images attached below will guide you. Please follow the instructions below.

1. Subscription Adding​

info

If you don't have a subscription for your Azure account, you need to first add a subscription. You can follow the steps below. However, if you already have a subscription, you can skip this section.

  1. Go to Azure Portal and log in to your account.

  2. Go to the search bar and look for Subscriptions, then choose Subscriptions under Services.

Show the instructions with images

Azure Step 2

  1. Click on the Add button located at the top.
Show the instructions with images

Azure Step 3

  1. Choose the offer that suits you and proceed.
Show the instructions with images

Azure Step 4

  1. After selecting the appropriate offer, follow the steps on the page directed by Azure. After creating your profile, complete the process by verifying your identity with card authentication.

2. App Registration​

  1. Go to Azure Portal and log in to your account.

  2. Go to the search bar and look for App registrations, then choose App registrations under Services.

Show the instructions with images

Azure Step 2

  1. Click New Registration on the top.
Show the instructions with images

Azure Step 3

  1. Fill up the given inputs (name and supported account types) and click Register.

    note

    You can choose a proper Supported Account Type as your need.

    warning

    Keep the name information you will need it later.

Show the instructions with images

Azure Step 4

  1. You will be navigated to a page that contains your Application (client) ID and Directory (tenant) ID.

    CRITICAL STEP

    Keep your Application (Client) ID and Directory (Tenant) ID accessible, as you will need them as credentials for performing operations in our console.

Show the instructions with images

Azure Step 5

  1. Click Certificates & Secrets from the Manage section in the left-hand menu.
Show the instructions with images

Azure Step 6

  1. Create a client secret by clicking on the New client secret button. After providing a description for your client secret, proceed to click the Add button. Choosing the longest possible duration for the "expires" option is important.

    CRITICAL STEP

    After clicking the Add button, you will see your Value on the same page. Copy it and keep it accessible, as you will need it as a credential for operations in our console.

Show the instructions with images

Azure Step 7

3. Getting Subscription ID​

  1. Go to the search bar and search for Subscriptions, then click Subscriptions under Services.
Show the instructions with images

Azure Step 1

  1. After opening the page, copy your Subscription ID somewhere accessible for future reference.

    CRITICAL STEP

    Make sure to copy your Subscription ID and keep it accessible, as you will need it as a credential for operations in our console.

Show the instructions with images

Azure Step 2

4. Role Assignment​

In this step, you will assign the necessary roles to the app you registered earlier. To ensure proper permissions, assign the following roles:

  • Reader
  • Reader and Data Access

These roles are essential for enabling the app to access required resources and perform specific tasks. To assign these roles to the app, follow the instructions below.

  1. Click Access Control (IAM) in the left menu under your subscription, then click the Add button at the top of the page and select Add role assignment.
Show the instructions with images

Azure Step 1

  1. Click Job function roles under the Role tab.
Show the instructions with images

Azure Step 2

  1. Then search for the Reader role and select it from the list. Afterward click Next button.
Show the instructions with images

Azure Step 3

  1. You should be navigated to the Members tab. In that section click +Select members.
Show the instructions with images

Azure Step 4

  1. Search for the name of your app which we registered at App Registration. Then click Select button.
Show the instructions with images

Azure Step 5

  1. Afterward click Next button, which located bottom of the page. You must be navigated to Conditions tab.
Show the instructions with images

Azure Step 6

  1. For getting the required permissions, please select 'Allow user to assign all roles' option for What user can do section.
Show the instructions with images

Azure Step 7

  1. Click Review + assign button.
Show the instructions with images

Azure Step 8

You must get an notification that says Added Role assignment.

Critical Step

Ensure that the Reader and Reader and Data Access roles are assigned correctly.

5. Administrative Role Assignment​

  1. Click the search bar and seacrh for Microsoft Entra ID.

  2. Under Services click Microsoft Entra ID.

Show the instructions with images

Azure Step 1-2

  1. In the opened page, select Roles and Administrators from the Manage section in the left-hand menu.
Show the instructions with images

Azure Step 3

  1. After entering the Roles and Administrators section, locate Application Administrator role in the list in front of you and click on it.
Show the instructions with images

Azure Step 4

  1. Click on the Add Assignments button located at the top.
Show the instructions with images

Azure Step 5

  1. In the opened section, you need to find and select the application you previously registered. (The application we registered at App Registration step.)

    CRITICAL STEP

    Please search for the name of the application in the search bar for this process. It will not appear if you try to find it manually.

  2. After finding your app, click on it and select it.

Show the instructions with images

Azure Step 6-7

  1. Finally, click on the Add button.
Show the instructions with images

Azure Step 8

6. Resource Provider Enabling​

It’s important to ensure that specific providers are registered within your subscription. Verify their registration status and register them if needed. The following providers should be registered:

  • Microsoft.DataFactory
  • Microsoft.SignalRService
  • Microsoft.AppConfiguration

To register these providers, follow the instructions provided below.

  1. Go to the search bar and look for Subscriptions, then choose Subscriptions under Services.
Show the instructions with images

Azure Step 1

  1. Click on the subscription you selected when obtaining your credentials.

  2. In the side menu, go to Settings, then click Resource Providers.

Show the instructions with images

Azure Step 3

  1. In the Resource providers menu, you can use the search bar or scroll down to locate the Microsoft.DataFactory provider.

  2. After finding the relevant providers, check the status tab to verify whether the provider is registered for the subscription.

Show the instructions with images

Azure Step 4-5

  1. If the provider is not registered, after clicking on it, select the Register button located at the top to register the provider.
Show the instructions with images

Azure Step 6

  1. Wait for the registration process to complete. This may take a few moments.

After changing the status of the relevant provider to Registered, you can proceed with the remaining steps.

Critical Step

Ensure that the Microsoft.DataFactory, Microsoft.SignalRService, and Microsoft.AppConfiguration providers are registered correctly.

warning

Please note that you may require the necessary permissions or roles to register a resource provider in your Azure subscription. If you do not have the required permissions, you may need to reach out to your Azure administrator or the person responsible for managing your Azure subscription.