Information importante : Mozzaik365 devient Jint

Veuillez noter que notre solution change de nom pour devenir Jint.

Durant cette période de transition, certains éléments techniques (comme les noms d'applications, d'API ou de domaines) feront encore temporairement référence à notre ancien nom, Jint. Cela n'impacte en rien la procédure d'installation ni le bon fonctionnement du produit.

1. Introduction

1.1 Objectif du document 

Cet article a pour objectif de vous présenter les prérequis techniques et de sécurité pour
l’installation, la mise à jour et l’utilisation de la solution Translator, ainsi que la procédure
d’installation.

Les étapes d’installation doivent être suivies par une personne étant administrateur Entra IDet
SharePoint.  

1.2 Architecture de la solution Translator

La solution Translator est composée de :

• Un package SharePoint
• Un back-office, Jint Translator qui procédera à la traduction
• Un ensemble d'API qui repose sur votre compte Microsoft pour l'authentification.

1.3 Déploiement des packages

Translator étend les fonctionnalités de Microsoft SharePoint. Nous le faisons en déployant des packages dans votre environnement SharePoint. Ces déploiements se font automatiquement à chaque fois que nous publions une nouvelle version.

2. Liste des prérequis 

2.1 Résumé

Voici un résumé des prérequis pour chaque composant. Ils sont détaillés dans les sections suivantes. 

2.1.1 Au niveau de SharePoint 

• Accès administrateur au catalogue d’applications :
  • Approbation d’une application Entra ID, Jint Deployment, demandant la
    permission applicative Sites.Selected.
• Approbation des appels délégués aux APIs suivantes :
  o Jint Translator

2.1.2 Au niveau d'Entra ID 

• Approbation de 3 applications Entra ID:
  • Jint Deployment
  • Jint Configurator
  • Jint Translator

2.2 Déploiement des packages SharePoint

Afin de déployer les packages SharePoint, notre automate de déploiement a besoin des droits
d’administrateurs du catalogue d’applications, Microsoft ne proposant pas de droits plus fins. Ces
droits sont à donner à notre application Entra ID, Jint Deployment.

3. Étapes d’installation

Les prérequis précédents ayant été validés, les étapes d’installation sont les suivantes :

À l’exception de l’étape 4, ces étapes sont à réaliser par le Client. À l’issue de ces étapes, la solution
Jint est utilisable par le Client et son Intégrateur. 

 

3.1 Préparation du tenant SharePoint 

Niveau d’accès requis pour cette étape : Administrateur SharePoint. 

La préparation de votre tenant SharePoint consiste à s’assurer de la création du catalogue d’application global. Avec un compte administrateur de SharePoint, accédez à la console d’administration Microsoft 365 : https://admin.microsoft.com. 


Dans le menu de gauche, sélectionnez « Show all » puis cliquez sur « SharePoint » dans la section « Admin centers » : 




Dans menu « Plus de fonctionnalités » du centre d’administration SharePoint, cliquez sur le bouton « Ouvrir » de la section « Applications » : 




Le catalogue d’application est créé s’il n’existait pas. 


Pour chacune des sites du périmètre souscrit, vous devrez créer le catalogue d’applications correspondant. Cela se fait via quelques commandes PowerShell avec un compte qui est administrateur SharePoint et administrateur de chaque site cible :





# installation du module PowerShell Microsoft.Online.SharePoint.PowerShell Install-Module  -Name Microsoft.Online.SharePoint.PowerShell 
# connexion au tenant SharePoint 
Connect-SPOService -Url https://<votre-tenant>-admin.sharepoint.com 
# creation/activation du catalogue d’application de chaque collection de site 
Add-SPOSiteCollectionAppCatalog -Site https://<votre-tenant>.sharepoint.com/sites/<nom-du-site>

3.2 Approbation des applications pour le Configurateur et les APIs Jint

Niveau d’accès requis pour cette étape : Administrateur Entra ID.

Afin d’autoriser le Configurateur et nos APIs à authentifier vos collaborateurs, vous devez approuver les applications suivantes en cliquant sur les liens correspondants :

 

Voici la description de chaque application :

