Requirements
In this section, you can find all is needed to start the journey with our Microlearning tool!
Project Requirements
Please find here below the requirements from the project management point of view, needed for both SAAS and Self-hosted.
We ask a personal account for each of our specialists, to be used for working on your Microsoft 365 environment.
We ask the creation of a Teams group, inside the Customer tenant. This is useful for the collaboration during the project. We are going to use this group for all the communications during the project, for having one single repository for project's documents and files, for archiving meeting notes and managing tasks.
Technical requirements
Please find below all the technical requirements for final users and for the cloud environment in which we will install our solution.
Users' system requirements
The Customer is required to use, maintain, and upgrade hardware and software to meet the evolving system requirements of our solution. Hardware and software requirements to be met are specified within the Microsoft 365 documentation.
Users' licenses
The Microlearning will be created on SharePoint Online and the following licenses are needed to use all the features available:
SharePoint Online, for accessing the intranet portal
Microsoft Teams, for receiving push notifications
This license is included in the following bundles:
Microsoft 365 Business Basic / Standard / Premium
System requirements
INSTRUCTIONS FOR CREATING AD GROUPS
We kindly ask you to create AD groups in order to have specific users roles in the Microlearning tool. To create them follow these instructions:
1. Creating roles on the Microlearning app registration:
Access to Azure Portal
From "Microsoft Entra ID", select from the left menu "App registration" and select the app registration related to Microlearning
Then select "App roles" from the menu on the left and create the additional roles by clicking on “Create app role" where the following items "Display name", "Value" and "Description" will have the value of "Admin" for one, and "User" for the other (the "Manager" role should already exist)
2. Create Admin and User security groups from the group management of Microsoft Entra ID:
Access to Azure Portal
From "Microsoft Enter ID" select "Groups" in the menu on the left
Create a new group for admins by clicking on the "New Group" button and name it as "Microlearning Admins”, then create a second group for users and name it as "Microlearning Users". The item "Group Type" will be set on "Security" and "Membership type" on "Assigned". The group for managers should be created following the same logic as the other two
From 'Microsoft Entra ID' select "Enterprise applications" in the left-hand menu
Search the Microlearning “enterprise application” area and then open it
Then select "Users and groups" from the menu on the left
Add role assignments by selecting "Add user/group" and assigning the AD group the relevant role ("Admin", "Manager", "User")
Add users who already have access to the Microlearning app to the new groups
SharePoint Online
A global App Catalog is needed to install intranet.ai solutions. You create your global App Catalog inside the SharePoint Online Administration portal following these instructions. If there is already an App Catalog configured, just skip this step.
intranet.ai needs one communication site in SharePoint Online to work. Please create a new communication site following these instructions and choose the address of your brand new Microlearning website (ex: https://CONTOSO.sharepoint.com/sites/microlearning).
Azure (only for Self-hosted installation)
An Azure subscription (pay-as-you-go, CSP, or with an Enterprise Agreement) is needed for server-side features of intranet.ai self-hosted. If a subscription is not already active, it can be created following this guide or with the support of our technicians during the installation (a credit card will be needed to activate it).
STEP 1 Following these instructions, please register the service provider below:
Microsoft.AlertsManagement
Microsoft.ApiManagement
Microsoft.BotService
Microsoft.CognitiveServices
Microsoft.DocumentDB
Microsoft.Insights
Microsoft.KeyVault
Microsoft.ManagedServices
Microsoft.Search
Microsoft.Storage
Microsoft.Web
Microsoft.EventHub
Microsoft.Kusto
Microsoft.OperationalInsights
STEP 2 Create a new resource group inside your Azure subscription following these instructions. Give "Contribute" access to this new resource group to intranet.ai's accounts.
STEP 3
Following these instructions, please create a new app registration inside your Azure AD and configure it as below:
Name: intranet.ai-microlearning
Supported account types: Accounts in any organizational directory (Multitenant), this is because of Teams bot.
Then follow these instructions:
Go to: Manage > Authentication > Platform configurations > + Add a platform > Single-Page Application
Set the redirect URIs:
- https://'iai-microlearning-v2x-web-europe-customerhash.azurewebsites.net'
-https://'iai-microlearning-v2x-web-europe-customerhash.azurewebsites.net'/login (add after adding the platform)
Allow Access tokens and ID tokens
Set the Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant)
Set the Enable the following mobile and desktop flows to YES.
Save and continue
Generate a new client secret with the maximum expiration date
Go to: Manage > Expose an API.
o Set the Application ID URI: api://'iai-microlearning-v2x-web-europe-customerhash.azurewebsites.net'/'clientid'
o Add a scope: “user_impersonation”
o Set Who canconsent? to: Admins and users
o Set scope name, display name and description: user_impersonation
o Add the “Authorized client applications”:
One is the same client id generated now (Client app ID)
Teams web (default): 5e3ce6c0-2b1f-4285-8d4b-75ee78787346
Teams app (default): 1fec8e78-bce4-4aaf-ab1b-5451cc387264
o Every client ID has the authorized scope to the one which is selectable
Configure the following permissions:
Microsoft Graph
Delegated :
-openid
-profile
-Group.Read.All
-GroupMember.Read.All
-User.Read
-User.Read.All
-User.ReadBasic.All
-LearningContent.ReadWrite.All
-LearningProvider.ReadWrite
Applications:
-Group.Read.All
-GroupMember.Read.All
-User.Read.All
-LearningContent.ReadWrite.All
Last updated