DEV Community

Jaime López
Jaime López

Posted on • Originally published at intranetfromthetrenches.substack.com

How to Set Up Your Environment for Enabling SharePoint Embedded in 5 Simple Steps

Microsoft instructions might be a bit unclear as it releases documentation at the same time SharePoint Embedded is going through release stages (now, it's in Feature Preview). In this article, I'll walk you through setting up your environment for utilizing SharePoint Embedded.

The guide comprises 5 concise and straightforward steps. It ensures you can execute them with minimal effort:

  • Step 1 - Obtain a Microsoft 365 Tenant Admin Account
  • Step 2 - Obtain an Azure Account
  • Step 3 - Enable Syntex
  • Step 4 - Create a new Resource Group
  • Step 5 - Enable SharePoint Embedded

Step 1 - Obtain a Microsoft 365 Tenant Admin Account

To turn on SharePoint Embedded, you'll require the Microsoft 365 tenant admin account. It's essential to have this. Just reach out to your IT department or the team managing your Microsoft 365 account to get it.

Step 2 - Obtain an Azure Account

To set up the billing for SharePoint Embedded, you'll need an Azure account. This account should have permission to contribute to the Azure Subscription service. Additionally, it must be assigned the SharePoint Administrator role.

Step 3 - Enable Syntex

Activate the Microsoft.Syntex resource provider in your Azure Subscription service. This enables SharePoint Embedded to make calls and requests.

Here are the steps to enable it:

  1. Sign in to the Azure Portal.
  2. Navigate to the Subscriptions tab on the left-hand menu. Azure left-hand menu - Subscriptions
  3. Select the subscription where SharePoint Embedded will be used. Azure Subscriptions list
  4. In the subscription overview, locate and click on Resource providers in the left-hand menu. Azure Subscriptions left-hand menu
  5. In the list of available resource providers, find Microsoft.Syntex and ensure it's enabled. If it's not enabled, click on it and then click Register to enable it. Microsoft.Syntex resource provider
  6. Once enabled, wait a few moments for the changes to take effect.
  7. Confirm Microsoft.Syntex status shows Registered for an effective configuration.

Step 4 - Create a new Resource Group

Establish a dedicated Azure Resource Group to oversee the expenses related to SharePoint Embedded.

Here are the steps to create it:

  1. Sign in to the Azure Portal.
  2. Click on the Create a resource button located in the upper left corner. Azure - Create resource option
  3. In the search bar, type Resource Group and press Enter.
  4. Select Resource Group from the search results.
  5. Click on the Create button to start creating a new resource group. Resource Group service to create
  6. In the Subscription dropdown menu, choose the proper one. This subscription must have Microsoft.Syntex resource provider enabled. Azure Resource Group creation
  7. Enter a unique name for the resource group.
  8. Choose the desired region for the resource group.
  9. Click on the Review + create button to proceed to the next step
  10. Review the details and click on the Create button to create the resource group.

Step 5 - Enable SharePoint Embedded

Access the SharePoint Online Central Administration, and navigate to the Settings option. Then, activate SharePoint Embedded in your tenant.

Here are the steps to enable it:

  1. Go to the SharePoint Online Central Administration.
  2. Sign in with your tenant administrator credentials.
  3. Once logged in, locate and click on the Settings option on the left-hand menu. Microsoft - Settings menu in SPO Central Administration
  4. In the Settings menu, look for the option related to SharePoint Embedded. Microsoft - Settings available options in SPO Central Administration
  5. Click on the option to enable SharePoint Embedded. Microsoft - SharePoint Embedded enablement configuration panel
  6. Save your changes by clicking on the Enable button at the bottom of the page. Confirm the activation of SharePoint Embedded.
  7. SharePoint Embedded functionality takes some time to be enabled in the tenant.

Final thoughts

Following these steps allows you to set up your environment to start developing SharePoint Embedded applications. As you saw, it is as easy as this.

Did you already have your environment ready? Comment it below.

Share with your colleagues if you find it useful.

References

Top comments (0)