After reading this article, you will learn how to:
- Embed PowerApps on your Sharepoint On-Premises Site.
- Embed PowerApps from a separate tenant on your SharePoint Online Site.
If you only want to embed PowerApps applications hosted in the same tenant as your SharePoint Site, follow this article.
Prerequisites:
1. ShortPoint Designer Account: Make sure you are logged in with your ShortPoint Designer Account.
2. Permissions on the PowerApps application: Make sure that the PowerApps application is shared with you. Also, the app should be shared with any user that will have access to the page where the app is embedded.
3. License to run PowerApps: Any user that wants to access PowerApps applications (stand-alone or embedded) requires a PowerApps license. For more details about PowerApps licensing follow this article.
4. Set PowerApps as an allowed embed source in SharePoint: If you are a site Administrator, go bellow and follow Step 1 to add "powerapps.com" in the list of allowed domains in your SharePoint Site. Otherwise, work with your site administrator to ensure that the setup is done accordingly.
SharePoint On-Premises Prerequisites:
1. If your SharePoint On-Premises is integrated with Azure Active Directory (AAD), you can embed and run PowerApps hosted in your AAD tenant, into your SharePoint On-Premises Sites. Make sure the PowerApps Application has been shared with your AAD account and also with all the users that will have access to the page where you embed the app.
2. If your SharePoint On-Premises is not integrated with AAD, you still can embed and run PowerApps (hosted on any tenant), from your SharePoint Pages, but you will be prompted to Sign in to the tenant where the app is hosted.
The second option requires that each user that has access to the page where the PowerApps app was embedded to have a separate account to log in on the tenant where the PowerApps app is hosted.
SharePoint Online Prerequisites:
1. If you wish to embed a PowerApps application hosted in a separate tenant, your account from the home tenant needs to be added as guest user on the separate AAD tenant. This enables inviting external business partners, contractors, and third parties like you, to run other company’s canvas apps. Also, each user that will run the embedded app should have guest access on the tenant where the app is hosted.
STEP 1: Allow PowerApps domain in your SharePoint Site
Depending on your SharePoint site settings, you may get an error that embedding content from PowerApps website is not allowed. To work around this, please go to the Site Settings of your Site Collection. Under the Site Collection Administration, click HTML Field Security. Make sure you that "powerapps.com" in the list of allowed domains.
STEP 2: Insert PowerApps Element
Place the cursor into the desired space on your page and open the ShortPoint Page Builder. Choose PowerApps from the list of design elements. You will see the setting of the element opened.
Step 3: Get the PowerApps Canvas Application ID from the PowerApps Platform Where Your App Is Hosted.
If you are trying to embed an app into a SharePoint On-Premises Site integrated with AAD, you can Sign-in to PowerApps Portal (with your AAD account). Make sure you select the Environment where your application is hosted, go to the details of your application and get the App ID.
In case you have only a guest account on the tenant where the PowerApps app is hosted, you have to ask the owner of the PowerApps app (from the separate tenant) to provide you the App ID of the application you want to embed.
Step 4: Get the ID of the Tenant Where Your PowerApps Application Is Hosted
In case you have only a guest account on the tenant where the PowerApps app is hosted, you have to ask the AAD Admin from the separate tenant to provide you the tenant ID.
If you are trying to embed an app into a SharePoint On-Premises Site integrated with AAD, Sign-in to the Azure portal with your AAD account. In the Microsoft Azure Portal, click Azure Active Directory. Under Manage, click Properties and get the Tenant ID from the Directory ID box.
In case you don't have access to the Azure Portal, you have to ask AAD Admin to provide you the tenant ID.
Step 5: Configure your PowerApps ShortPoint element with the PowerApps ID and Tenant ID
Go to the Settings of your PowerApps Element from STEP 1. On the Settings tab, insert the App ID provided in the SET 2 in the PowerApps ID box. Then, go to the Advanced Settings tab and insert the Tenant ID in the corresponding box.
Step 6: Save the page and switch to render mode
That's it!
Related articles: