> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Créer un utilisateur AWS IAM et un bucket S3

> Créer un utilisateur AWS IAM et un bucket S3.

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

> Ce guide explique comment configurer un utilisateur IAM et un bucket S3 dans AWS,
> une étape préalable pour effectuer des sauvegardes vers S3 ou configurer ClickHouse afin de
> stocker des données sur S3

<div id="create-an-aws-iam-user">
  ## Créer un utilisateur AWS IAM
</div>

Dans cette procédure, nous allons créer un utilisateur de compte de service, et non un utilisateur de connexion.

1. Connectez-vous à l'AWS IAM Management Console.

2. Dans l'onglet `Users`, sélectionnez `Create user`

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-1.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=5981591d51b6f0e75ccabfbf2c2592dd" alt="AWS IAM Management Console - Ajout d'un nouvel utilisateur" width="4040" height="1940" data-path="images/_snippets/s3/2025/s3-1.webp" />

3. Saisissez un nom d'utilisateur

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-2.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=826ae6a942c88af0a5189d5aba0577bd" alt="AWS IAM Management Console - Ajout d'un nouvel utilisateur" width="4040" height="1408" data-path="images/_snippets/s3/2025/s3-2.webp" />

4. Sélectionnez `Next`

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-3.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=8e70cf0524585ef59b3efddb9da1495a" alt="AWS IAM Management Console - Ajout d'un nouvel utilisateur" width="4040" height="1860" data-path="images/_snippets/s3/2025/s3-3.webp" />

5. Sélectionnez `Next`

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-4.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=90c3b7dcf79ad5cf235aac92472312a1" alt="AWS IAM Management Console - Ajout d'un nouvel utilisateur" width="4040" height="1850" data-path="images/_snippets/s3/2025/s3-4.webp" />

6. Sélectionnez `Create user`

L'utilisateur est maintenant créé.
Cliquez sur l'utilisateur que vous venez de créer

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-5.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=d92969676845ca4fc60d6190b3723e76" alt="AWS IAM Management Console - Ajout d'un nouvel utilisateur" width="4040" height="792" data-path="images/_snippets/s3/2025/s3-5.webp" />

7. Sélectionnez `Create access key`

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-6.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=fbe63ebdc53c0bcc1ccf38d6e2389161" alt="AWS IAM Management Console - Ajout d'un nouvel utilisateur" width="4040" height="1900" data-path="images/_snippets/s3/2025/s3-6.webp" />

8. Sélectionnez `Application running outside AWS`

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-7.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=bb7786aaef483965ac41a2bb85b29c1a" alt="AWS IAM Management Console - Ajout d'un nouvel utilisateur" width="4040" height="1942" data-path="images/_snippets/s3/2025/s3-7.webp" />

9. Sélectionnez `Create access key`

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-8.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=c4c941586095414726fa125cf356bfac" alt="AWS IAM Management Console - Ajout d'un nouvel utilisateur" width="4040" height="1080" data-path="images/_snippets/s3/2025/s3-8.webp" />

10. Téléchargez votre clé d'accès et votre secret au format .csv pour les utiliser ultérieurement

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-9.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=50b6dc25424210feb1dac03736193154" alt="AWS IAM Management Console - Ajout d'un nouvel utilisateur" width="3912" height="2036" data-path="images/_snippets/s3/2025/s3-9.webp" />

<div id="create-an-s3-bucket">
  ## Créer un bucket S3
</div>

1. Dans la section des buckets S3, sélectionnez **Create bucket**

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-10.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=accd3f7aa98107f682fcf2167de9db13" alt="AWS IAM Management Console - Ajout d’un nouvel utilisateur" width="4040" height="2518" data-path="images/_snippets/s3/2025/s3-10.webp" />

2. Saisissez un nom de bucket et laissez les autres options par défaut

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-11.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=4821eb695c3e1c3f767b4685bb6fee7d" alt="AWS IAM Management Console - Ajout d’un nouvel utilisateur" width="4040" height="1118" data-path="images/_snippets/s3/2025/s3-11.webp" />

<Note>
  Le nom du bucket doit être unique à l’échelle d’AWS, et pas seulement au sein de l’organisation, sinon une erreur sera renvoyée.
</Note>

3. Laissez `Block all Public Access` activé ; l’accès public n’est pas nécessaire.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-12.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=44e7deaf9c8a8350d840442a1c9647b0" alt="AWS IAM Management Console - Ajout d’un nouvel utilisateur" width="4040" height="1106" data-path="images/_snippets/s3/2025/s3-12.webp" />

