Ce document décrit les étapes de l'intégration de notre API avec SIEM. Vous pouvez suivre les instructions données ci-dessous pour intégrer facilement l'API PowerDMARC au SIEM.
Documentation de l'API:
Documentation Swagger : https://app.powerdmarc.com/swagger-ui/index.html
Documentation alternative : https://api.powerdmarc.com/
Étapes à suivre pour se connecter :
Générez un nouveau jeton à partir de la section Jetons d'accès personnels.
Spécifiez les autorisations lors de la génération du jeton d'accès personnel. (Des autorisations peuvent également être accordées lors de la création de nouveaux jetons.)
Ouvrez la documentation de l'API à l'adresse https://app.powerdmarc.com/swagger-ui/index.html dans la section principale API Settings.
Cliquez sur le lien /swagger.json, puis faites un clic droit pour télécharger la collection d'API en l'enregistrant sous "swagger.json".
Ouvrez Postman et importez la collection téléchargée.
Cliquez sur le bouton "Afficher plus d'actions", puis sélectionnez "Modifier".
Naviguez vers la section Autorisation et sélectionnez le type d'authentification Bearer Token.
Collez le jeton généré dans le champ du jeton et enregistrez.
Naviguez vers la section Variables et ajoutez la variable baseUrl avec la valeur "https://app.powerdmarc.com/" sous la valeur actuelle.
Pour effectuer votre première requête API, sélectionnez la requête que vous souhaitez envoyer et ajoutez la variable baseUrl à l'URL de la requête.
Dans la section Autorisation de la demande ouverte, sélectionnez le type d'authentification "Hériter de l'authentification du parent". Cette option doit être sélectionnée pour les demandes suivantes également.
Assurez-vous que les paramètres, les en-têtes, l'URL et le corps de la requête sélectionnée correspondent à la documentation de l'API.
Enregistrez les modifications et cliquez sur le bouton Envoyer.
Modifier la collection > Section d'autorisation
Modifier la collection > Section des variables
Demande > Section autorisation
En-têtes de requête - Postman est utilisé pour générer automatiquement les en-têtes de requête. Assurez-vous que l'en-tête Accept - application/json est également inclus.
Demande de la section Corps et environnements
Modifier la collection et créer une variable token
- Voir les points de terminaison des journaux d'audit et l'URL de base créée au début de l'URL.
- Voir la variable token ajoutée au champ approprié
