If you’d like to make the information in Beekeeper available in your SharePoint or another website without duplicating efforts, you have the option of embedding a Beekeeper stream within that website.

Note:

• iFrame embedding needs to be activated for your Beekeeper tenant before you can use this feature.
• When setting this up in SharePoint, the user must have admin privileges.

Activating iFrame embedding

For security reasons, iFrame embedding is disabled by default in Beekeeper. In order to enable it, in the Beekeeper Admin Dashboard, head to Settings > General > Security, where you can select one of the following options:

• iFrame Embedding is disallowed (default)
• iFrame Embedding is allowed for any domain (insecure)
• iFrame Embedding is allowed for specified domain only

Allowing iFrame embedding for any domain is not recommended. Instead, we suggest whitelisting a single domain.

Embedding Beekeeper into SharePoint

In Beekeeper:

1. Login to Beekeeper on the web app
2. Click on the speedometer symbol in the top right corner to get to the dashboard
3. To the left, select the “Extensions” tab and then select the “Website Embed” subtab
4. From the dropdown menu, select the stream you wish to embed
5. If relevant, edit the configuration parameters in the code, as explained in the box below
6. Copy the code

In SharePoint:

1. Open a SharePoint article
2. Create a new web part
3. Paste the code that you copied from Beekeeper
4. Save the page

Embedding Beekeeper into SharePoint Online

SharePoint Online does not allow the embedding of scripts into modern site pages, in order to protect your content (a malicious script could take over the page, resize its own window over your content, or change the content on the page without your consent).

Should you try to use the Beekeeper embedding code from the admin dashboard, you will receive the error: "This embed code doesn't seem to work. We only support iframe based embeds."

The embedded Beekeeper app resizes itself depending on how much content the user is viewing, to make for a smoother user experience. This is achieved through script injection, which SharePoint Online does not allow.

Embedding Beekeeper as an iframe:

You can add the Beekeeper web app to your SharePoint Online page as a fixed-size iframe, e.g.

<iframe src="https://your-company.us.beekeeper.io" width="800" height="600"></iframe>​

You can change the width and height parameters to suit the layout of your content.

Note: Microsoft by default blocks Single Sign-On within iFrames, which means that users will need active session cookies already (for example, logging in via SSO in a separate tab) before they can view Beekeeper within the iFrame.