Configuration du partage des ressources entre origines multiples (CORS)
Le partage des ressources cross-origin (CORS) définit un moyen pour les applications Web clientes chargées dans un domaine particulier d'interagir avec les ressources d'un autre domaine. Le CORS vous permet de créer de riches applications web côté client avec Amazon S3 et d'autoriser de manière sélective un accès cross-origin à vos ressources Amazon S3.
Cette section explique comment activer le CORS à l’aide de la console Amazon S3, de l’API REST Amazon S3 et des kits AWS SDK. Pour configurer le compartiment afin d’autoriser les demandes entre origines multiples, vous devez ajouter une configuration CORS au compartiment. Une configuration CORS est un document qui définit les règles identifiant les origines auxquelles vous autorisez l’accès au compartiment, les opérations (méthodes HTTP) prises en charge pour chaque origine, et d’autres informations propres aux opérations. Dans la console S3, la configuration CORS doit être un document JSON.
Pour obtenir un exemple de configurations CORS en JSON et XML, consultez Éléments d’une configuration CORS.
Cette section explique comment utiliser la console Amazon S3 pour ajouter une configuration CORS (partage des ressources cross-origin) à un compartiment S3.
Lorsque vous activez CORS sur le compartiment, les listes de contrôle d’accès (ACL) et les autres stratégies d’autorisation d’accès continuent à s’appliquer.
Important
Dans la console S3, la configuration CORS doit être de type JSON. Pour obtenir des exemples de configurations CORS en JSON et XML, consultez Éléments d’une configuration CORS.
Pour ajouter une configuration CORS à un compartiment S3
Connectez-vous à la AWS Management Console et ouvrez la console Amazon S3 à l’adresse https://console.aws.amazon.com/s3/
. -
Dans le volet de navigation de gauche, choisissez Compartiments à usage général.
-
Dans la liste de compartiments, choisissez le nom du compartiment pour lequel vous souhaitez créer une stratégie de compartiment.
-
Choisissez Permissions.
-
Dans la section Partage des ressources cross-origin (CORS), choisissez Modifier.
-
Dans la zone de texte Editeur de configuration CORS, tapez ou copiez et collez une nouvelle configuration CORS, ou modifiez une configuration existante.
La configuration CORS est un fichier JSON. Le texte que vous saisissez dans l’éditeur doit être dans un format JSON valide. Pour plus d’informations, consultez Éléments d’une configuration CORS.
-
Sélectionnez Save Changes.
Note
Amazon S3 affiche l’Amazon Resource Name (ARN) du compartiment en regard du titre Editeur de configuration CORS. Pour plus d’informations sur les ARN, consultez Amazon Resource Name (ARN) et espaces de noms du service AWS dans le Référence générale d'Amazon Web Services.
Vous pouvez utiliser le kit SDK AWS pour gérer le partage des ressources cross-origin (CORS) pour un compartiment. Pour plus d'informations sur le CORS, consultez Utilisation du partage des ressources entre origines multiples (CORS).
Les exemples suivants :
-
Crée une configuration CORS et définit la configuration sur un compartiment
-
Récupère une configuration et la modifie en ajoutant une règle
-
Ajoute la configuration modifiée au compartiment
-
Supprime la configuration
Pour définir une configuration CORS sur votre compartiment, vous pouvez utiliser AWS Management Console. Si l’application l’exige, vous pouvez également envoyer directement des demandes REST. Les sections suivantes de la Référence d’API Amazon Simple Storage Service décrivent les actions de l’API REST liées à la configuration CORS :