Module Office 365 3.2

Configuration dans Azure AD

Se connecter à Azure Active Directory admin center https://aad.portal.azure.com/

Ajout/configuration de l'application

Ajouter/Configurer le site dans l'interface : 

1. Se connecter en administrateur sur Azure Active Directory admin center
2. Accéder à "Azure Active Directory"
3. Consulter la section "Enregistrements d'application"
4. Créer une nouvelle application : 
   1. saisir son nom
   2. saisir l'URL de callback d'authentification (remplacer le domaine par le votre) :
      https://jplatform.example.com/plugins/Office365Plugin/jsp/oauth/oauth2callback.jsp
5. Copier l'identifiant de l'application et le reporter dans la configuration du module
6. Dans la section "Certificats et secrets", 
   1. créer un nouveau secret
   2. choisir une durée de validité ("sans expiration" est recommandé pour cet usage)
   3. saisir un nom identifiable par la suite (l'indication de JPlatform et du module Office365 est sans équivoque)
   4. copier la clé secrète et reporter la dans la configuration du module

Démonstration en vidéo : 

Ajout des autorisations sur l'application

Ajouter les autorisations nécéssaires dans l'application :

1. Se connecter en administrateur sur Azure Active Directory Admin Center
2. Accéder à Azure Active Directory
3. Consulter la section "Enregistrements d'application"
4. Consulter l'application précédement créée
5. Accéder à la section "API permissions"
6. Choisir "Ajouter une permission"
7. Choisir "Microsoft Graph"
   
8. Sélectionner "Permissions déléguées", cocher toutes les entrées suivantes
   Calendars.Read
Calendars.Read.Shared
Calendars.ReadWrite
Calendars.ReadWrite.Shared
Directory.AccessAsUser.All
Directory.Read.All
Directory.ReadWrite.All
Contacts.Read
Contacts.Read.Shared
Files.Read
Files.Read.All
Files.ReadWrite.All
Group.Read.All
Group.ReadWrite.All
Mail.Read
Mail.Read.Shared
Mail.ReadWrite
Mail.ReadWrite.Shared
Notes.Read
Notes.Read.All
Notifications.ReadWrite.CreatedByApp
People.Read
Sites.Read.All
Tasks.Read
Tasks.Read.Shared
User.Read
User.Read.All
User.ReadBasic.All
UserActivity.ReadWrite.CreatedByApp
email
9. Valider
10. Accorder le consentement de ces APIs pour les utilisateurs (bouton "Grant consent for COMPANY")

Pour plus d'information sur les autorisation Office 365 et Microsoft Graph, consultez cette fiche dédiée aux responsables sécurité et aux administrateurs Azure AD. 

Démonstration (partielle) en vidéo : 

Configuration du Site Sharepoint

Accéder à l'administration du module, et configurer la propriété "Site SharePoint" dont la valeur est généralement sous la forme https://{company}.sharepoint.com/

Configuration des appels Teams

Depuis la version 3.2, le module offre la possibilité d'effectuer des appels Teams directement depuis la Digital Workplace (page de profil d'un membre, carte de visite d'un membre, etc.). L'API de Teams n'offrant pas la possibilité de déclencher un appel depuis une URL, les appels sont effectués par un robot. De fait, on ne peut appeler que des membres authentifiés à Office 365 sur la plateforme (pas de compte invité).

Pour activer cette fonctionnalité, il faut suivre les étapes suivantes : 

Créer et enregistrer un robot d'appel

Suivre la documentation se trouvant ici : https://docs.microsoft.com/fr-fr/microsoftteams/platform/bots/calls-and-meetings/registering-calling-bot

• A la création du robot il vous sera demandé de renseigner l'identifiant d'application. Il correspond à celui de l'application que vous avez configurée plus haut.
• A l'activation du canal Teams, vous aurez à renseigner l'URL du webhook (utilisée pour recevoir les notifications de changement d'état des appels effectué par le robot : décroché, raccroché, etc.). Elle doit être de la forme https://<webapp>/plugins/Office365Plugin/jsp/teams/callback.jsp
• A l'ajout des permissions d'application Microsoft Graph, seule celle-ci est nécessaire :
  • Calls.Initiate.All

Configurer le module

• Copier l'ID de locataire (https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/Properties) et renseignez-le dans les propriétés du module

• Renseignez le nom du robot (que vous avez indiqué à sa création) dans les propriétés du module

Utilisation du module avec plusieurs Tenant Office 365

Configuration

Il est possible d'utiliser plusieurs tenant Office 365 sur une même plateforme pour cela il faut renseigner les propriétés suivantes dans le fichier custom.prop :  

#Tenant A
jcmsplugin.office365.provider.tenantA.apiKey: <myApiKeyA>
jcmsplugin.office365.provider.tenantA.apiSecret: <myApiSercretA>
jcmsplugin.office365.provider.tenantA.site: <mySiteA>
jcmsplugin.office365.provider.tenantA.name: <myNameA>
jcmsplugin.office365.provider.tenantA.icon: <myIconA>

#Tenant B
jcmsplugin.office365.provider.tenantB.apiKey:<myApiKeyB>
jcmsplugin.office365.provider.tenantB.apiSecret: <myApiSercretB>
jcmsplugin.office365.provider.tenantB.site:<mySiteB>
jcmsplugin.office365.provider.tenantB.name: <myNameB>
jcmsplugin.office365.provider.tenantB.icon: <myIconB>

#default tenant
jcmsplugin.tenant.default:tenantA

Affectation des utilisateurs à un tenant 

Chaque tenant est représenté par un groupe. Il faut ajouter sur ce groupe la valeur correpondante à l'extraData Tenant Office 365 comme ci dessous :

Tout les utilisateurs du groupe seront ensuite rattachés à ce tenant. 

Si un utilisateur n'est spécifié dans aucun des groupes, alors il est rattaché au defaultTenant spécifié dans le custom.prop

Schéma des échanges JPlatform / Office 365