Configurer le spoke Microsoft Teams Communications

Intégrez l’instance et Microsoft Teams Communications le ServiceNow compte en créant une application OAuth personnalisée pour Microsoft Teams Communications authentifier les demandesServiceNow.

Avant de commencer

• Demandez un Centre d'intégration abonnement.
• Activez le spoke Microsoft Teams Communications.
• Rôle requis : admin.

Créer une application dans Microsoft Teams pour activer les appels

Créez une application pour effectuer des appels sortants à partir de Microsoft Teams.

Avant de commencer

Rôle requis : admin, Microsoft Teams admin, Microsoft Azure admin

Procédure

1. Connectez-vous au portail des développeurs Microsoft Teams.
   Remarque :

   Le portail des développeurs pour Government Community Cloud (GCC) est accessible uniquement via une application dans Microsoft Teams. Il n’est pas disponible en tant que site Web distinct et autonome. Pour plus d’informations, consultez Portail des développeurs pour Teams. Pour créer une application pour GCC, vous devez créer l’application à partir de Microsoft Teams.

2. Créez une application.
   1. Accédez à la Applications > Nouvelle application.
   2. Entrez un nom valide pour l’application dans la page contextuelle Ajouter une application et sélectionnez Ajouter.
   3. Sur la page Détails de l’application, renseignez les champs.

      Tableau 1. Page des détails de l’application

      Champ	Description
      Nom court	Nom de votre application. Par exemple, ServiceNow pour Notification Microsoft Teams.
      Nom complet	Nom complet de votre application.
      ID d'application	Numéro d’identification unique de l’application. Remarque : Cet ID d’application est différent de l’ID du bot/de l’application qui sera généré dans les étapes suivantes.
      Description brève	Brève description de l'application.
      Description longue	Description détaillée de l'application.
      Version	Version de l’application. Par exemple, 1.0.
      Nom du développeur ou de la société	Nom de votre société.
      Site Web	Lien vers le site Web de votre entreprise.
      Politique de confidentialité	Lien vers la déclaration de confidentialité de votre application.
      Conditions d'utilisation	Lien vers les conditions d'utilisation de votre application.

   4. Sélectionnez Enregistrer.
      Une application est créée dans Microsoft Teams.
3. Créez un bot pour la nouvelle application.
   1. Accédez à la Configurer > Fonctionnalités de l’application.
   2. Sélectionnez Bot.
   3. Sélectionnez Créer un bot.
   4. Sélectionnez Nouveau bot.
   5. Saisissez un nom valide pour l’agent dans la page contextuelle Ajouter un agent et sélectionnez Ajouter.
   6. Copiez dans un bloc-notes la valeur de l’ID du bot du nouveau bot à l’aide de l’une des options suivantes et ce sera votre ID client d’application.
      • Copiez l’ID à partir de l’URL du navigateur.
      • Revenir à Agents > Outilset copiez l’ID du bot.
   7. Accédez à Canaux, activez Microsoft Teams et sélectionnez Enregistrer.
   8. Sélectionnez Secrets clients et saisissez un secret client pour votre bot.
      Un secret client est généré.

      Remarque :

      Assurez-vous de copier le secret client généré dans un bloc-notes, car il n’apparaîtra plus.
4. Copiez l’ID client ou l’ID de bot du nouveau bot dans l’application (ID client).
   1. Accédez à Applications et sélectionnez l’application que vous avez créée.
   2. Accédez à la Configurer > Informations de base.
   3. Collez l’ID client/l’ID du bot que vous avez copié à l’étape 3f dans le champ ID (client) de l’application et sélectionnez Enregistrer.
5. Configurez des fonctionnalités d’application supplémentaires pour le nouveau bot.
   1. Accédez à Applications et sélectionnez l’application que vous avez créée.
   2. Accédez à la Configurer > Fonctionnalités de l’application > Agent > Sélectionner un bot existant et sélectionnez le bot que vous avez créé.
   3. Sélectionnez Appels audio d’assistance et Appels vidéo d’assistance dans « Que peut faire votre bot ? ».
   4. Sélectionnez Messagerie instantanée personnelle, d’équipe ou de groupe dans « Sélectionner les champs d’application dans lesquels les utilisateurs peuvent utiliser cette commande ».
6. Copiez les nouveaux attributs d’application.
   1. Connectez-vous au portail Microsoft Azure en tant qu’administrateur Microsoft Azure .
   2. Accédez à la Services Azure > Azure Active Directory > Gérer  > Inscriptions d’applications.
   3. Recherchez et ouvrez le nouveau bot créé pour le spoke par nom ou par ID d’application (client).
   4. Notez l’ID client/l’ID d’application (client), l’ID d’objet et l’ID de locataire pour mettre à jour ces valeurs dans votre ServiceNow instance lors de procédures ultérieures.
      Remarque :

      L’ID du bot créé sur le portail des développeurs Microsoft Teams et l’ID de l’application (client) sur le portail Microsoft Azure sont identiques.

