Soumettre un ticket Mes billets
Bienvenue sur
Connexion  S'inscrire

Connecter PowerDMARC à Microsoft Copilot Studio

Vue d'ensemble

Ce guide vous explique comment connecter votre compte PowerDMARC à Microsoft Copilot Studio à l'aide du protocole MCP (Model Context Protocol). Une fois la connexion établie, un agent Copilot Studio peut interroger les données PowerDMARC en temps réel, notamment les domaines, les rapports DMARC et les informations sur les menaces, directement depuis votre environnement Microsoft, en utilisant le langage naturel.

REMARQUE

Cette intégration nécessite un environnement Power Platform sur lequel Dataverse est activé. Une licence Microsoft Copilot Studio est requise pour publier l'agent à destination des utilisateurs finaux. L'agent est pleinement fonctionnel pour les tests en interne, même sans licence de publication.

1. Générer un jeton MCP PowerDMARC

Le jeton MCP détermine les données PowerDMARC auxquelles l'agent Copilot Studio peut accéder. Vous configurez les autorisations pour chaque jeton.

  1. Connectez-vous à votre compte PowerDMARC et accédez à la rubrique Paramètres > Paramètres API.

  2. Cliquez sur Créer un jeton et donnez-lui un nom descriptif (par exemple Copilot Studio MCP).

  3. Sous Autorisations, sélectionnez les étendues de données auxquelles l'agent doit avoir accès :

  • Pour un agent en lecture seule : activez le rapport agrégé DMARC, le rapport d'analyse DMARC, la gestion des domaines et les informations sur les menaces.

  • Pour bénéficier d'un accès complet : activez toutes les autorisations disponibles

  1. Activer le MCP .

  2. Activer le commutateur « Jeton API principal » . Un seul jeton peut être désigné comme « principal » à la fois.

  3. Cliquez sur Enregistrer.

  4. Accéder à MCP dans la barre latérale de gauche.

  5. Sélectionnez votre jeton dans la menu déroulant .

  6. Copiez l'intégralité de l' URL du serveur MCP (mcp-dmarc.com) — celle-ci inclut votre jeton d'authentification et sera utilisée à la section 3.

REMARQUE

L'URL du serveur MCP contient votre jeton API et permet d'accéder aux données PowerDMARC. Considérez-la comme un mot de passe : ne la divulguez pas publiquement et ne l'enregistrez pas dans un système de gestion de versions.

2. Configurer l'environnement Microsoft Power Platform

Les agents Copilot Studio nécessitent un environnement Power Platform sur lequel Dataverse est activé. Si vous disposez déjà d'un environnement adapté, passez directement à la section 3.

2.1 Créer un environnement Power Platform

  1. Accédez à admin.powerplatform.microsoft.com et connectez-vous.

  2. Accéder à Environnements > Nouveau.

  3. Saisissez un nom (par exemple PowerDMARC-MCP), définissez le type sur Production, puis activez Dataverse.

  4. Sélectionnez votre région, puis cliquez sur Enregistrer. La mise en place de l'environnement prend quelques minutes.

REMARQUE

Dataverse est indispensable pour les agents Copilot Studio. Si Dataverse n'est pas activé dans l'environnement, il est impossible de créer ou d'enregistrer l'agent.

2.2 Associer un forfait de facturation

  1. Dans le Centre d'administration de Power Platform, accédez à Facturation > Licences > Gérer les plans de facturation.

  2. Cliquez sur Nouveau plan de facturation et associez-le à votre abonnement Azure et à votre groupe de ressources.

  3. Associez le plan de facturation à l'environnement créé ci-dessus, puis cliquez sur Enregistrer.

REMARQUE

Si la liste déroulante des groupes de ressources est vide, créez d'abord le groupe de ressources dans le portail Azure, sous « Groupes de ressources > Créer », puis revenez à cette étape.

3. Créer l'agent Copilot Studio

  1. Accédez à Copilot Studio à l'aide de l'URL spécifique à votre environnement :

https://copilotstudio.microsoft.com/environments/{your-environment-id}/home

REMARQUE

