Développer pour le partage de ressources entre origines multiples (CORS)
Court exemple d’utilisation de CORS pour accéder au contenu d’AEM à partir d’une application web externe via du code JavaScript côté client. Cet exemple utilise la configuration OSGi CORS pour activer l’accès à CORS sur AEM. L’approche de configuration OSGi est viable dans les cas suivants :
- Une origine unique accède au contenu de l’instance de publication AEM
- L’accès CORS est requis pour l’instance de création AEM.
Si un accès de plusieurs origines à l’instance de publication AEM est requis, reportez-vous à cette documentation.
Dans cette vidéo :
- www.example.com mappe à localhost via
/etc/hosts
. - aem-publish.local mappe à localhost via
/etc/hosts
. - SimpleHTTPServer (wrapper du module Python SimpleHTTPServer) diffuse la page du HTML via le port 8000.
- N’est plus disponible dans l’App Store Mac. Utilisez une solution similaire, telle que Jeeves.
- Le AEM Dispatcher s’exécute sur Apache HTTP Web Server 2.4 et renvoie les requêtes de proxy de
aem-publish.local
verslocalhost:4503
.
Pour plus d’informations, voir Présentation du partage de ressources entre origines multiples (CORS) dans AEM.
www.example.com - HTML et JavaScript
Cette page web a une logique :
- En cliquant sur le bouton,
- elle transforme une requête AJAX GET en
http://aem-publish.local/content/we-retail/.../experience/_jcr_content.1.json
, - elle récupère le
jcr:title
de la réponse JSON, - et elle injecte le
jcr:title
dans le DOM.
<html>
<head>
<script
src="https://code.jquery.com/jquery-3.2.1.min.js"
integrity="sha256-hwg4gsxgFZhOsEEamdOYGBf13FyQuiTwlAQgxVSNgt4="
crossorigin="anonymous"></script>
</head>
<body style="width: 960px; margin: 2rem auto; font-size: 2rem;">
<button style="font-size: 2rem;"
data="fn-getTitle">Get Title as JSON from AEM</button>
<pre id="title">The page title AJAX'd in from AEM will injected here</pre>
<script>
$(function() {
/** Get Title as JSON **/
$('body').on('click', '[data="fn-getTitle"]', function(e) {
$.get('http://aem-publish.local/content/we-retail/us/en/experience/_jcr_content.1.json', function(data) {
$('#title').text(data['jcr:title']);
},'json');
e.preventDefault();
return false;
});
});
</script>
</body>
</html>
Configuration d’usine OSGi
La configuration d’usine OSGi pour Cross-Origin Resource Sharing est disponible via :
http://<host>:<port>/system/console/configMgr > Adobe Granite Cross-Origin Resource Sharing Policy
<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0"
jcr:primaryType="sling:OsgiConfig"
alloworigin="[https://www.example.com:8000]"
alloworiginregexp="[]"
allowedpaths="[/content/we-retail/.*]"
exposedheaders="[]"
maxage="{Long}1800"
supportedheaders="[Origin,Accept,X-Requested-With,Content-Type,
Access-Control-Request-Method,Access-Control-Request-Headers]"
supportedmethods="[GET]"
supportscredentials="{Boolean}false"
/>
Configuration du Dispatcher dispatcher-configuration
Autoriser les en-têtes de requête CORS
Pour autoriser les en-têtes de requête HTTP à être transmis à AEM pour traitement, ils doivent être autorisés dans la configuration /clientheaders
de Dispatcher.
/clientheaders {
...
"Origin"
"Access-Control-Request-Method"
"Access-Control-Request-Headers"
}
Mettre en cache des en-têtes de réponse CORS
Pour permettre la mise en cache et la diffusion des en-têtes CORS sur le contenu mis en cache, ajoutez la configuration /cache /headers suivante au fichier dispatcher.any
de l’instance de publication AEM.
/publishfarm {
...
/cache {
...
# CORS HTTP response headers
# https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#the_http_response_headers
/headers {
...
"Access-Control-Allow-Origin"
"Access-Control-Expose-Headers"
"Access-Control-Max-Age"
"Access-Control-Allow-Credentials"
"Access-Control-Allow-Methods"
"Access-Control-Allow-Headers"
}
...
}
...
}
Redémarrez l’application de serveur web après avoir apporté des modifications au fichier dispatcher.any
.
Il est probable que l’effacement complet du cache soit nécessaire pour que les en-têtes soient correctement mis en cache dans la requête suivante après une mise à jour de la configuration /cache /headers
.