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.
AWSSupport-TroubleshootVPN
Description
Le AWSSupport-TroubleshootVPN
runbook vous aide à suivre et à résoudre les erreurs dans une AWS Site-to-Site VPN connexion. L'automatisation comprend plusieurs contrôles automatisés conçus pour détecter les IKEv1
IKEv2
erreurs liées aux tunnels de AWS Site-to-Site VPN connexion. L'automatisation essaie de faire correspondre des erreurs spécifiques et la résolution correspondante forme une liste de problèmes courants.
Remarque : Cette automatisation ne corrige pas les erreurs. Il s'exécute pendant la période mentionnée et analyse le groupe de journaux à la recherche d'erreurs dans le groupe de CloudWatch journaux VPN.
Comment fonctionne-t-il ?
Le runbook exécute une validation des paramètres pour confirmer si le groupe de CloudWatch journaux Amazon inclus dans le paramètre d'entrée existe, si le groupe de journaux contient des flux de journaux correspondant à la journalisation du tunnel VPN, si l'identifiant de connexion VPN existe et si l'adresse IP du tunnel existe. Il effectue des appels d'API Logs Insights sur votre groupe de CloudWatch journaux qui sont configurés pour la journalisation VPN.
Type de document
Automatisation
Propriétaire
Amazon
Plateformes
LinuxmacOS, Windows
Paramètres
-
AutomationAssumeRole
Type : chaîne
Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle AWS Identity and Access Management (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.
-
LogGroupName
Type : chaîne
Description : (Obligatoire) Le nom du groupe de CloudWatch journaux Amazon configuré pour la journalisation des AWS Site-to-Site VPN connexions
Modèle autorisé :
^[\.\-_/#A-Za-z0-9]{1,512}
-
VpnConnectionId
Type : chaîne
Description : (Obligatoire) L'identifiant de AWS Site-to-Site VPN connexion à résoudre.
Modèle autorisé :
^vpn-[0-9a-f]{8,17}$
-
Adresse IP du tunnel
Type : chaîne
Description : (Obligatoire) L'adresse IPv4 du tunnel numéro 1 associée à votreAWS Site-to-Site VPN.
Modèle autorisé :
^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)[.]){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?){1}$
-
Adresse IP du tunnel
Type : chaîne
Description : (Facultatif) L'adresse IPv4 du tunnel numéro 2 associée à votreAWS Site-to-Site VPN.
Modèle autorisé :
^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)[.]){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?){1}|^$
-
Version IKE
Type : chaîne
Description : (Obligatoire) Sélectionnez la version IKE que vous utilisez. Valeurs autorisées : IKEv1, IKEv2
Valeurs valides :
['IKEv1', 'IKEv2']
-
StartTimeinEpoch
Type : chaîne
Description : (Facultatif) Heure de début de l'analyse du journal. Vous pouvez utiliser StartTimeinEpoch/EndTimeinEpoch ou LookBackPeriod pour l'analyse des journaux
Modèle autorisé :
^\d{10}|^$
-
EndTimeinEpoch
Type : chaîne
Description : (Facultatif) Heure de fin de l'analyse du journal. Vous pouvez utiliser StartTimeinEpoch/EndTimeinEpoch ou LookBackPeriod pour l'analyse des journaux. Si on donne à la fois « StartTimeinEpoch/» EndTimeinEpoch et « LookBackPeriod then » LookBackPeriod ont la priorité
Modèle autorisé :
^\d{10}|^$
-
LookBackPeriod
Type : chaîne
Description : (Facultatif) Durée à deux chiffres en heures de consultation rétrospective pour l'analyse du journal. Plage valide : 01 - 99. Cette valeur est prioritaire si vous indiquez StartTimeinEpoch également et EndTime
Modèle autorisé :
^(\d?[1-9]|[1-9]0)|^$
Autorisations IAM requises
Le AutomationAssumeRole
paramètre nécessite les actions suivantes pour utiliser correctement le runbook.
logs:DescribeLogGroups
logs:GetQueryResults
logs:DescribeLogStreams
logs:StartQuery
ec2:DescribeVpnConnections
Instructions
Remarque : Cette automatisation fonctionne sur les groupes de CloudWatch journaux configurés pour la journalisation de votre tunnel VPN, lorsque le format de sortie de journalisation est JSON.
Pour configurer l'automatisation, procédez comme suit :
Accédez au AWSSupport-TroubleshootVPN
dans la console. AWS Systems Manager -
Pour les paramètres d'entrée, entrez ce qui suit :
-
AutomationAssumeRole (Facultatif) :
Amazon Resource Name (ARN) du rôle AWS Identity and Access Management (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.
-
LogGroupName (Obligatoire) :
Le nom du groupe de CloudWatch journaux Amazon à valider. Il doit s'agir du groupe de CloudWatch journaux configuré pour que le VPN envoie des journaux.
-
VpnConnectionId (Obligatoire) :
L'identifiant de AWS Site-to-Site VPN connexion dont le groupe de journaux est tracé pour détecter une erreur VPN.
-
Adresse IP du tunnel (obligatoire) :
Le tunnel Une adresse IP associée à votre AWS Site-to-Site VPN connexion.
-
Adresse IP du tunnel (facultatif) :
Adresse IP du tunnel B associée à votre AWS Site-to-Site VPN connexion.
-
Version IKE (obligatoire) :
Sélectionnez la version d'IkeVersion que vous utilisez. Valeurs autorisées : IKEv1, IKEv2.
-
StartTimeinEpoch (Facultatif) :
Début de l'intervalle de temps pour rechercher une erreur. La plage étant inclusive, l'heure de début spécifiée est incluse dans la requête. Spécifié comme heure de l'époque, le nombre de secondes écoulées depuis le 1er janvier 1970, 00:00:00 UTC.
-
EndTimeinEpoch (Facultatif) :
Fin de l'intervalle de temps pour rechercher des erreurs. La plage étant inclusive, l'heure de fin spécifiée est incluse dans la requête. Spécifié comme heure de l'époque, le nombre de secondes écoulées depuis le 1er janvier 1970, 00:00:00 UTC.
-
LookBackPeriod (Obligatoire) :
Temps, en heures, nécessaire pour revenir sur la requête afin de détecter une erreur.
Remarque : Configurez un StartTimeinEpoch EndTimeinEpoch, ou LookBackPeriod pour fixer la plage de temps pour l'analyse des journaux. Donnez un nombre à deux chiffres en heures pour vérifier les erreurs passées depuis le début de l'automatisation. Ou, si l'erreur s'est produite dans le passé dans un intervalle de temps spécifique, incluez StartTimeinEpoch et EndTimeinEpoch, au lieu de LookBackPeriod.
-
-
Sélectionnez Exécuter.
-
L'automatisation démarre.
-
Le runbook d'automatisation exécute les étapes suivantes :
-
Validation des paramètres :
Exécute une série de validations sur les paramètres d'entrée inclus dans l'automatisation.
-
branchOnValidationOfLogGroup:
Vérifie si le groupe de logs mentionné dans le paramètre est valide. S'il n'est pas valide, il arrête le lancement ultérieur des étapes d'automatisation.
-
branchOnValidationOfLogStream:
Vérifie si le flux de journaux existe dans le groupe de CloudWatch journaux inclus. S'il n'est pas valide, il arrête le lancement ultérieur des étapes d'automatisation.
-
branchOnValidationOfVpnConnectionId:
Vérifie si l'identifiant de connexion VPN inclus dans le paramètre est valide. S'il n'est pas valide, il arrête le lancement ultérieur des étapes d'automatisation.
-
branchOnValidationOfVpnIp:
Vérifie si l'adresse IP du tunnel mentionnée dans le paramètre est valide ou non. S'il n'est pas valide, il arrête l'exécution ultérieure des étapes d'automatisation.
-
Erreur de trace :
Fait un appel à l'API Logs Insight dans le groupe de CloudWatch journaux inclus et recherche l'erreur liée à IKEv1/IKEv2 ainsi qu'une solution suggérée associée.
-
-
Une fois terminé, consultez la section Sorties pour connaître les résultats détaillés de l'exécution.
Références
Systems Manager Automation
AWSdocumentation de service