Utilisez toujours l'URL spécifique à votre environnement, et non la page d'accueil par défaut de Copilot Studio. L'URL par défaut redirige vers votre environnement personnel, qui ne dispose pas de Dataverse. Retrouvez l'identifiant de votre environnement dans le Centre d'administration de Power Platform, sous « Environnements ».

  1. Cliquez sur Créer > Nouvel agent et donnez-lui un nom (par exemple Agent PowerDMARC MCP).

  2. Une fois créé, accédez à Outils dans la barre latérale de gauche.

  3. Cliquez sur Ajouter un outil > Protocole de contexte de modèle (MCP).

4. Configurer la connexion MCP

  1. Dans l'assistant de l'outil MCP, collez l' URL du serveur MCP copiée à l'étape 9 de la section 1.

  2. Sous Type d’authentification, sélectionnez Clé API.

  3. Définissez le nom de l'en-tête sur Autorisation.

  4. Définissez la valeur de l'en-tête sur Bearer {votre-jeton}, en remplaçant {votre-jeton} par la partie JWT de l'URL de votre serveur MCP.

  5. Cliquez sur « Connecter ». Copilot Studio se connecte au serveur MCP et charge les outils disponibles.

  6. Consultez la liste des outils affichée : celle-ci reflète les autorisations associées à votre jeton API. Activez ou désactivez les outils selon vos besoins.

  7. Cliquez sur Enregistrer.

REMARQUE

Si la connexion échoue en raison d'une erreur d'authentification, vérifiez que les options « MCP » et « Jeton API principal » sont toutes deux activées pour votre jeton dans PowerDMARC. Si la connexion expire, vérifiez que mcp-dmarc.com est accessible depuis votre réseau.

5. Tester la connexion

  1. Dans votre agent Copilot Studio, ouvrez le panneau « Test » situé à droite de l'écran.

  2. Saisissez une requête de test telle que :

  • Répertorier mes domaines

  • Affiche-moi les données DMARC des 7 derniers jours

  • Combien d'e-mails n'ont pas passé le test DMARC cette semaine ?

  1. L'agent appelle les outils MCP concernés et renvoie des données en temps réel provenant de votre compte PowerDMARC.

REMARQUE

L'outil `list_domains` constitue le premier test le plus fiable. Une réponse positive confirme que la connexion MCP, l'authentification et les autorisations fonctionnent toutes correctement.

6. Publication de l'agent

AVERTISSEMENT

La publication d'un agent Copilot Studio à l'intention des utilisateurs finaux nécessite une licence complète de Microsoft Copilot Studio. Sans cette licence, l'agent ne peut être utilisé qu'à des fins de test en interne et ne peut pas être déployé sur une plateforme telle que Teams ou le Web.

Pour publier une fois que vous disposez de la licence requise :

  1. Dans l'agent, cliquez sur « Publier » dans la barre de navigation supérieure.

  2. Sélectionnez le canal de votre choix (par exemple, Microsoft TeamsWeb).

  3. Suivez les étapes de déploiement spécifiques à chaque chaîne fournies par Copilot Studio.

7. Contrôle d'accès

Cadre

Détails

Qui peut configurer l'intégration ?

Tout utilisateur de PowerDMARC disposant d'un accès aux paramètres de l'API

Autorisations des jetons

Configuration par jeton API — utiliser des périmètres en lecture seule pour les déploiements d'agents partagés

Limite du jeton API principal

Un seul jeton peut être désigné comme « principal » à la fois par compte.

Sensibilité de l'URL du serveur MCP

Contient un jeton d'authentification intégré — à traiter comme une information d'identification confidentielle

Publication par un agent

Nécessite une licence Microsoft Copilot Studio sur le tenant Microsoft

Comptes MSSP

Chaque MSSP peut configurer son propre jeton et son agent Copilot Studio de manière indépendante

Pour obtenir de l'aide, rendez-vous sur support.powerdmarc.com

P
PowerDMARC est l'auteur de cet article de solution.

L'avez-vous trouvé utile ? Oui Non

Envoyez vos commentaires
Désolé, nous n'avons pas pu vous aider. Aidez-nous à améliorer cet article en nous faisant part de vos commentaires.