Gérer les autorisations et authentifier l’application et le bot dans Microsoft Azure le portail

Affectez des autorisations aux utilisateurs pour qu'ils puissent s'authentifier et participer à des téléconférences dans Microsoft Teams.

Avant de commencer

Rôle requis : Microsoft Azure admin

Pourquoi et quand exécuter cette tâche

Vous pouvez gérer les autorisations requises par l’application et le bot pour effectuer les actions requises pour les téléconférences.

Procédure

1. Connectez-vous au portail Microsoft Azure.
2. Accédez à la Azure Services > Azure Active Directory > Gérer  > Inscriptions d’applications.
3. Recherchez et ouvrez le bot créé à l’étape 3 dans la section Créer une application dans Microsoft Teams pour activer les appels par nom ou par ID d’application (client).
4. Accédez à la Gérer  > Autorisations d'API > Ajouter une autorisation > Microsoft Graph et sélectionnez Autorisations d’application.
5. Recherchez et sélectionnez les valeurs suivantes à l’aide de Sélectionnez les autorisations, puis sélectionnez Ajouter des autorisations pour accorder l’autorisation.
   • Utilisateur.Lecture.Tout à partir de la liste Utilisateur.
   • RéunionsLigne.Lectureécriture.Tout à partir de la liste RéunionsLigne.
   • Calls.InitiateGroupCall.All, Calls.JoinGroupCall.All, Calls.JoinGroupCallAsGuest.All à partir de la liste d’appels.
6. Accordez aux administrateurs l’accès aux applications qui nécessitent une approbation de l’administrateur Microsoft Azure .
   1. Sélectionnez Accorder le consentement de l’administrateur pour <locataire> sur la page des autorisations d’API.
   2. Sélectionnez Oui dans la page contextuelle de confirmation du consentement de l’administrateur pour l’accord.

Créer un utilisateur de service à partir duquel effectuer des appels Microsoft Teams

Créez un rôle d’utilisateur de service pour pouvoir démarrer des réunions en ligne au nom des utilisateurs dans Microsoft Teams.

Avant de commencer

Rôle requis : admin

Procédure

1. Connectez-vous au portail Microsoft Azure.
2. Créer un utilisateur de service.
   1. Accédez à la Services Azure > Utilisateur.
   2. Sélectionnez Nouvel utilisateur.
   3. Renseignez les champs du formulaire.

      Tableau 2. Nouvel utilisateur

      Champ	Description
      Noms d'utilisateur	Option permettant de fournir un nom pour l'utilisateur.
      Nom	Option permettant de fournir le nom de l'utilisateur.

   4. Sélectionnez Créer.
   5. Sélectionnez l’utilisateur créé pour afficher les détails.
      Remarque :

      Assurez-vous que l’utilisateur de service dispose de la licence/de l’abonnement requis et d’un emplacement d’utilisation valide défini pour effectuer des téléconférences à partir de Microsoft Teams.
3. Exécutez la commande PowerShell à partir de Terminal sur macOS ou à partir de l’invite de commande sur le système d’exploitation Windows.
   1. Tapez la commande pwsh et appuyez sur Entrée.
   2. Connectez votre locataire Microsoft à PowerShell.
   3. Exécutez la commande suivante dans PowerShell.

      connect-microsoftteams

      

      Si la connexion est établie, un message de confirmation s'affiche dans le navigateur.

      

      PowerShell affiche également les détails du locataire.

      
4. Exécutez la commande ci-dessous pour créer une nouvelle politique d’accès à l’application dans PowerShell.

   Utilisez l’ID du bot créé à l’étape 3 dans la section Créer une application dans Microsoft Teams pour activer les appels en tant qu’ID d’application pour la commande.

   Pour plus d’informations sur la politique d’accès des applications, consultez Configurer l’accès des applications aux réunions en ligne.

   Syntax:
   
   New-CsApplicationAccessPolicy -Identity "<PolicyName (can be anything)>" -AppIds "<AppIds>" -Description "<Policy Description>"
   
   Example:
   If you have a Self-configured (single tenant) setup, use the application ID from Azure portal.
   
   For Example: New-CsApplicationAccessPolicy -Identity "OnlineMeetingsAccessPolicy" -AppIds "aaaaaaaa-1234-er4r-8dc9-123456789012" -Description "Grant OnlineMeeting Application Permission"

   

   Une fois la politique créée, les détails sont affichés dans PowerShell.

   
