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 permet de suivre et de résoudre les erreurs de 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 plage de temps mentionnée et analyse le groupe de journaux à la recherche d'erreurs dans le groupe de CloudWatch journaux VPN.
Fonctionnement
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 certains flux de journaux dans le groupe de journaux correspondent à 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 Gestion des identités et des accès AWS (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 démarre 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
Schéma autorisé :
^[\.\-_/#A-Za-z0-9]{1,512} -
VpnConnectionId
Type : Chaîne
Description : (Obligatoire) L'identifiant de AWS Site-to-Site VPN connexion doit être résolu.
Schéma 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 à votre AWS Site-to-Site VPN.
Schéma 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 à votre AWS Site-to-Site VPN.
Schéma 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 IKEA
Type : Chaîne
Description : (Obligatoire) Sélectionnez la version d'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 des journaux. Vous pouvez utiliser StartTimeinEpoch/EndTimeinEpoch ou LookBackPeriod pour l'analyse des journaux
Schéma autorisé :
^\d{10}|^$ -
EndTimeinEpoch
Type : Chaîne
Description : (Facultatif) Heure de fin de l'analyse des journaux. Vous pouvez utiliser StartTimeinEpoch/EndTimeinEpoch ou LookBackPeriod pour l'analyse des journaux. Si les deux sont donnés StartTimeinEpoch/EndTimeinEpoch , LookBackPeriod alors LookBackPeriod a la priorité
Schéma autorisé :
^\d{10}|^$ -
LookBackPeriod
Type : Chaîne
Description : (Facultatif) Heure à deux chiffres en heures pour revenir en arrière à des fins d'analyse du journal. Plage valide : 01 - 99. Cette valeur est prioritaire si vous donnez StartTimeinEpoch également et EndTime
Schéma 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 à AWSSupport-TroubleshootVPN
dans la AWS Systems Manager console. -
Pour les paramètres d'entrée, entrez les informations suivantes :
-
AutomationAssumeRole (Facultatif) :
Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (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 démarre ce runbook.
-
LogGroupName (Obligatoire) :
Le nom du groupe de CloudWatch journaux Amazon à valider. Il doit s'agir du groupe de CloudWatch journaux auquel le VPN doit envoyer les journaux.
-
VpnConnectionId (Obligatoire) :
L'identifiant de AWS Site-to-Site VPN connexion dont le groupe de journaux est suivi 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 BIP du tunnel (facultatif) :
L'adresse IP du tunnel B associée à votre AWS Site-to-Site VPN connexion.
-
Version IKEA (obligatoire) :
Sélectionnez la version d'IKEversion que vous utilisez. Valeurs autorisées : IKEv1, IKEv2.
-
StartTimeinEpoch (Facultatif) :
Début de la plage de temps pour rechercher une erreur. La plage est inclusive, de sorte que l'heure de début spécifiée est incluse dans la requête. Spécifié comme heure d'époque, le nombre de secondes écoulées depuis le 1er janvier 1970, 00:00:00 UTC.
-
EndTimeinEpoch (Facultatif) :
Fin de la plage de temps pour rechercher des erreurs. La plage est inclusive, de sorte que l'heure de fin spécifiée est incluse dans la requête. Spécifié comme heure d'é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 à la requête pour détecter une erreur.
Remarque : Configurez un StartTimeinEpoch EndTimeinEpoch, ou LookBackPeriod pour fixer l'intervalle de temps pour l'analyse des journaux. Donnez un numéro à deux chiffres en heures pour vérifier les erreurs passées à partir de l'heure de début de l'automatisation. Ou, si l'erreur se situe 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.
-
succursale OnValidationOfLogGroup :
Vérifie si le groupe de journaux mentionné dans le paramètre est valide. S'il n'est pas valide, il interrompt le lancement ultérieur des étapes d'automatisation.
-
succursale OnValidationOfLogStream :
Vérifie si un flux de journaux existe dans le groupe de CloudWatch journaux inclus. S'il n'est pas valide, il interrompt le lancement ultérieur des étapes d'automatisation.
-
succursale OnValidationOfVpnConnectionId :
Vérifie si l'identifiant de connexion VPN inclus dans le paramètre est valide. S'il n'est pas valide, il interrompt le lancement ultérieur des étapes d'automatisation.
-
succursale OnValidationOfVpnIp :
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 la poursuite de l'exécution des étapes d'automatisation.
-
Erreur de traçage :
Effectue un appel à l'API Logs Insight dans le groupe de CloudWatch journaux que vous avez inclus et recherche l'erreur associée IKEv1/IKEv2 ainsi qu'une suggestion de résolution associée.
-
-
Une fois terminé, consultez la section Sorties pour obtenir les résultats détaillés de l'exécution.
Références
Systems Manager Automation
AWS documentation de service
