Installation Instructions

Download Prerequisites

• Download and install power bi desktop
• Download the Power BI SafetyChain connector, link below

SafetyChain V3.1.0.pqx

📘

Note:

Starting with version 3, the SafetyChain Power BI Connector is not backward compatible with previous versions.

Upgrading will require rebuilding existing queries from scratch. While this requires some initial effort, it establishes a stronger and more resilient foundation for future enhancements.

End of Support: Beginning April 2026, versions prior to version 3 will remain operational and supported for current use; however, they will not receive new features or enhancements. SafetyChain plans to transition these versions to end-of-life within 3–6 months, and clients are strongly encouraged to upgrade.

We appreciate your patience and understanding as we implement these improvements.

Installation

To install the file to your Power BI Desktop application follow these steps:

1. Take the downloaded SafetyChain V3.1.0.pqx file and move it to the following location .\Documents\Power BI Desktop\Custom Connectors

📘

Note:

If the above directory does not exist, create the following aforementioned folder structure in your Documents directory:

Power BI Desktop > Custom Connectors

Note: If your Documents folder is synced to OneDrive, place the directory there instead.

If an earlier version of the connector is already present, remove or rename the extension before proceeding.

After adding the file, there are two installation options:

• Option 1 (Recommended): Install the certificate thumbprint to verify the connector is from a trusted source.
• Option 2 (Not Recommended): Update your security settings to allow extensions to load without validation or warning.

Adding the Certificate Thumbprint (Recommended)

📘

Note:

As of SafetyChain Connector V2.1.1, the self signed certificate signing has been replaced with a SafetyChain Trusted Certificate. We recommend all tenants using the connector upgrade and install the newest version.

This process involves adding the thumbprint to your registry to allow Power BI desktop to load with the recommended security settings. For more details see this Microsoft link.

2. Open your Registry Editor

3. Navigate to the following directory - HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Power BI Desktop

📘

Note:

If the directory doesn't exist please add it under HKEY_LOCAL_MACHINE\Software\Policies\Microsoft adding the folder Power BI Desktop.

4. Next Right Click the Power BI Desktop directory > New > Click Multi-String Value then name the file TrustedCertificateThumbprints

5. Right click the TrustedCertificateThumbprints and click Modify... (Or double click)

6. Add the following thumbprint - 4463264D541AFB35948CB684FA2B79B00CF148D9

   

📘

Note:

You can add multiple certificates by using \0 as a delimiter, or in the Registry Editor, right-click key, then select Modify to put each thumbprint on a new line.

Update Security Settings in Power BI Desktop (Not Recommended)

📘

Note:

Do not follow this part if you completed Option 1. This should only be done if your security policies will allow it and cannot complete Option 1 and is needed for testing.

2. Open the PowerBI Desktop Application, then navigate to to File > Options and settings > Options > _Security_then under Data Extensions check Allow any extension to load without validation or warning

3. Close the Power BI Desktop Application and re-open it to ensure changes have taken effect.