Dit document beschrijft de stappen voor de integratie van onze API met SIEM. U kunt de onderstaande instructies volgen om PowerDMARC API gemakkelijk te integreren met SIEM.
API-documentatie:
Swagger-documentatie: https://app.powerdmarc.com/swagger-ui/index.html
Alternatieve documentatie: https://api.powerdmarc.com/
Stappen om verbinding te maken:
Genereer een nieuw token in de sectie Persoonlijke toegangstokens.
Geef de rechten op tijdens het genereren van het persoonlijke toegangsbewijs. (Rechten kunnen ook worden toegestaan tijdens het genereren van nieuwe tokens.)
Open de API-documentatie op https://app.powerdmarc.com/swagger-ui/index.html in de hoofdsectie API-instellingen.
Klik op de link /swagger.json en klik vervolgens met de rechtermuisknop om de API-collectie te downloaden door deze op te slaan als "swagger.json".
Open Postman en importeer de gedownloade verzameling.
Klik op de knop "meer acties bekijken" en selecteer vervolgens "Bewerken".
Navigeer naar de sectie Autorisatie en selecteer het auth type Bearer Token.
Plak het gegenereerde token in het tokenveld en sla op.
Navigeer naar het gedeelte Variabelen en voeg de variabele baseUrl met de waarde "https://app.powerdmarc.com/" toe onder de huidige waarde.
Om je eerste API-verzoek uit te voeren, selecteer je het verzoek dat je wilt verzenden en voeg je de baseUrl variabele toe aan de URL van het verzoek.
Selecteer in het Autorisatie gedeelte van het geopende verzoek het auth type "Auth van ouder overnemen". Deze optie moet ook voor andere verzoeken worden geselecteerd.
Zorg ervoor dat de geselecteerde request parameters, request headers, request URL en body overeenkomen met de API documentatie.
Sla de wijzigingen op en klik op de knop Verzenden.
Collectie bewerken > Machtigingsgedeelte
Collectie bewerken > Variabelen
Aanvraag > Machtigingsgedeelte
Verzoek headers - Postman wordt gebruikt om automatisch verzoekheaders te genereren. Zorg ervoor dat de Accept - application/json ook is opgenomen.
Sectie Lichaam en omgeving aanvragen
Bewerk verzameling en maak een tokenvariabele
- Bekijk de eindpunten voor auditlogs en creëerde baseUrl aan het begin van de URL
- Zie de tokenvariabele toegevoegd aan het juiste veld