To create a connection to your system, follow these steps:
- Navigate to Settings
> Data Ingestion > Connections.
- In the top-right corner, click New connection, find your system, and click Connect.
General configuration
In the general connection configuration step:
- Name your connection for easier identification in Dawiso. Use a unique and descriptive name like the combination of the server name and your local environment naming (e.g.,
server1_prod). - Provide a description (purpose of the connection).
- Select a Connection type.
- Shared: Source is accessible from the public internet and you can share your credentials with Dawiso.
- Private: Source is not accessible from the public internet and you cannot share your credentials with Dawiso. For more information, see the Create a private connection article.
- Click Next.
Account authentication
In the account authentication step, provide the following information:
- Tenant ID: The ID of your organization. Find it in your Azure portal > Microsoft Entra ID > Properties > scroll down to the Tenant ID section.
- Service Principal authentication credentials: Obtained in Prepare for Power BI integration.
- Client ID: Unique ID of your application created in Azure and registered as a service principal for the Power BI Admin API.
- Client Secret: Client secret to your client ID, generated in the Azure portal.
User configuration
Alternatively, you can use a user account instead of a service principal account (see the previous section) to scan your metadata.
Provide your
- User Name: Login for your Power BI user account.
- Password: Password to your login.
Optional and additional settings
Configure Optional and Additional Settings for your connection. These settings are fully optional:
- Optional settings: Specify options supported by the provider in JSON format.
- Additional Settings: Recommended to leave empty unless our Dawiso support team suggests otherwise. Here, you can add a JSON formatted list of additional settings for troubleshooting or advanced connection configuration.
When adding optional settings, make sure the value is in a valid JSON.
Test and save connection
If your connection is shared, click on Test connection and wait for a few seconds.
- If successful, there will be a green checkmark next to the button.
- In case of failure, there will be a red error icon. Hover over it for a detailed error message. For more information, see the troubleshooting section. You are still able to save your connection.
If your connection is private and you used dummy credentials, the connection test will fail.
Finally, Save the connection and proceed to the next step: using the connection to create a data source. During this process, you will specify what metadata to ingest.