4. Sélectionnez **Create Bucket** en bas de la page

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-13.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=4bfdd4c922499417efe6a687e15c67d7" alt="AWS IAM Management Console - Ajout d’un nouvel utilisateur" width="4040" height="1872" data-path="images/_snippets/s3/2025/s3-13.webp" />

5. Sélectionnez le lien, copiez l’ARN et enregistrez-le pour l’utiliser lors de la configuration de la stratégie d’accès du bucket

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-14.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=42e220c6554e9d0164fb1095ec375098" alt="AWS IAM Management Console - Ajout d’un nouvel utilisateur" width="4040" height="934" data-path="images/_snippets/s3/2025/s3-14.webp" />

6. Une fois le bucket créé, repérez le nouveau bucket S3 dans la liste des buckets S3 et sélectionnez son nom pour accéder à la page ci-dessous :

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-15.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=509cf27e3844b9bd331f0fc546f2335b" alt="AWS IAM Management Console - Ajout d’un nouvel utilisateur" width="4040" height="1400" data-path="images/_snippets/s3/2025/s3-15.webp" />

7. Sélectionnez `Create folder`

8. Saisissez un nom de dossier qui servira de cible pour le S3 disk ou le Backup de ClickHouse, puis sélectionnez `Create folder` en bas de la page

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-16.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=36935c5e148e7710698a969ed7fc37a3" alt="AWS IAM Management Console - Ajout d’un nouvel utilisateur" width="3992" height="1352" data-path="images/_snippets/s3/2025/s3-16.webp" />

9. Le dossier doit maintenant apparaître dans la liste du bucket

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-17.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=77d3fd57f04a29ede83d51615a2244c1" alt="AWS IAM Management Console - Ajout d’un nouvel utilisateur" width="4040" height="1330" data-path="images/_snippets/s3/2025/s3-17.webp" />

10. Cochez la case du nouveau dossier, puis cliquez sur `Copy URL`. Enregistrez l’URL pour l’utiliser dans la Storage configuration de ClickHouse à l’étape suivante.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-18.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=b84c63145363d5b3ebdc18002b3ac0fa" alt="AWS IAM Management Console - Ajout d’un nouvel utilisateur" width="4040" height="992" data-path="images/_snippets/s3/2025/s3-18.webp" />

11. Sélectionnez l’onglet **Permissions** et cliquez sur le bouton **Edit** dans la section **Bucket Policy**

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/s3/2025/s3-19.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=c3fb7bf2d59bce914850d64a71125854" alt="AWS IAM Management Console - Ajout d’un nouvel utilisateur" width="4040" height="954" data-path="images/_snippets/s3/2025/s3-19.webp" />

12. Ajoutez une stratégie de bucket, par exemple comme ci-dessous

```json theme={null}
{
    "Version": "2012-10-17",
    "Id": "Policy123456",
    "Statement": [
        {
            "Sid": "abc123",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::782985192762:user/docs-s3-user"
            },
            "Action": "s3:*",
            "Resource": [
                "arn:aws:s3:::ch-docs-s3-bucket",
                "arn:aws:s3:::ch-docs-s3-bucket/*"
            ]
        }
    ]
}
```

<Note>
  La stratégie ci-dessus permet d’effectuer toutes les actions sur le bucket
</Note>

| Paramètre | Description                                                       | Valeur d’exemple                                                      |
| --------- | ----------------------------------------------------------------- | --------------------------------------------------------------------- |
| Version   | Version de l’interpréteur de stratégies, à laisser telle quelle   | 2012-10-17                                                            |
| Sid       | Identifiant de stratégie défini par l’utilisateur                 | abc123                                                                |
| Effect    | Indique si les requêtes utilisateur seront autorisées ou refusées | Allow                                                                 |
| Principal | Les comptes ou l’utilisateur qui seront autorisés                 | arn:aws:iam::782985192762:user/docs-s3-user                           |
| Action    | Quelles opérations sont autorisées sur le bucket                  | s3:\*                                                                 |
| Resource  | Sur quelles ressources du bucket les opérations seront autorisées | "arn:aws:s3:::ch-docs-s3-bucket", "arn:aws:s3:::ch-docs-s3-bucket/\*" |

<Note>
  Vous devriez travailler avec votre équipe de sécurité pour déterminer les autorisations à utiliser ; considérez-les comme un point de départ.
  Pour plus d’informations sur les stratégies et les paramètres, consultez la documentation AWS :
  [https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-policy-language-overview.html](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-policy-language-overview.html)
</Note>

13. Enregistrez la configuration de la stratégie
