Microsoft Fabric OneLake Sources > Before you begin > Create a connection
  

Create a connection

Before you configure the Microsoft Fabric OneLake catalog source, create a connection object in Administrator.
Use the Microsoft Entra ID service principal, formerly known as Azure Active Directory, to create a Microsoft Fabric OneLake connection in Administrator.
To use an external secrets manager to connect to the source system, use one of the following authentication tools:
    1In Administrator, select Connections.
    2Click Add Connection.
    3Search for and select Microsoft Fabric OneLake and then click Next.
    4Enter the following connection details:
    Property
    Description
    Connection Name
    Name of the connection.
    Each connection name must be unique within the organization. Connection names can contain alphanumeric characters, spaces, and the following special characters: _ . + -,
    Maximum length is 255 characters.
    Description
    Description of the connection. Maximum length is 4000 characters.
    Use Secret Vault
    Stores sensitive credentials for this connection in the secrets manager that is configured for your organization.
    This property appears only if secrets manager is set up for your organization.
    When you enable the secret vault in the connection, you can select which credentials that the Secure Agent retrieves from the secrets manager. If you don't enable this option, the credentials are stored in the repository or on a local Secure Agent, depending on how your organization is configured.
    Note:
    If you’re using this connection to apply data access policies through pushdown or proxy services, you cannot use the Secret Vault configuration option.
    For information about how to configure and use a secrets manager, see Secrets manager configuration.
    Runtime Environment
    The name of the runtime environment where you want to run the tasks.
    Select a Secure Agent, Hosted Agent, or serverless runtime environment.
    Workspace Name
    Name of the workspace in Microsoft Fabric OneLake.
    Workspace name cannot contain special characters or spaces.
    Lakehouse Path
    Path or name of the lakehouse present in the workspace.
    You can specify the path in one of the following ways:
    • - root directory (/) to access the files in the workspace.
    • - lakehouse name/Files to access the files present in the lakehouse.
    Authentication Type
    Authentication type to access Microsoft Fabric OneLake.
    Service Principal Authentication uses the client ID, client secret, and tenant ID to connect to Microsoft Fabric OneLake.
    Client ID
    The application ID or client ID of your application registered in the Azure Active Directory.
    Client Secret
    The client secret of your application registered in the Azure Active Directory.
    Tenant ID
    The ID of the Azure Active Directory instance in which you created the application.
    Microsoft Fabric OneLake Endpoint
    The type of Microsoft Fabric OneLake endpoint that you want to connect to.
    Default is fabric.microsoft.com.
    5Click Test to test your connection to the source system.
    6Click Save.