SharePoint - Remove TechnoMile's Middleware

Prev Next

Previously, to install the SharePoint connector, middleware was required to be set up on a TechnoMile server. This middleware is no longer required, and we are now upgrading clients to eliminate this dependency.

This article provides instructions to upgrade and reconfigure clients who have TechnoMile's SharePoint connector installed and operational in their Salesforce instance.

Upgrading the SharePoint Connector

To upgrade your existing SharePoint connector:

  1. Open the SharePoint Connector Upgrade link in a browser.
    You will be directed to the Salesforce login page.

    NOTE

    Ensure that only one instance of your Salesforce Org is open in the browser where you want to install this package.

  2. Log in using your Salesforce credentials.
    The Upgrade TM_SFSPSync page appears.

    mceclip0.png

  3. Select Install for All Users and click Upgrade.
    You will receive an email confirmation once the package upgrade is complete.

    NOTE

    This process may take up to 20 minutes.

If you do not receive an email confirmation, you can verify if the package was successfully upgraded by following these steps:

  1. In your Salesforce organization, click the gear icon  Gear icon.png and select Setup.

  2. Use the Quick Find box to search and open Installed Packages.

  3. In the Installed packages list, locate the TM_SFSPSync package.
    Verify that the package version is 24.20.3 or higher.
    Screenshot 2024-08-16 155450.png

Assigning Permission Set

Depending on the previous version of your SharePoint connector, the SharePoint Permissions permission set may already be assigned to your user. Follow the steps below to verify the permissions and assign them if necessary:

  1. In your Salesforce organization, click the gear icon  Gear icon.png and select Setup.

  2. Use the Quick Find box to search and open Users.

  3. In the Users setup page, select a user to whom you want to assign the permission set.

  4. Scroll down to Permission Set Assignments and click Edit Assignments.

  5. From the Available Permission Sets list, select Sharepoint Permissions and add it to the Enabled Permission Sets list.
    Screenshot 2024-08-16 154711.png

  6. Click Save.

Setting up Connection to SharePoint

To set up connection to SharePoint, you will need the Application (client) ID, Directory (tenant) ID, and Client Secret value provided by the Azure application you set up when this connection was initially established.

If you have noted those values from when you provided them to TechnoMile for the middleware setup, you can reuse them to Configure Connection to SharePoint and then Add the Redirect URI in Azure. If not, you will need to first log in to the Azure portal to Retrieve the Application (client) ID and Directory (tenant) ID and then Generate a new Client Secret value before you can configure the connection to SharePoint and add the redirect URI in Azure.

Retrieve the Application (client) ID and Directory (tenant) ID

To obtain application (client) ID and directory (tenant) ID from the Azure portal:

  1. Log in to Azure Portal (portal.azure.com) with your Azure admin credentials.

  2. Navigate to Manage Azure Active Directory > View.

  3. On the left-hand side navigation panel, under Manage select App Registration.

    NOTE

    If you do not see App Registration, go to aad.portal.azure.com.

  4. Locate and open the application that was setup for this .
    Info: The application name is likely to contain TechnoMile or Salesforce.

  5. On the Overview tab, take note of the Application (client) ID and Directory (tenant) ID.
    mceclip3.png

Generate a New Client Secret

To generate a new client secret on the Azure portal:

  1. Log in to Azure Portal (portal.azure.com) with your Azure admin credentials.

  2. Navigate to Manage Azure Active Directory > View.

  3. On the left-hand side navigation panel, under Manage select Certificates & Secrets > Client Secrets.
    Info: You will see your existing secret, but you will not be able to retrieve the secret value.

  4. Click New client secret.

  5. Enter a description and expiration value.
    For example, use TechnoMile SharePoint Secret as the description and set the expiration to 730 days.

  6. Click Add.

  7. Once the client secret is created, copy the Value immediately and save it for later use. You will not be able to view it again once you navigate away from this page.
    mceclip6.png

Configure Connection to SharePoint

To configure the connection between Salesforce and SharePoint:

  1. In your Salesforce organization, open the App Launcher  App launched icon.png.

  2. Use the search field to find and open the SharePoint Admin Panel.

  3. Scroll down to Authentication Settings.

  4. Click the pencil icon pencil icon.png next to Tenant ID, Client ID, and Client Secret to enter the respective Directory (tenant) ID, Application (client) ID, and Client Secret obtained from the Azure portal.

  5. Click the pencil icon  pencil icon.png next to Redirect URI and click the Click here to get Redirect URI link. mceclip11 (1).png

  6. Copy the URL (including 'https://') from the browser tab that opens.

  7. Paste the copied URL in the Redirect URI field.

  8. Click Save.

Adding the Salesforce Redirect URI in Azure

Adding the Salesforce redirect URI in Azure portal ensures that authentication between Azure active directory and Salesforce works smoothly and securely, allowing users to be redirected back to Salesforce after logging in.

To add redirect URI to the Azure portal:

  1. Log in to Azure Portal (portal.azure.com) with your Azure admin credentials.

  2. Navigate to Manage Azure Active Directory > View.

  3. On the left-hand side navigation panel, under Manage select App Registration.

  4. Locate and open the application that was setup for this integration.

  5. On the Overview tab, click Add a Redirect URI.mceclip7.png

  6. Under Platform Configurations, click Add a Platform.

  7. Select Web as the platform type.

  8. Paste the URI copied from Salesforce in the Redirect URIs field.

    NOTE

    Leave the Front-Channel logout URL field blank.

  9. Select the Access tokens and ID tokens checkboxes.

  10. Click Configure.