For the complete documentation index, see llms.txt. This page is also available as Markdown.

Configuration : AWS

Accordez au scan cloud un accès en lecture seule à un compte AWS en créant une politique et un rôle, puis en collant l'ARN du rôle dans Stoïk Protect.

Prérequis

  • Un compte administrateur sur le compte AWS à analyser.

  • Si vous utilisez AWS Organizations, vos Service Control Policies (SCP) ne doivent pas bloquer les autorisations en lecture seule ci-dessous. Les SCP sont la cause la plus fréquente des échecs de configuration, voir Dépannage.

  • Un conseiller technique est requis pour la supervision continue et la remédiation des vulnérabilités.

  • Une seule personne effectue toute la configuration, du début à la fin : un utilisateur Stoïk Protect autorisé à modifier les outils de prévention, qui est aussi administrateur du compte AWS.

Configuration

1

Sélectionnez Amazon Web Services

Accédez à Scan Cloud > Paramètres, cliquez Nouveau fournisseur, puis sélectionnez AWS.

2

Créer une nouvelle politique

Configurer la politique

  1. Allez sur le Créateur de politique AWS et connectez-vous avec votre compte administrateur.

  2. Cliquez sur JSON onglet et collez la politique suivante dans l'éditeur :

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "ecr:BatchGetRepositoryScanningConfiguration",
            "ecr:DescribeImageScanFindings",
            "ecr:DescribeImages",
            "dynamodb:ListTagsOfResource",
            "ecr:ListTagsForResource",
            "inspector2:BatchGet*",
            "inspector2:Get*",
            "inspector2:Describe*",
            "inspector2:List*",
            "sqs:ListQueueTags",
            "sso:Describe*",
            "sso:List*"
          ],
          "Resource": "*"
        },
        {
          "Effect": "Deny",
          "Action": [
            "datapipeline:EvaluateExpression",
            "datapipeline:QueryObjects",
            "rds:DownloadDBLogFilePortion"
          ],
          "Resource": "*"
        }
      ]
    }
  3. Cliquez sur Suivant.

Enregistrez la politique

  1. Nommez la politique StoikAdditionalPermissions.

  2. Cliquez sur Créer la politique.

3

Créer un nouveau rôle

Configurer la relation d'approbation du rôle

  1. Cliquez sur Compte AWS, puis Un autre compte AWS, puis saisissez l'ID de compte suivant :

    436578779424
  2. Sélectionner Exiger un ID externe et copiez la valeur affichée dans la console Stoïk Protect.

  3. Cliquez sur Suivant.

Attribuer les autorisations et finaliser

  1. Sélectionner StoikAdditionalPermissions et SecurityAudit comme autorisations.

  2. Cliquez sur Suivant.

  3. Saisissez stoik-auditor comme nom du rôle.

  4. Cliquez sur Créer le rôle.

4

Ajoutez un identifiant ARN

  1. Allez sur le stoik-auditor du rôle que vous venez de créer.

  2. Copiez la ARN référence.

5

Terminer la configuration

  1. Collez la ARN référence dans le champ dédié de la console Stoïk Protect.

  2. Cliquez sur Terminer la configuration.

Actualisez la page Stoïk Protect si nécessaire.

AWS Organizations

Avec AWS Organizations, créez le stoik-auditor rôle dans chaque compte membre que vous souhaitez analyser, et pas seulement dans le compte de gestion. Toutes les autorisations demandées sont en lecture seule : la politique gérée par AWS SecurityAudit plus la politique StoikAdditionalPermissions. Il n'existe pas d'ensemble plus restreint.

Dépannage

"L'intégration avec AWS a échoué" / "Impossible d'assumer le rôle"

Vérifiez-les dans cet ordre, en commençant par les plus fréquents :

  1. ID externe : la valeur dans Stoïk Protect doit correspondre exactement à sts:ExternalId dans la politique d'approbation du rôle. La casse et les espaces comptent. Un ID externe provenant d'une tentative précédente échoue également.

  2. Compte de confiance : la politique d'approbation fait confiance au compte 436578779424.

  3. Rôle : stoik-auditor existe dans ce compte, et l'ARN collé dans Stoïk Protect est bien son ARN. Pour un rôle qui n'existe pas, AWS répond « accès refusé », pas « introuvable ».

  4. Politiques : les deux SecurityAudit et StoikAdditionalPermissions sont attachées, et la seconde correspond au JSON ci-dessus. Les anciennes configurations omettent souvent sso:Describe* et sso:List*.

Tout est correct, mais la configuration affiche toujours « rôles mal configurés »

Il s'agit généralement d'une politique de contrôle des services (SCP). Avant d'accepter un compte, Stoïk vérifie son rôle avec le simulateur d'autorisations d'AWS, et certaines SCP font refuser au simulateur chaque autorisation, même si l'analyse réelle fonctionne. Contactez protect@stoik.io avec l'ID de votre compte AWS.

L'analyse a fonctionné, puis s'est arrêtée

Quelque chose a changé de votre côté : le rôle a été supprimé ou renommé, une politique a été détachée, l'ID externe a changé ou une nouvelle SCP a été ajoutée. Passez en revue les quatre vérifications dans "L'intégration avec AWS a échoué" / "Impossible d'assumer le rôle".

Mis à jour