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.
Batch corrige par lots un arriéré de résultats à l'aide de l'API
L'interface utilisateur Web et l'action personnalisée CSPM d'AWS Security Hub sont pratiques pour corriger un petit nombre de résultats de manière interactive. Pour traiter un important arriéré de résultats existants de manière programmatique, par exemple, immédiatement après le déploiement de la solution, appelez directement l'API REST de la solution.
La même API REST qui soutient l'interface utilisateur Web (nommée AutomatedSecurityResponseApidans la console API Gateway) expose un POST /findings/action point de terminaison qui accepte un lot de résultats à corriger en une seule demande. Cela vous permet de créer des scripts pour corriger un arriéré plutôt que de sélectionner les résultats manuellement.
Note
Ce point de terminaison n'est disponible que lorsque l'interface utilisateur Web est activée (déployez la pile d'administration avec la valeur « oui » ShouldDeployWebUI définie sur « oui »). Vous pouvez trouver l'URL d'appel de l'API pour l'prodétape dans la console API Gateway de l'AutomatedSecurityResponseApiAPI.
Authentifier
Toutes les demandes d'API nécessitent un jeton d'accès Amazon Cognito émis pour le groupe d'utilisateurs de la solution, transmis dans l'Authorizationen-tête en tant que jeton porteur. Le jeton doit porter la asr-api/api lunette. Utilisez un jeton pour l'un des rôles de la solution (administrateur, administrateur délégué ou opérateur de compte) ; la même autorisation basée sur les rôles qui s'applique dans l'interface utilisateur Web s'applique à l'API. Pour une automatisation sans surveillance, obtenez un jeton à l'aide du flux OAuth de machine à machine (informations d'identification client) plutôt que d'une connexion utilisateur interactive.
Collectez les résultats pour y remédier
POST /findingsUtilisez-le pour rechercher et parcourir les résultats que vous souhaitez corriger, puis pour collecter les résultats findingId de chacun. Les résultats renvoyés sont limités aux comptes pour lesquels votre rôle est autorisé, de sorte qu'un opérateur de compte ne reçoit que les résultats pour les comptes qui lui sont assignés.
Appelez le point de terminaison d'action des résultats
Envoyez les identifiants de recherche collectés à POST /findings/action avec un actionType deRemediate. Chaque résultat est acheminé via l'orchestrateur exactement comme il le serait depuis l'interface utilisateur Web.
POST /findings/action Authorization: Bearer <access-token> Content-Type: application/json { "actionType": "Remediate", "findingIds": [ "arn:aws:securityhub:us-east-1:111111111111:security-control/Lambda.1/finding/...", "arn:aws:securityhub:us-east-1:111111111111:security-control/S3.5/finding/..." ] }
actionTypeaccepte égalementRemediateAndGenerateTicket, ce qui corrige la recherche et ouvre un ticket dans le canal de billetterie que vous avez configuré. Il accepte également Suppress etUnsuppress, qui masquent ou affichent un résultat dans la vue des résultats par défaut de la solution. Suppressne modifie pas le statut du flux de travail du résultat dans AWS Security Hub ou AWS Security Hub CSPM. Cela n'empêche pas non plus les mesures correctives entièrement automatisées, bien que le scan attendu pour faire respecter les délais ignore les résultats ainsi supprimés. Une RemediateAndGenerateTicket requête Remediate ou renvoie HTTP 202 avec le corps de {"status": "IN_PROGRESS"} ; Suppress et Unsuppress renvoie HTTP200.
Important
Envoyez au maximum 50 identifiants de recherche par demande. Pour remédier à un arriéré plus important, divisez les identifiants de recherche en lots de 50 ou moins et émettez une demande par lot. L'API est également protégée par des règles basées sur le débit (voir la configuration d'AWS WAF dans la politique de sécurité d'API Gateway), donc accélérez les lots successifs plutôt que de les envoyer tous en une seule fois.
Surveiller la progression
Les corrections initiées via l'API s'exécutent de manière asynchrone, comme celles lancées depuis l'interface utilisateur Web. Suivez leur progression sur la page Historique des exécutions de l'interface utilisateur Web, via les notifications Amazon SNS de la solution ou en interrogeant. POST /remediations