> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-fr/byos/connecting-shade-with-aws-s3.md).

# Connexion de Shade à AWS S3

**Créer le bucket**

1. Créez un bucket. Notez la région et le nom du bucket que vous créez
   1. Modifiez uniquement le champ du nom du bucket. Tous les autres paramètres par défaut peuvent rester inchangés (usage général, pas d’ACL, bloquer tout accès public, pas de versioning du bucket, chiffrement côté serveur, aucun paramètre avancé)

**Configuration CORS**

1. Cliquez sur le bucket puis sur l’onglet des autorisations. Faites défiler jusqu’à la `Partage de ressources entre origines (CORS)` section.

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FkGVNB69nqWLvUWJIWdNT%2Fimage.png?alt=media&amp;token=857eb17c-3f40-45eb-a29f-f6dac0bcf606" alt=""><figcaption></figcaption></figure>

2\. Cliquez sur Modifier puis collez ce JSON.

{% code fullWidth="false" %}

```
[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "GET",
            "PUT",
            "POST",
            "DELETE",
            "HEAD"
        ],
        "AllowedOrigins": [
            "*"
        ],
        "ExposeHeaders": [
            "ETag",
            "Content-Length",
            "Content-Disposition",
            "Content-Encoding",
            "x-amz-request-id",
            "x-amz-id-2",
            "x-amz-version-id",
            "x-amz-server-side-encryption"
        ],
        "MaxAgeSeconds": 3000
    }
]
```

{% endcode %}

Ce JSON est utilisé pour autoriser les navigateurs web à accéder à ce bucket. C’est sécurisé, car nous fournissons des redirections depuis notre serveur, et nous conservons la portée spécifique des autorisations CORS, de sorte que cette configuration peut rester générique.

**Créer la stratégie ciblée**

1. Sous `IAM` cliquez `Stratégies` puis cliquez sur `Créer une stratégie`

   1. La plupart des erreurs que nous constatons se produisent justement ici, lorsque les stratégies ne sont pas correctement personnalisées

   <figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FnZIqNYO9wGBNJ2vby63E%2Fimage.png?alt=media&amp;token=406f35f0-121f-4ce0-a612-7ae0962a6973" alt=""><figcaption></figcaption></figure>
2. Assurez-vous de personnaliser le JSON ci-dessous pour modifier le `Ressource` de l’entrée `the-bucket-name-you-provisioned-earlier` au nom du bucket que vous avez créé en premier. **C’est présent à deux endroits, l’un sous la `bucketname` ressource et l’un sous la `bucketname/*` ressource**

```
{
	"Version": "2012-10-17",
	"Statement": [
		{
			"Effect": "Allow",
			"Action": [
				"s3:ListBucket",
				"s3:GetBucketLocation"
			],
			"Resource": "arn:aws:s3:::the-bucket-name-you-provisioned-earlier"
		},
		{
			"Effect": "Allow",
			"Action": [
				"s3:GetObject",
				"s3:PutObject",
				"s3:DeleteObject"
			],
			"Resource": "arn:aws:s3:::the-bucket-name-you-provisioned-earlier/*"
		}
	]
}
```

3. Utilisez l’éditeur JSON et collez ceci dans l’éditeur de stratégie
4. Nommez votre stratégie de façon pertinente pour l’accès au bucket Shade que nous avons créé plus tôt et ajoutez une description. Créez la stratégie

**Créer l’utilisateur**

1. Maintenant, sous `Utilisateurs` dans la barre latérale gauche d’IAM, cliquez sur `Créer un utilisateur`
2. Donnez à l’utilisateur un nom pertinent pour Shade. Ce sera l’utilisateur par lequel les serveurs Shade accéderont à votre bucket et signeront les URL.
3. Choisissez `Attacher des stratégies directement` et retrouvez la stratégie que vous avez créée. Cochez la case pour l’attacher puis cliquez sur suivant

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FRuj9ZkYDTY3ECZR8GLEk%2Fimage.png?alt=media&amp;token=dfa64253-4a6a-40fa-9951-5403053cbd3d" alt=""><figcaption></figcaption></figure>

4. Créer l’utilisateur
5. Maintenant, cliquez sur l’utilisateur puis sur `Créer une clé d’accès`

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FhcWU9ZUSgzxCd7BbAmKJ%2Fimage.png?alt=media&amp;token=b1f860f0-ec54-4de2-b5ec-a695996ad47a" alt=""><figcaption></figcaption></figure>

6. Sélectionnez `Application exécutée en dehors d’AWS`

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FkuUWTk7seBrTDBVIcB6s%2Fimage.png?alt=media&amp;token=5675b7ae-ed8a-4435-bf89-37461a9bc3df" alt=""><figcaption></figcaption></figure>

7. Enregistrez la clé d’accès et la clé secrète créées sur votre ordinateur

**Créer des drives dans Shade**

1. Dans l’application Shade, créez un drive BYOS

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FV0QizFJMF15OW53AI0bP%2Fimage.png?alt=media&amp;token=33a55b13-064d-4e53-be9f-f8959a8a844d" alt=""><figcaption></figcaption></figure>

2. Utilisez la `Personnalisée` configuration pour créer votre bucket
3. Renseignez la configuration avec les valeurs appropriées. Faites attention au point de terminaison. Utilisez le `s3.<region>.amazonaws.com` format précédé de `https://`. Vous trouverez ces points de terminaison en fonction de la région dans laquelle vous avez créé votre bucket sous `Points de terminaison Amazon S3` sur cette page : <https://docs.aws.amazon.com/general/latest/gr/s3.html>

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FAhQJ4Q5zd8dkAY6KFUCy%2Fimage.png?alt=media&amp;token=21846f1c-1011-4eab-8fd7-5526cb58cb35" alt=""><figcaption></figcaption></figure>

4. Importez un fichier pour tester. Vous devriez voir des objets apparaître dans votre bucket S3, le fichier devrait se téléverser et obtenir des aperçus/proxys normalement.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/shade-academy/shade-academy-fr/byos/connecting-shade-with-aws-s3.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
