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. Changez simplement la valeur d'entrée 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, pas de paramètres avancés)

Configuration CORS

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

2. Cliquez sur modifier, puis collez ce JSON.

[
    {
        "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
    }
]

Ce JSON sert à autoriser les navigateurs web à accéder à ce bucket. C'est sécurisé car, comme nous fournissons des redirections depuis notre serveur, nous conservons le périmètre spécifique des autorisations CORS, donc cette configuration peut rester générique.

Créer la politique ciblée

1. Sous IAM cliquez sur Policies puis cliquez sur Create policy

   1. La plupart des erreurs que nous voyons se produisent ici, lorsque les politiques ne sont pas correctement personnalisées

   
2. Assurez-vous de personnaliser le fichier JSON ci-dessous pour modifier la Resource entrée de the-bucket-name-you-provisioned-earlier pour le nom du bucket que vous avez créé en premier. Cela se trouve à deux endroits : l'un sous la bucketname ressource du bucket et l'autre 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/*"
		}
	]
}

1. Utilisez l'éditeur JSON et collez ceci dans l'éditeur de politique
2. Nommez votre politique de manière pertinente pour l'accès au bucket Shade que nous avons créé précédemment et ajoutez une description. Créez la politique

Créer l'utilisateur

1. Maintenant, sous Users dans la barre latérale gauche d'IAM, cliquez sur Create user
2. Donnez à l'utilisateur un nom pertinent pour Shade. Ce sera l'utilisateur par lequel les serveurs Shade accéderont à votre bucket et généreront des URL signées.
3. Choisissez Attach policies directly et trouvez la politique que vous avez créée. Cochez la case pour l'attacher, puis cliquez sur suivant

1. Créer l'utilisateur
2. Maintenant, cliquez sur l'utilisateur puis sur Create access key

1. Sélectionnez Application running outside AWS

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

Créer des drives dans Shade

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

1. Utilisez la Custom configuration pour créer votre bucket
2. Renseignez la configuration avec les bonnes valeurs. Faites attention à l'endpoint. Utilisez le s3.<region>.amazonaws.com format précédé de https://. Trouvez ces endpoints en fonction de la région dans laquelle vous avez créé votre bucket, sous Amazon S3 endpoints sur cette page : https://docs.aws.amazon.com/general/latest/gr/s3.html

1. Téléversez 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.