• Jint Deployment est l’application qui réalise les installations et les mises à jour
  des solutions Jint sur votre Tenant. Vous lui donnerez les droits
  administrateurs au catalogue d’application afin de déployer les packages SharePoint.

• Jint Configurator est le back-office de Jint. Il vous permet
  d’administrer le périmètre de la solution. Il demande des permissions déléguées :

  • User.Read

  • GroupMember.Read.All n'est utilisé que pour les clients Jint et n'est pas requis pour Translator

• Jint Translator est l'application qui permet de traduire le contenu de vos pages

Les permissions déléguées sont des permissions autorisant une application à accéder à certain
domaine de Microsoft365 pour le compte d’un utilisateur. Elles permettent à Translator d’afficher
toutes les informations pertinentes pour chaque utilisateur. Plus d’information sur les permissions
déléguées ici. 

3.3 Octroi des permissions au catalogue d’applications

L’octroi des permissions à notre application Entra ID se fait uniquement via un ensemble
d’appels à l’API Microsoft Graph.

Nous vous proposons un script PowerShell téléchargeable ici permettant de réaliser plus facilement l’ensemble de ces appels.

Ce script va octroyer les droits d’administrateur à notre application Jint Deployment sur votre catalogue d’application.

 


Lors de son exécution, vous serez invité, en fonction de la configuration de votre PC, à accepter de télécharger et installer des modules depuis internet : Microsoft.Graph.Sites.

Il vous faudra également un compte qui soit administrateur Entra ID afin d’autoriser le script à interagir avec votre environnement Microsoft 365 via la permission déléguée Sites.FullControl.All, et administrateur SharePoint afin d’octroyer la bonne permission à notre application.

Une fois l’archive téléchargée, il faut extraire le script dans le dossier de votre choix. Puis, pour chaquecollection de site du périmètre, faites un clic droit sur le fichier et « Exécuter avec PowerShell ». Le script va alors vous demander de renseigner l’URL du site du catalogue d’application.

 

3.4 Communication des informations nécessaires à l’installation à Jint

Niveau d’accès requis pour cette étape : Administrateur Entra ID

Afin de pouvoir procéder à l’installation de Translator, nous avons besoin des informations
suivantes :

• Informations sur votre tenant Entra ID/SharePoint :
  • ID du tenant Entra ID,
  • Nom initial du tenant Entra ID/SharePoint,
• URL du site du catalogue d’applications identifié au chapitre 3.2,
• Liste des identifiants des gestionnaires de la solution Jint.

Une fois ces informations collectées, il faut les communiquer à votre contact Jint.

Dans les chapitres suivants, nous détaillons où trouver certaines de ces informations. 

3.4.1 Information sur votre tenant Entra ID

Accédez à la section vue d'ensemble du portail Entra ID du portail Entra ID. L’Id du tenant est nommé « ID du client » dans l’interface : 

Pour le nom initial du tenant, accédez au menu « Noms de domaines personnalisés » et cherchez
l’entrée se terminant par « .onmicrosoft.com ». Vous pouvez utiliser la barre de filtre. Le nom initial de
votre tenant est ce qui précède « .onmicrosoft.com », « Jint » dans l’exemple ci-dessous. 

3.5 Déploiement de la solution par Jint

Durant cette étape, les équipes Jint procèdent au déploiement initial des packages SharePoint de Translator, ainsi qu’à l’initialisation de votre accès au Configurateur Jint.

Une fois terminée, vous serez averti par votre contact Jint.

 

3.6 Approbation des appels aux APIs Jint

Autoriser l'accès à Jint Translator pour pouvoir accéder à notre service réalisant la traduction. Pour savoir comment autoriser la permission, consultez l'article Approbation des permissions.

• Nom de l'API : Jint translator
• Permission demandée : user_impersonation
   

4. Utilisation de la solution Translator

Translator est correctement configuré et déployé dans votre environnement Microsoft ! Vous pouvez désormais commencer à traduire votre contenu de manière transparente au sein de SharePoint.

N'hésitez pas à consulter la documentation Translator sur notre centre d'aide afin de découvrir nos
fonctionnalités et les différentes solutions que nous vous permettons de mettre en place !