Article last updated on the 19th of April, 2023.
Note that the content of this article is relevant from WorkPoint Express Version 6.3.4.
Contents
1. Introduction
2. Requirements
3. Setup guide
3.1. Granting consents
3.1.1. Granting consents through WorkPoint Express
1. Introduction
With the simplification of the login experience in WorkPoint Express, we aim to improve the experience of logging into and start using WorkPoint Express.
When activated and the necessary consent is given, users will no longer be prompted to log into the different services used by WorkPoint Express separately (WorkPoint Express web service, the WorkPoint365 WebAPI, SharePoint, etc.).
Using the simplified login in WorkPoint Express, these services are now united in a single login. WorkPoint Express will always attempt to automatically log you in with your currently logged in Windows account. This eliminates the hassle of typing in your username and password. Just select your Windows account when prompted, and you are in!
Note that the Simplified login for WorkPoint Express is introduced with WorkPoint Express version 6.3.4 and requires consent from an administrator. Users will not be able to log into WorkPoint Express until the necessary consent for your use case has been granted. More information can be found in the Setup Guide section.
2. Requirements
Using the simplified login requires that the necessary consents have been granted.
3. Setup guide
In order for the simplified login for WorkPoint Express to be used, a tenant administrator needs to grant the necessary consent(s). Once the consents have been granted, the simplified login functionality is going to bundle login prompts together in order to minimize the times users need to provide credentials.
The simplified login functionality requires the following consents dependent on your use case:
- WorkPoint Express (WorkPoint 365): Required if using WorkPoint Express up against a WorkPoint 365 solution. This consent requires prior consent to the WorkPoint 365 Web API.
- WorkPoint Express (WorkPoint 365 + Email Manager): This consent need to be granted it you are using WorkPoint Email Manager. This consent requires prior consent to the WorkPoint 365 Web API and the WorkPoint EMM API.
- WorkPoint Express (SharePoint Online): Required if using WorkPoint Express up against SharePoint Online without a WorkPoint 365 solution.
Note that users will not be able to log into WorkPoint Express until the necessary consent for your use case has been granted.
3.1. Granting consents
3.1.1. Granting consents through WorkPoint Express
If you are using WorkPoint Express 6.3.3. or earlier and you want to upgrade to version 6.3.4 or newer, please use the consent links described in section 3.1.2.
You can grant the consents from the WorkPoint Express settings:
- In WorkPoint Express, click the Menu button and select "Settings".
- In the WorkPoint Settings, select "System" and then "Miscellaneous".
- Scroll down to the "Consent links" section and select the consent you want to grant.
- In the text field, type in the name of your tenant.
- Click the "Open Link" link.
- Log in with your tenant administrator account.
- Expand each permission to view more information about what you are consenting to.
- To grant the consent, click the "Accept" button.
After the consent has been granted, you will be redirected to WorkPoint's web page.
The consent should now have been granted, and it can be reviewed and revoked in the Enterprise Applications page in your Azure Active Directory.
3.1.2. Granting consents using links
If you are using a version of WorkPoint Express where the consents shown in pt. 3 are not available in the list of consents that can be granted in the WorkPoint Express settings, you can use the following links to grant them:
Note that you need to substitute [TENANT NAME] in the links with the name of your Microsoft 365 tenant.
WorkPoint Express (WorkPoint 365)
This consent requires prior consent to the WorkPoint 365 Web API.
https://login.microsoftonline.com/[TENANT NAME].onmicrosoft.com/v2.0/adminConsent?client_id=9fee23e0-db6c-4998-9802-38ec7baf7869&scope=.default&redirect_uri=https://workpoint365.comWorkPoint Express (WorkPoint 365 + Email Manager)
This consent requires prior consent to the WorkPoint 365 Web API and the WorkPoint EMM API.
https://login.microsoftonline.com/[TENANT NAME].onmicrosoft.com/v2.0/adminconsent?client_id=9fee23e0-db6c-4998-9802-38ec7baf7869&scope=Directory.AccessAsUser.All%20Directory.Read.All%20Group.Read.All%20Sites.Read.All%20User.Read%20https://microsoft.sharepoint-df.com/AllSites.Write%20https://workpoint365.dk/WorkPoint365.WebAPI/user_impersonation%20https://workpoint365.com/EMM365.WebAPI/user_impersonation&redirect_uri=https://workpoint365.comWorkPoint Express (SharePoint Online):
https://login.microsoftonline.com/[TENANT NAME].onmicrosoft.com/v2.0/adminconsent?client_id=9fee23e0-db6c-4998-9802-38ec7baf7869&scope=Directory.AccessAsUser.All%20Directory.Read.All%20Group.Read.All%20Sites.Read.All%20User.Read%20https://microsoft.sharepoint-df.com/AllSites.Write&redirect_uri=https://workpoint365.com
- After opening the one of the links, sign in with your tenant administrator account.
- Expand each permission to view more information about what you are consenting to.
- To grant the consent, click the "Accept" button.
After the consent has been granted, you will be redirected to WorkPoint's web page.
The consents should now have been granted, and they can be reviewed and revoked in the Enterprise Applications page in your Azure Active Directory.
4. End user guide
The user should experience the introduction of the simplified login in that they should be met with fewer login prompts when using WorkPoint Express.
Other than that, users do not interact with the feature at all.
Comments
0 comments
Please sign in to leave a comment.