Comprendere la condivisione delle risorse tra le origini (CORS)

Condivisione delle risorse tra diverse origini di Adobe Experience Manager (CORS) semplifica le proprietà web non AEM per effettuare chiamate lato client all'AEM, autenticate e non autenticate, per recuperare contenuto o interagire direttamente con l'AEM.

La configurazione OSGI descritta in questo documento è sufficiente per:

Se è richiesto l’accesso CORS a più origini nella pubblicazione AEM, consulta questa documentazione.

Adobe di configurazione OSGi dei criteri di condivisione delle risorse tra origini diverse di Granite

Le configurazioni CORS sono gestite come factory di configurazione OSGi in AEM, dove ogni criterio è rappresentato come un'istanza della factory.

Adobe Granite Cross-Origin Resource Sharing Policy (com.adobe.granite.cors.impl.CORSPolicyImpl)

Selezione criteri

Per selezionare un criterio, confronta il

Vengono utilizzati i primi criteri che corrispondono a questi valori. Se non viene trovata alcuna, qualsiasi CORS richiesta negata.

Se non è configurato alcun criterio, CORS alle richieste non verrà data risposta anche perché il gestore è disabilitato e quindi negato in modo effettivo, purché nessun altro modulo del server risponda a CORS.

Proprietà dei criteri

Origini consentite

Origini consentite (Regexp)

Percorsi consentiti

Intestazioni esposte

Età massima

Intestazioni supportate

Metodi consentiti

Credenziali supportate

Esempi di configurazioni

Il sito 1 è uno scenario di base, anonimamente accessibile e di sola lettura in cui il contenuto viene utilizzato tramite GET richieste:

{
  "supportscredentials":false,
  "exposedheaders":[
    ""
  ],
  "supportedmethods":[
    "GET",
    "HEAD"
  ],
  "alloworigin":[
    "http://127.0.0.1:3000",
    "https://site1.com"

  ],
  "maxage:Integer": 1800,
  "alloworiginregexp":[
    "http://localhost:.*"
    "https://.*\.site1\.com"
  ],
  "allowedpaths":[
    "/content/_cq_graphql/site1/endpoint.json",
    "/graphql/execute.json.*",
    "/content/site1/.*"
  ],
  "supportedheaders":[
    "Origin",
    "Accept",
    "X-Requested-With",
    "Content-Type",
    "Access-Control-Request-Method",
    "Access-Control-Request-Headers",
  ]
}

Il sito 2 è più complesso e richiede richieste autorizzate e mutanti (POST, PUT, DELETE):

{
  "supportscredentials":true,
  "exposedheaders":[
    ""
  ],
  "supportedmethods":[
    "GET",
    "HEAD"
    "POST",
    "DELETE",
    "PUT"
  ],
  "alloworigin":[
    "http://127.0.0.1:3000",
    "https://site2.com"

  ],
  "maxage:Integer": 1800,
  "alloworiginregexp":[
    "http://localhost:.*"
    "https://.*\.site2\.com"
  ],
  "allowedpaths":[
    "/content/site2/.*",
    "/libs/granite/csrf/token.json",
  ],
  "supportedheaders":[
    "Origin",
    "Accept",
    "X-Requested-With",
    "Content-Type",
    "Access-Control-Request-Method",
    "Access-Control-Request-Headers",
    "Authorization",
    "CSRF-Token"
  ]
}

Problemi e configurazione relativi al caching in Dispatcher dispatcher-caching-concerns-and-configuration

A partire dalla versione 4.1.1 di Dispatcher, le intestazioni di risposta possono essere memorizzate nella cache. Questo rende possibile memorizzare in cache CORS intestazioni lungo l'asse CORS-ha richiesto risorse, purché la richiesta sia anonima.

In generale, le stesse considerazioni per il caching dei contenuti in Dispatcher possono essere applicate al caching delle intestazioni di risposta CORS in Dispatcher. La tabella seguente definisce quando CORS intestazioni (e quindi CORS richieste) possono essere memorizzate nella cache.

Consentire le intestazioni di richiesta CORS

Per consentire il necessario Intestazioni di richiesta HTTP da passare all’AEM per l’elaborazione, devono essere consentiti nel /clientheaders configurazione.

/clientheaders {
   ...
   "Origin"
   "Access-Control-Request-Method"
   "Access-Control-Request-Headers"
}

Memorizzazione nella cache delle intestazioni di risposta CORS

Per consentire la memorizzazione in cache e il serving delle intestazioni CORS sul contenuto memorizzato in cache, aggiungi quanto segue /cache /headers, configurazione alla pubblicazione AEM dispatcher.any file.

/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"
        }
    ...
    }
...
}

Ricorda a riavviare l'applicazione server Web dopo aver apportato modifiche al dispatcher.any file.

È probabile che la cancellazione completa della cache sia necessaria per garantire che le intestazioni siano memorizzate nella cache in modo appropriato alla successiva richiesta dopo un /cache/headers aggiornamento della configurazione.

Risoluzione dei problemi CORS

La registrazione è disponibile in com.adobe.granite.cors:

Suggerimenti:

Materiali di supporto