5. Exécutez la politique d’autorisation utilisateur dans PowerShell.
   1. Accédez au portail Microsoft Azure.
   2. Accédez à la Accueil > Utilisateurs.
   3. Sélectionnez l’utilisateur créé.
   4. Copiez l’ID d’objet de l’utilisateur dans le bloc-notes.
   5. Utilisez le nom de la politique créée à l’étape précédente comme PolicyName de la commande et l’ID d’objet comme UserAzureID respectivement dans la commande à exécuter dans PowerShell.

      Syntax:
      
      Grant-CsApplicationAccessPolicy -Identity "<UserAzureID>" -PolicyName "<PolicyName>"
      
      Example:
      
      Grant-CsApplicationAccessPolicy -Identity "fdcd9c17-ceae-468f-906f-2er76b4dd0f4" -PolicyName "OnlineMeetingsAccessPolicy"
      

      

S’inscrire Microsoft Teams Communications en tant que fournisseur OAuth

Utilisez les informations générées lors de la configuration de l’application dans Microsoft le portail Azure pour vous inscrire Microsoft Teams Communications en tant que fournisseur OAuth afin que l’instance ServiceNow puisse demander des jetons OAuth 2.0.

Avant de commencer

Rôle requis : admin

Procédure

1. Accédez à la Tous > OAuth système > Registre d'application.
2. Cliquez sur Nouveau.
   Le système affiche ce message : Quel type d’application OAuth ?.
3. Sélectionnez Se connecter à un fournisseur OAuth tiers.
4. Renseignez ces valeurs sur le formulaire.

   Tableau 3. Formulaire des registres d'application

   Champ	Description
   ID client	ID d'application créé lors de l'enregistrement de l'application.
   Secret client	Secret client créé lors de l'enregistrement de l'application.
   Actif	Option permettant d’utiliser activement le registre d’application.
   URL d'autorisation	Point de terminaison du code d'autorisation OAuth. Saisissez https://login.microsoftonline.com/<Directory-ID>/oauth2/v2.0/authorize.
   URL de jeton	Point de terminaison de jeton du serveur OAuth. Entrez https://login.microsoftonline.com/<Directory-ID>/oauth2/v2.0/token.
   URL de révocation du jeton	Point de terminaison de révocation du jeton du serveur OAuth.
   URL de redirection	Point de terminaison de rappel OAuth. Entrez https://<nom-instance>.service-now.com/oauth_redirect.do.
   Type d'accord par défaut	Type d'accord utilisé pour établir le jeton. Renseignez le champ Informations d'identification du client.

5. Cliquez avec le bouton droit de la souris sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
6. Dans l’onglet Périmètres des entités OAuth , insérez une ligne et renseignez les valeurs suivantes :

   Champ	Description
   Nom	Nom permettant d’identifier l’enregistrement du périmètre de l’entité. Par exemple, Périmètre OAuth de communication MS Teams.
   Périmètre OAuth	Périmètre de l’entité OAuth. Entrez .default.

7. Cliquez avec le bouton droit de la souris sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
8. Dans l’onglet Profils des entités OAuth, ouvrez l’enregistrement de profil par défaut.
9. Dans l’onglet Périmètres des entités OAuth , insérez un enregistrement.
10. Recherchez et sélectionnez le périmètre de l’entité OAuth que vous avez créé.
11. Cliquez sur Mettre à jour.

Créer un enregistrement d’informations d’identification pour le Microsoft Teams Communications

Autorisez les actions de spoke Microsoft Teams Communications en créant des enregistrements d’informations d’identification pour l’application enregistrée dans le Microsoft portail Azure. Les Microsoft Teams Communications alias de connexion et d’informations d’identification utilisent ces informations d’identification pour autoriser des actions.

Avant de commencer

Rôle requis : admin

Procédure

1. Accédez à la Tous > Connexions et informations d'identification > Alias de connexion et d’informations d’identification.
2. Ouvrez l’enregistrement d’alias MSTeamsCommunicationsSpoke.
3. Dans l’onglet Informations d’identification , cliquez sur Nouveau.

   Le système affiche ce message : Quel type d’informations d’identification voulez-vous créer ?

4. Sélectionnez Informations d'identification OAuth 2.0.
5. Renseignez les champs du formulaire.

   Tableau 4. Formulaire Informations d'identification OAuth 2.0

   Champ	Description
   Nom	Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, MS Teams Comm Cred.
   Actif	Option permettant d'utiliser activement l'enregistrement des informations d'identification.
   Profil de l'entité OAuth	Profil OAuth créé lors de l’inscription en Microsoft Teams Communications tant que fournisseur OAuth. Par exemple, MS Teams Comm OAuth Prof.

6. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Envoyer.
7. Pour générer le jeton OAuth, cliquez sur le lien connexe Obtenir le jeton OAuth.