Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Référence détaillée des événements du pare-feu DNS Resolver
Tous les événements des AWS services disposent d'un ensemble commun de champs contenant des métadonnées relatives à l'événement. Ces champs incluent le service source, l'heure à laquelle l'événement a été généré, ainsi que le compte et la région où l'événement a eu lieu. Pour les définitions de ces champs généraux, reportez-vous à la section Référence [ à la structure des ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) événements dans le Guide de *Amazon EventBridge l'utilisateur*.
En outre, chaque événement possède un champ `detail` qui contient des données spécifiques à cet événement en particulier. La référence ci-dessous définit les champs de détail pour les différents événements du pare-feu DNS.
Lors EventBridge de l'utilisation pour sélectionner et gérer les événements du pare-feu DNS, il est utile de garder à l'esprit les points suivants :
+ Le `source` champ pour tous les événements du pare-feu DNS est défini sur`aws.route53resolver`.
+ Le champ `detail-type` indique le type d'événement.
Par exemple, `DNS Firewall Block` ou `DNS Firewall Alert`.
+ Le champ `detail` contient les données spécifiques à cet événement en particulier.
Pour plus d'informations sur la création de modèles d'événements permettant aux règles de correspondre aux événements du pare-feu DNS, consultez la section Modèles d'[événements ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) dans le Guide de *Amazon EventBridge l'utilisateur*.
Pour plus d'informations sur les événements et la manière dont EventBridge ils sont traités, consultez les [Amazon EventBridge événements ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) dans le Guide de *Amazon EventBridge l'utilisateur*.
**Topics**
+ [Détail de l'événement d'alerte du pare-feu DNS](#dns-firewall-alert)
+ [Détail de l'événement de blocage du pare-feu DNS](#dns-firewall-block)
## Détail de l'événement d'alerte du pare-feu DNS
Vous trouverez ci-dessous les champs de détail pour le détail de l'événement relatif au statut de l'alerte.
Les `detail-type` champs `source` et sont inclus car ils contiennent des valeurs spécifiques pour les événements de la Route 53.
```
{...,
"detail-type": "DNS Firewall Alert",
"source": "aws.route53resolver",
...,
"detail": {
"account-id": "string",
"last-observed-at": "string",
"query-name": "string",
"query-type": "string",
"query-class": "string",
"transport": "string",
"firewall-rule-action": "string",
"firewall-rule-group-id": "string",
"firewall-domain-list-id": "string",
"firewall-protection": "string",
"resources": [{
"resource-type": "string",
"instance-details": {
"id": "string",
}
},
{
"resource-type": "string",
"resolver-endpoint-details": {
"id": "string"
}
}
]
```
`detail-type`
Identifie le type d'événement.
Pour cet événement, cette valeur est`DNS Firewall Alert`.
`source`
Identifie le service qui a généré l'événement. Pour les événements du pare-feu DNS, cette valeur est`aws.route53resolver`.
`detail`
Un objet JSON qui contient des informations sur l'événement. Le service qui génère l'événement détermine le contenu de ce champ.
Pour cet événement, ces données incluent :
`account-id`
L'ID de la personne Compte AWS qui a créé le VPC.
`last-observed-at`
Horodatage de la date à laquelle la Alert/Block requête a été effectuée dans le VPC.
`query-name`
Le nom de domaine (example.com) ou nom de sous-domaine (www.example.com) indiqué dans la requête.
`query-type`
Soit le type d'enregistrement DNS spécifié dans la demande, soit ANY. Pour en savoir plus sur les types pris en charge par Route 53, veuillez consulter [Types d'enregistrements DNS pris en charge](ResourceRecordTypes.md).
`query-class`
La classe de la requête.
`transport`
Le protocole utilisé pour soumettre la requête DNS.
`firewall-rule-action`
L'action indiquée par la règle qui correspond au nom de domaine de la requête. `ALERT` ou `BLOCK`.
`firewall-rule-group-id`
L'ID du groupe de règles de pare-feu DNS correspondant au nom de domaine de la requête. Pour plus d'informations sur les groupes de règles de pare-feu, consultez Pare-feu DNS[Règles et groupes de règles de pare-feu DNS](resolver-dns-firewall-rule-groups.md).
`firewall-domain-list-id`
La liste des domaines indiquée par la règle qui correspond au nom de domaine de la requête.
`firewall-protection`
Protection avancée du pare-feu DNS : DGA, DICTIONARY\_DGA ou DNS\_TUNNELING. Pour plus d'informations, consultez Pare-feu DNS[Règles avancées du pare-feu DNS](firewall-advanced.md).
`resourcese`
Contient les types de ressources et des informations supplémentaires les concernant.
`resource-type`
Spécifie le type de ressource, tel que le point de terminaison du résolveur ou une instance VPC.
`{{resource-type}}-detail`
Informations supplémentaires sur la ressource.
**Example Événement d'alerte du pare-feu DNS**
Voici un exemple d'événement d'alerte.
```
{
"version": "1.0",
"id": "8e5622f9-d81c-4d81-612a-9319e7ee2506",
"detail-type": "DNS Firewall Alert",
"source": "aws.route53resolver",
"account": "123456789012",
"time": "2023-05-30T21:52:17Z",
"region": "us-west-2",
"resources": [],
"detail": {
"account-id": "123456789012",
"last-observed-at": "2023-05-30T20:15:15.900Z",
"query-name": "15.3.4.32.in-addr.arpa.",
"query-type": "A",
"query-class": "IN",
"transport": "UDP",
"firewall-rule-action": "ALERT",
"firewall-rule-group-id": "rslvr-frg-01234567890abcdef",
"firewall-domain-list-id": "rslvr-fdl-01234567890abcdef",
"firewall-protection": "DGA",
"resources": [{
"resource-type": "instance",
"instance-details": {
"id": "i-05746eb48123455e0",
}
},
{
"resource-type": "resolver-endpoint",
"resolver-endpoint-details": {
"id": "i-05746eb48123455e0"
}
}
],
"src-addr": "4.5.64.102",
"src-port": "56067",
"vpc-id": "vpc-7example"
}
}
```
## Détail de l'événement de blocage du pare-feu DNS
Vous trouverez ci-dessous les champs de détail pour{{event name}}.
Les `detail-type` champs `source` et sont inclus car ils contiennent des valeurs spécifiques pour les événements de la Route 53.
```
{...,
"detail-type": "DNS Firewall Block",
"source": "aws.route53resolver",
...,
"detail": {
"account-id": "string",
"last-observed-at": "string",
"query-name": "string",
"query-type": "string",
"query-class": "string",
"transport": "string",
"firewall-rule-action": "string",
"firewall-rule-group-id": "string",
"firewall-domain-list-id": "string",
"firewall-protection": "string",
"resources": [{
"resource-type": "string",
"instance-details": {
"id": "string",
}
},
{
"resource-type": "string",
"resolver-endpoint-details": {
"id": "string"
}
}
]
```
`detail-type`
Identifie le type d'événement.
Pour cet événement, cette valeur est`DNS Firewall Alert`.
`source`
Identifie le service qui a généré l'événement. Pour les événements du pare-feu DNS, cette valeur est`aws.route53resolver`.
`detail`
Un objet JSON qui contient des informations sur l'événement. Le service qui génère l'événement détermine le contenu de ce champ.
Pour cet événement, ces données incluent :
`account-id`
L'ID de la personne Compte AWS qui a créé le VPC.
`last-observed-at`
Horodatage de la date à laquelle la Alert/Block requête a été effectuée dans le VPC.
`query-name`
Le nom de domaine (example.com) ou nom de sous-domaine (www.example.com) indiqué dans la requête.
`query-type`
Soit le type d'enregistrement DNS spécifié dans la demande, soit ANY. Pour en savoir plus sur les types pris en charge par Route 53, veuillez consulter [Types d'enregistrements DNS pris en charge](ResourceRecordTypes.md).
`query-class`
La classe de la requête.
`transport`
Le protocole utilisé pour soumettre la requête DNS.
`firewall-rule-action`
L'action indiquée par la règle qui correspond au nom de domaine de la requête. `ALERT` ou `BLOCK`.
`firewall-rule-group-id`
L'ID du groupe de règles de pare-feu DNS correspondant au nom de domaine de la requête. Pour plus d'informations sur les groupes de règles de pare-feu, consultez Pare-feu DNS[Règles et groupes de règles de pare-feu DNS](resolver-dns-firewall-rule-groups.md).
`firewall-domain-list-id`
La liste des domaines indiquée par la règle qui correspond au nom de domaine de la requête.
`firewall-protection`
Protection avancée du pare-feu DNS : DGA, DICTIONARY\_DGA ou DNS\_TUNNELING. Pour plus d'informations, consultez Pare-feu DNS[Règles avancées du pare-feu DNS](firewall-advanced.md).
`resourcese`
Contient les types de ressources et des informations supplémentaires les concernant.
`resource-type`
Spécifie le type de ressource, tel que le point de terminaison du résolveur ou une instance VPC.
`{{resource-type}}-detail`
Informations supplémentaires sur la ressource.
**Example Exemple d’évènement**
Voici un exemple d'événement de blocage.
```
{
"version": "1.0",
"id": "8e5622f9-d81c-4d81-612a-9319e7ee2506",
"detail-type": "DNS Firewall Block",
"source": "aws.route53resolver",
"account": "123456789012",
"time": "2023-05-30T21:52:17Z",
"region": "us-west-2",
"resources": [],
"detail": {
"account-id": "123456789012",
"last-observed-at": "2023-05-30T20:15:15.900Z",
"query-name": "15.3.4.32.in-addr.arpa.",
"query-type": "A",
"query-class": "IN",
"transport": "UDP",
"firewall-rule-action": "BLOCK",
"firewall-rule-group-id": "rslvr-frg-01234567890abcdef",
"firewall-domain-list-id": "rslvr-fdl-01234567890abcdef",
"firewall-protection": "DNS_TUNNELING",
"resources": [{
"resource-type": "instance",
"instance-details": {
"id": "i-05746eb48123455e0"
}
},
{
"resource-type": "resolver-endpoint",
"resolver-endpoint-details": {
"id": "i-05746eb48123455e0",
}
}
],
"src-addr": "4.5.64.102",
"src-port": "56067",
"vpc-id": "vpc-7example"
}
}
```