Configuración de Akamai

Las siguientes capturas de pantalla ilustran cómo usar el Administrador de propiedades de Akamai para configurar una propiedad a fin de que envíe contenido desde AEM mediante la configuración de CDN de Akamai. La configuración esencial está marcada con un círculo rojo.

​# Configuración de propiedades esenciales

Servidor de origen

Propiedades de configuración:

Nombre
Value
Comentar
Servidor de origen: nombre
main--<repo>--<organization>.aem.live
Reemplazar repositorio y organización por los valores del sitio.
Encabezado de host de reenvío
Nombre de host de origen
Nombre de host de clave de caché
Encabezado de host entrante
Enviar encabezado IP de cliente verdadero
No

Añadir comportamiento: eliminar el encabezado de variable

Propiedades de configuración:

Nombre
Value
Comentar
Quitar encabezado de variable
Activado

Añadir comportamiento: modificar encabezado de solicitud saliente

Necesitaremos una serie de encabezados de solicitud salientes, consulte la siguiente tabla. Mantenga la configuración "evitar encabezados duplicados" habilitada para todos.

Propiedades de configuración:

Acción
Seleccionar nombre de encabezado
Nombre de encabezado personalizado
Nuevo valor de encabezado
Modificar
Otro
X-Forwarded-Host
{{builtin.AK_HOST}}
Modificar
Otro
X-BYO-CDN-Type
akamai
Modify
Other
X-Push-Invalidation
enabled

Añadir/Modificar Comportamiento: Almacenamiento En Caché

Propiedades de configuración:

Nombre
Value
Opción de almacenamiento en caché
Respetar origen Cache-Control
Compatibilidad con RFC mejorada
No
Honor privado
No
El honor debe revalidarse
No

Añadir comportamiento: HTTP/2

(Opcional, pero recomendada)

Agregar regla: Modificar encabezado de respuesta saliente

En la lista de reglas de la barra lateral, haga clic en el botón "+ Reglas"

Seleccione "Plantilla de regla en blanco", defina un nombre como "Anular encabezados condicionalmente" y haga clic en "Insertar regla".

Para definir los criterios para la regla que se va a aplicar, haga clic en "+ Coincidencia"

Luego seleccione:

  • Si
  • Ruta
  • No coincide con uno de
  • *.plain.html

Haga clic en "+ Comportamiento" y "Comportamiento de propiedad estándar" para establecer el comportamiento si se encuentra una coincidencia

A continuación, seleccione Modificar encabezado de respuesta saliente

Con los siguientes valores:

  • Acción: eliminar
  • Seleccione el nombre del encabezado: Otro
  • Nombre de encabezado personalizado: X-Robots-Tag

Todos estos son ajustes de propiedad esenciales para enviar contenido.

Opcional: Autenticar solicitudes de origen

Cuando use autenticación de sitio basada en token, agregue lo siguiente en "Agregar comportamiento: encabezados de solicitud salientes"

Propiedades de configuración:

Nombre
Value
Comentar
Acción
Modificar
Nombre de encabezado personalizado
Autorización
New Header Value
token <YOUR_TOKEN_HERE>
Reemplazar por el valor de token de sitio recibido en autenticación de sitio basada en token
Evitar encabezados duplicados

Esta configuración garantiza que Akamai autentique las solicitudes de su CDN al origen de AEM, lo que valida el token recibido en el encabezado Authorization.

Advertencias

No habilitar Supervisión del uso real de Akamai mPulse. Si bien el impacto en el rendimiento de la mayoría de los sitios es insignificante, para los sitios construidos para un alto rendimiento consistente, habilitarlo impedirá alcanzar una puntuación de Lighthouse de 100. En AEM, tiene integrado un servicio de supervisión de uso real, por lo que la instrumentación dual será innecesaria y se desaconseja.

Además, no habilita Akamai Bot Manager Premier (también denominado "Protección de extremo transaccional") ni otras ofertas similares de Firewall de aplicaciones web, ya que interfieren notablemente con el rendimiento de procesamiento y la experiencia del usuario. Su sitio en AEM está protegido contra ataques de bots en el backend de, por lo que este coste de rendimiento aporta un beneficio insignificante.

Configuración de la invalidación push para Akamai

La invalidación push purga automáticamente el contenido en la CDN de producción del cliente (p. ej. www.yourdomain.com), cada vez que un autor publica cambios de contenido.

El contenido se purga mediante la dirección URL y la clave/etiqueta de caché.

La invalidación push se habilita agregando propiedades específicas a la configuración del proyecto (un libro de Excel denominado .helix/config.xlsx en Sharepoint o una hoja de Google denominada .helix/config en Google Drive).

Propiedades de configuración:

key
valor
comentario
cdn.prod.host
<Production Host>
Nombre del host del sitio de producción, p. ej.,. www.yourdomain.com
cdn.prod.type
akamai
cdn.prod.endpoint
<host>
Credenciales de API de purga rápida
cdn.prod.clientSecret
<client_secret>
Credenciales de API de purga rápida
cdn.prod.clientToken
<client_token>
Credenciales de API de purga rápida
cdn.prod.accessToken
<access_token>
Credenciales de API de purga rápida

La invalidación por inserción de AEM usa la API de purga rápida de Akamai, específicamente Eliminar por dirección URL y Eliminar por etiqueta de caché.

Las credenciales de la API de purga rápida constan de

host = akaa-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.luna.akamaiapis.net
client_token = akab-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX
client_secret = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
access_token = akab-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX

Se pueden generar siguiendo las instrucciones en Crear un cliente de API con permisos personalizados.

Vaya a Administración de identidad y acceso:

Crear cliente de API:



Permisos de grupo/función requeridos:

Puede validar las credenciales con esta herramienta.

Mención especial: encabezados de control de Edge de Akamai

AEM utiliza una forma optimizada y basada en la producción para proporcionar información de almacenamiento en caché que se aplica a la CDN específica, junto con nuestra invalidación push fiable. Esto nos permite mejorar la eficiencia y la coherencia de la caché con respecto a los enfoques tradicionales basados en TTL.

Todos los proveedores de CDN admiten una forma de influir directamente en la forma de instruir el almacenamiento en caché. Nos complace ver que los esfuerzos de estandarización como "Control de caché dirigido" (TCC) están en la hoja de ruta para Akamai (consulte: https://www.akamai.com/blog/news/targeted-cache-control). Mientras tanto, estamos utilizando el encabezado Edge-Control compatible a largo plazo de Akamai.

recommendation-more-help
10a6ce9d-c5c5-48d9-8ce1-9797d2f0f3ec