Click on Add New Source at the top-right of the page.
Choose a source system type from:
Each source system type will have its own required fields.
Loome Integrate, Monitor and Assist will need the following two sections to connect, ‘Configuration’ and ‘Tenant and API Key selection’.
Provide the name of the source system.
Choose an agent from the dropdown that will be able to access this source system.
Choose the log level of ‘Information’ or ‘Debug’. Information will provide a general level of logs for a sync, while debug will provide further logs.
Choose whether to enable notifications for this source system.
Choose to enable or disable this source system.
If you disable a source system, Loome will not remove your assets, but it will not attempt to sync new and updated items until you enable it again.
Choose the tenant of your source system that you want to source your assets from.
Choose the API Key from the dropdown or create a new API Key.
Azure Data Factory and Power BI will need additional fields to connect to these sources.
You will also need to complete the Configuration section, but you will also need to provide authentication and other fields.
Choose whether you want to authenticate via ‘Service Principal’, ‘System Assigned’, or ‘User Assigned’ by selecting it from the tabs at the top of the authentication section.
To connect to your Azure Data Factory via Service Principals, please provide your Tenant Id, Client Id and Client Secret.
This will provide the accessible subscriptions and factories in the next dropdown. Learn more about service principals here.
Choose your Subscription from the dropdown.
Choose your Factories from the dropdown.
You will need to have configured a managed identity of System Assigned in Azure for the Loome Agent that will be used with this source system.
Learn more about configuring Managed Identity in Azure here.
The Loome agent selected for this source system will provide your available options in the dropdowns below.
Choose your Subscription from the dropdown.
Choose your Factories from the dropdown.
You will need to have configured a managed identity of User Assigned in Azure for the Loome Agent that will be used with this source system. Learn more about configuring Managed Identity in Azure here.
The Loome agent selected for this source system will provide available options in the dropdowns below.
Provide the Managed Identity Client Id.
Choose your Subscription from the dropdown.
Choose your Factories from the dropdown.
Choose to Exclude Set Variable Activities? This will exclude any set variable activities associated to a copy activity from being synced in when set to ‘Yes’.
Choose an Asset Variable Name. If you provide a name in this field, it will replace the copy activity name and the job instance name.
You can add Additional Variables by providing the variable and then clicking on Add beside it. These are the other pipeline variables in any set variable activity, and they will be shown as metadata on the detail page.
Choose whether you want to authenticate using a ‘Service Principal’ or ‘Username & Password’ by selecting it from the tabs at the top of the authentication section.
You can use an Azure Service Principal, providing the Client Id and Secret.
Choose to Retrieve these values from Azure KeyVault?
This will retrieve authentication values from Azure KeyVault at runtime for the service principal. It requires a managed identity.
Provide your Tenant Id.
Provide your Client Id.
Provide your Client Secret.
You can use a Power BI Username and Password, in conjunction with an Azure App Registration.
Choose to Retrieve these values from Azure KeyVault?
This will retrieve authentication values from Azure KeyVault at runtime for the service principal. It requires a managed identity.
Provide your Tenant Id and Client Id.
Provide your Power BI Master Account Username (UPN)*.
Enter your Power BI Master Account Password*.
Choose whether you want to enable embedding via Do you want to enable embedding?. If enabled, assets will be available to view in the Portal. Otherwise, you will be directed to the source system to view the asset.
You can then choose what you want to import from the workspace or app.
Choose your Workspace Import Settings and what types of asset you would like to import from workspaces.
You can choose the types of assets you would like to import from apps using the App Import Settings.