Registre de phishing per correu electrònic

Aquest informe és un registre de phishing a nivell d’esdeveniment: una fila per cada interacció de simulació observada (data, acció, correu electrònic del destinatari, assumpte, remitent, dificultat). Es manté en format llarg: no condensa l’historial d’una persona en un únic resultat. La consulta inclou els 12 mesos naturals més recents a occurred_after (mitjanit UTC del mateix dia del mes de fa dotze mesos, no una durada de 365 dies). La configuració, les credencials, la paginació i els reintents per límit de peticions són els mateixos que a la guia de connectivitat de Power BI / Excel. Afegiu primer la consulta compartida Fn_FetchAll; aquest informe la crida pel nom.

​

Required key scopes

Una clau que només tingui concedit simulation:read no pot cridar l’endpoint d’esdeveniments dels informes (l’API retorna 403). Vegeu trieu el grau de detall adequat.

​

Source endpoints

Filtres permesos a la llista d’esdeveniments (qualsevol altre retorna 400): limit, page_token, simulation, entity, event_type, occurred_after. Aquesta família d’informes és un conjunt de dades en versió preliminar. Podeu consultar l’esquema del conjunt de dades i les polítiques de dades a GET /v1/reporting/datasets i GET /v1/reporting/datasets/simulation_events.

​

Grain

Una fila per cada esdeveniment de simulació de l’informe. Una persona que ha obert i després ha fet clic al mateix missatge genera dues files. Els esdeveniments amb un entity_id nul (sense actor, destinatari ni participant objectiu) també apareixen; email és nul. La finestra de l’API s’amplia un minut; el límit exacte de occurred_at >= WindowStart es torna a aplicar localment perquè l’any més recent no depengui de si el servidor tracta occurred_after com a inclusiu o exclusiu. Pressupost de peticions: un recorregut paginat dels esdeveniments de la finestra, més un recorregut de les entitats. Definiu sempre limit = "500".

​

Column mapping

Els noms de columna anteriors provenen de l’exportació del vostre proveïdor anterior. Els camps de /v1 són els noms públics de l’API; la consulta n’anomena alguns amb àlies per a l’informe.

​

Action tokens

action és el token tancat de l’informe. El «Email Sent» anterior es correspon amb simulation.delivered (delivered és el verb públic; el token a la xarxa és simulation.delivered). Camps addicionals que es mantenen perquè l’API els proporciona: sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at, a més de entity_type i entity_status de la unió d’entitats.

​

Divergences from the legacy export

• La IP en brut mai no està disponible. /v1 no exposarà la IP del client en brut: és una decisió de privadesa per disseny, no una assignació pendent. La consulta no afegeix cap columna d’IP de substitució.
• El tipus de dispositiu és derivat, no en brut. device_type és una classe de dispositiu derivada per als esdeveniments de clic, enviament i informe. Els tokens observats inclouen desktop, mobile, tablet i unknown, però l’emissor desa una cadena de format lliure: tracteu-la com a text obert, no com una enumeració tancada. És nul·la quan l’esdeveniment no té cap classe derivada, i la cadena en brut de user_agent es manté privada.
• «Email Sent» és simulation.delivered. Useu aquest token quan filtreu o compteu enviaments. No cerqueu la cadena email_sent anterior.
• El correu electrònic del destinatari és una unió, no un camp de l’esdeveniment. L’esdeveniment de l’informe omet el correu electrònic; la consulta recorre /entities per emplenar-lo.
• 12 mesos naturals més recents, no una durada de 365 dies ni tot l’historial.
• Format llarg, no condensat. Una fila per interacció, no un resultat per persona.

​

Next steps