Recognize can be embedded in Sharepoint O365, Sharepoint On-Prem, or any intranet, even if that intranet is not publicly accessible on the internet.
Sharepoint O365
For Sharepoint O365, please install our app from the Office Store here: https://appsource.microsoft.com/en-us/product/office/WA104379864?tab=Overview
Sharepoint On-Prem
The following documentation is not for Sharepoint O365 but is for Sharepoint On-Prem and any other intranet. Sharepoint On-Premise is supported if your configuration allows web parts to access external websites, such as https://recognizeapp.com.
To embed Recognize in Sharepoint On-Prem or your intranet:
There are two approaches to embedding Recognize
- OAuth based login
- SAML SSO based login
We recommend SAML SSO because it will give your users a seamless experience, as they will automatically be logged in when they visit your intranet. In the case of OAuth-based login, users will be prompted with a login screen that will take them through an OAuth flow in a new window. Once complete, the page in Sharepoint will automatically refresh to show the desired logged-in page.
We will first describe the SAML SSO case:
SAML SSO Login
Please note: To use this convention, you must set up SAML SSO in the Recognize Company Admin portal
Any URL on Recognize can be embedded following a convention.
https://recognizeapp.com/<account domain>/saml/sso/<url>?viewer=sharepoint&referrer=<sharepoint host>
Using this convention, you will need to replace <account domain>, <url>, <sharepoint host> with specific values for your account.
<account domain> is usually your email domain and can be found in most URLs in Recognize. For instance, if your email was bob@conteso.com and when you accessed the Recognize stream page, the URL is: https//recognizeapp.com/conteso.com/recognitions, then your account domain is: conteso.com
<url> is everything after the account domain. In the Stream page example above, the URL would just be "recognitions".
<sharepoint host> is the domain of your Sharepoint host or your intranet domain. This may be either a publicly accessible DNS entry or an internal identifier that is only accessible from inside your corporate network
In the following examples, the domain is conteso.com and the Sharepoint host will be conteso.sharepoint.com
Stream page example
Destination page: https://recognizeapp.com/conteso.com/recognitions
Url for SharePoint: https://recognizeapp.com/conteso.com/saml/sso/recognitions?viewer=sharepoint&referrer=conteso.sharepoint.com
Rewards page example
Destination page: https://recognizeapp.com/conteso.com/rewards
Url for SharePoint: https://recognizeapp.com/conteso.com/saml/sso/rewards?viewer=sharpoint&referrer=conteso.sharepoint.com
Send recognition page example
Destination page: https://recognizeapp.com/recognitions/new
Url for SharePoint: https://recognizeapp.com/conteso.com/saml/sso/recognitions/new?viewer=sharepoint&referrer=conteso.sharepoint.com
OAuth Login
When embedding Recognize into on-prem Sharepoint and using OAuth-based login, please follow the instructions for SAML SSO except you will need to replace "saml/sso" with simply "redirect" in the URL in Sharepoint.
For example:
Destination page: https://recognizeapp.com/conteso.com/recognitions
Url for SharePoint: https://recognizeapp.com/conteso.com/redirect/recognitions?viewer=sharepoint&referrer=coneso.sharepoint.com