Exercise - Set up CSRD template and configure Microsoft Purview connector

Completed

In this exercise, you set up the Corporate Sustainability Reporting Directive (CSRD) template in Microsoft Purview Compliance Manager. Next, you configure a Purview connector to import data from Sustainability data solutions in Fabric.

Prerequisites

Ensure you computed the Environmental, Social, and Governance (ESG) metrics as mentioned in the previous module Compute ESG Metrics for Audit Disclosures.

Review CSRD template

  1. Open the new browser and go to Microsoft Purview portal. Sign-in with your tenant admin credentials.

    Note

    Make sure that you are on the new Microsoft Purview portal.

  2. If prompted, select Get started.

    Screenshot of get started option.

  3. From the left navigation pane, select Solution > Compliance Manager.

  4. This action opens the Regulations tab in Microsoft Purview Compliance Manager. Search for and select the Corporate Sustainability Reporting Directive (CSRD) template.

    Screenshot of corporate sustainability reporting directive template.

  5. In the Corporate Sustainability Reporting Directive (CSRD) page, select the Controls tab to view all the ESRS standards.

  6. Select a control family, such as E1 Climate change, to view the controls, or disclosure requirements, of the reporting standard.

    Screenshot of controls tab with E1 Climate change selected.

  7. Select a disclosure requirement, such as Gross Scopes 1, 2, 3 and Total GHG emissions. View the disclosure details on the Improvement actions tab.

  8. Select the disclosure detail title, such as E1-6_31, to view the description. The description helps you to understand the data that is required for the disclosure details.

    Screenshot of E1-6_31 page with data for the disclosure details.

For more information about Microsoft Purview Compliance Manager templates, go to Learn about regulations in Compliance Manager. For more information about terminology used in Microsoft Purview Compliance Manager, go to the Compliance Manager glossary of terms.

Configure a Purview connector

In this task, you configure a Purview connector to import data from Sustainability data solutions in Fabric. The connector instance reads the metric extract files from the specified OneLake folder path, and then it transforms and updates the metrics data to Microsoft Purview Compliance Manager.

Register an application with Microsoft Entra ID and create a service principal

  1. Sign in to the Microsoft Entra admin center with your admin tenant.

  2. Select Identity > Applications > App registrations then select New registration.

  3. Name the application, for example DataSolutions.

  4. For supported account type, select Accounts in this organizational directory only (only - Single tenant).

  5. Leave the Redirect URI field empty.

  6. Select Register.

    Screenshot of Register an application page with the Register button highlighted.

    You created your Microsoft Entra application and service principal.

  7. In the Overview tab of your DataSolutions app, copy the Application (client) ID and make note of it.

  8. From the left navigation pane, select Certificates & secrets.

  9. Select Client secrets > New client secret.

  10. Enter the description, retain the default expiration, and then select Add.

    Screenshot with the Add button selected.

  11. Copy the new client secret (Value) and make note of it for future use.

    Warning

    You won’t be able to retrieve the secret later, so make sure that you make a copy of it without fail.

Configure workspace settings

  1. Navigate to your Sustainability Data Solutions workspace in Microsoft Fabric.

  2. Select Settings in the upper-right corner and then select Admin portal.

  3. In the Tenant settings section, go to Developer settings.

    Screenshot of Tenant settings page with Developer settings highlighted.

  4. Enable the Service principals can use Fabric APIs permission for The entire organization.

  5. Select Apply.

    Screenshot with the fields and Apply button selected.

Assign permissions to app identity

  1. On your Sustainability Data Solutions workspace Home page, select the ellipsis (...) next to ComputedESGMetrics lakehouse.

  2. From the More options menu, select Manage permissions.

    Screenshot of manage permissions page.

  3. Select Add user.

  4. On the Grant people access page, select User, select the checkboxes next to Read all Apache spark, Read all SQL endpoint data, and Build reports on the default semantic model permissions and select Grant.

    Screenshot of grant-people-access.

  5. Go back to your Sustainability Data Solutions workspace Home page. From the upper-right corner, select Manage access.

  6. In the Manage access pane, make sure that your tenant admin is listed as an Admin. If not, add it as an Admin.

  7. Select + Add people or group.

  8. Search for your DataSolutions app identity and assign Admin role to it.

    Screenshot showing the datasolutions selected and Admin role assigned.

Set up Data Connector Admin role

  1. Navigate to the Home page of Microsoft Purview portal, and then select View all solutions.

    Screenshot of Home page with the view all solutions selected.

  2. Select Settings.

  3. Select Roles and scopes > Role groups.

  4. Select Create role group.

  5. Enter Custom group in the Name field and select Next.

    Screenshot of custom group field and Next button highlighted.

  6. Select Choose roles and then select Data Connector Admin role.

  7. Select Next.

  8. On the Add members to the role group page, select User, and then select Next.

  9. Review the role group and select Create.

  10. Select Done.

Enable audit logging

  1. Select Solutions from the left pane and then select the Audit.

    Screenshot showing the solutions and audit option selected.

  2. If auditing isn't turned on for your organization, a banner is displayed prompting you to start recording user and admin activity.

  3. Select the Start recording user and admin activity banner.

  4. Select Yes on the Complete organizational setup dialog.

    Screenshot showing the complete organizational setup dialog.

It might take up to 60 minutes for the change to take effect.

Configure a Purview connector

  1. On the left pane, select Settings.

  2. Select Data connectors > All connectors in the left navigation.

  3. From the Connector list view, select the Sustainability Data Solution connector.

    Screenshot with sustainability data solution connector selected.

  4. On the Sustainability Data Solution connector page, select Add connector.

    Screenshot of sustainability data solution connector page with add connector.

  5. View and accept the Microsoft Terms of service.

  6. Next, enter DataSolutions in the Name field and select Next. Note this name as you need the connector instance name later to link the connector instance to the Compliance Manager assessment.

    Screenshot of sustainability data solution name.

  7. On the Specify Data store details page, specify the folder path where the metric extract files are stored in the Lakehouse.

    • To get to the file path of the Lakehouse, navigate to Microsoft Fabric tab, select ComputedESGMetrics Lakehouse in your ESG data estate.

    • Expand the ReportingData folder and then select the ellipses next to the 2022 folder.

    • Select Properties.

    • Copy the URL and paste it in the File path field on Data connector widget of Compliance Manager.

      Screenshot of properties URL.

  8. Paste the Organizational unit ID on Data connector widget of Compliance Manager. Select Next.

    Screenshot of organizational unit ID on Data connector widget.

  9. Specify the Application (client) - ID and Secret (Value) of the app identity that you created in the first task and then select Validate connection.

    Screenshot of autentication validate connection selected.

  10. When the connection is validated, select Next.

  11. Review the connector details and then select Finish.

  12. Select Done. The connector instance is configured and visible under My connectors section.

    Screenshot of My connectors section with the data connectors.