# Enregistrement initial de l'application dans Microsoft Azure

Pour qu'ELO Azure Administration puisse établir une connexion à Microsoft Azure, vous devez effectuer un premier enregistrement d'application via Microsoft Azure.

Remarque

La configuration de base d'un environnement Microsoft Azure ainsi que la création d'abonnements correspondants est un prérequis et ne fait pas partie de cette documentation.

  1. Authentifiez-vous dans Microsoft Azure avec les droits administratifs.

    Section 'Microsoft Entra ID'; point de menu 'Enregistrements d'applications'

  2. Ouvrez la section Enregistrements d'applications.

    Section 'Enregistrements d'application'; bouton 'Nouvel enregistrement'

  3. Veuillez sélectionner Nouvel enregistrement.

    La page Enregistrer l'application s'affiche.

  4. Entrez un nom pour l'application. Vous pouvez sélectionner ce nom librement.

    Exemple : administration ELO Azure

  5. Sous Types de comptes supportés, sélectionnez l'option Comptes dans un répertoire d'organisation quelconque (mandant ID Microsoft Entra quelconque) et comptes Microsoft personnels (par exemple Skype, Xbox).

  6. Sélectionnez Enregistrer.

    L'application est enregistrée dans Microsoft Azure.

# Réglages d'authentification

Une fois l'enregistrement terminé, vous devez configurer quelques réglages pour l'authentification de l'application.

  1. Dans Microsoft Azure, ouvrez la section Authentification.

    Bouton 'Authentification'

  2. Sélectionnez Ajouter la plateforme.

    La section Configurer la plateforme apparaît.

  3. Sélectionnez Application Web Single Page.

    Extrait de la section 'Configurer l'application Single Page'

    La section Configurer l'application Single Page.

  4. Dans le champ Entrer l'URl de redirection de l'application, entrez une URL selon le schéma suivant :

    https://<Server>:<Port>/ix-<Repository>/plugin/de.elo.ix.plugin.proxy/azadministrations/auth-end/blank.html

    Exemple :

    https://desktop-8luhtiv:9093/ix-EXTEN/plugin/de.elo.ix.plugin.proxy/azadministrations/auth-end/blank.html

    Information

    L'URL doit correspondre au chemin de ELO Azure Administration dans l'environnement ELO correspondant.

  5. Activez les réglages suivants :

    • Token d'accès (sont utilisés pour les flows implicites)
    • Token ID (sont utilisés pour les flows implicites et hybrides)
  6. Enregistrez les réglages avec Configurer.

    Les réglages d'authentification sont configurés maintenant.

# Autorisations API

L'application pour ELO Azure Administration requiert quelques autorisations.

Bouton 'Autorisations API'

  1. Ouvrez la section Autorisations API.

  2. Sélectionnez Ajouter des autorisations

    La section Demander les autorisations API s'affiche.

  3. Ajoutez les autorisations déléguées suivantes :

    • Azure Service Management:
      • user_impersonation
    • Microsoft Graph :
      • Application.ReadWrite.All
      • Directory.ReadWrite.All
      • RoleManagement.ReadWrite.Directory
      • User.Read
      • User.ReadWrite.All

    Section 'Autorisations configurées'; bouton pour assigner le consentement de l'administrateur

  4. Sélectionnez Donner le consentement de l'administrateur pour <Mandant>.

    Le dialogue de demande Confirmation du consentement de l'administrateur s'affiche.

  5. Confirmez avec Oui.

    Les autorisations sont ajoutées;

# Configuration du service

Une fois l'application configurée dans Azure, vous devez adapter la configuration du service ELO Azure Administration dans le système ELO.

  1. Dans Microsoft Azure, ouvrez aperçu de l'application créée ci-dessus.

    Aperçu de Azure App, les champs 'Nom d'affichage' et 'ID d'application (client)' sont marqués

  2. Copiez les valeurs des champs suivants :

    • Nom d'affichage
    • ID d'application (client)
  3. Ouvrez le répertoire suivant sur le serveur sur lequel est installé ELO :

    <ELO>\servers\ELO-Azure-Administration

    Information

    Le garde-place <ELO> remplace le répertoire d'installation ELO.

  4. Ouvrez le fichierappsettings.json dans un éditeur approprié.

    Vous trouverez les entrées suivantes dans l'en-tête du fichier :

      "AppsManagementDashboard": {
        "MicrosoftAppId": "",
        "MicrosoftAppName": ""
      },
    
  5. Ajoutez les valeurs copiées au fichier JSON.

    Exemple :

      "AppsManagementDashboard": {
        "MicrosoftAppId": "cc810f16-0766-49d9-a6b6-b1c8e3286cb4",
        "MicrosoftAppName": "ELO Azure Administration"
      },
    
  6. Veuillez enregistrer le fichier.

  7. Redémarrez le service ELO Azure Administration.

    La configuration du service est clôturée. Maintenant, vous pouvez vous authentifier à Microsoft Azure via ELO Azure Administration.

Dernière mise à jour: 18 juin 2024 à 11:27