Protección del contenido en AEM sin encabezado

Última actualización: 5 de mayo de 2025
  • Se aplica a:
  • Experience Manager as a Cloud Service
  • Temas:

Creado para:

  • Intermedio
  • Desarrollador

Garantizar la integridad y seguridad de los datos al servir contenido sin encabezado de AEM desde AEM Publish es crucial al servir contenido confidencial. Este procedimiento le guiará para proteger el contenido servido por los extremos de la API de GraphQL sin encabezado de AEM.

Las directrices de este tutorial indican requisitos estrictos para que el contenido esté disponible exclusivamente para usuarios o grupos de usuarios específicos. Es imperativo distinguir entre contenido de marketing personalizado y contenido privado, como PII o datos financieros personales, para evitar confusiones y resultados no deseados. Este tutorial aborda la protección del contenido privado.

Al hablar del contenido de marketing, nos referimos a contenido adaptado a usuarios o grupos individuales, que no está pensado para el consumo general. Sin embargo, es esencial comprender que, aunque este contenido puede estar dirigido a determinados usuarios, su exposición fuera del contexto deseado (por ejemplo, mediante la manipulación de solicitudes HTTP) no supone un riesgo de seguridad, legal o de reputación.

Se enfatiza que todo el contenido abordado en este artículo se asume como privado, y solo puede ser visto por usuarios o grupos designados. El contenido de marketing a menudo no requiere protección, sino que su entrega a usuarios específicos puede ser administrado por la aplicación y almacenado en caché para obtener rendimiento.

Este procedimiento no cubre lo siguiente:

  • Proteger los puntos de conexión directamente, pero en su lugar se centra en proteger el contenido que entregan.
  • Autenticación para AEM Publish u obtención de tokens de inicio de sesión. Los métodos de autenticación y la aprobación de credenciales dependen de los casos de uso y las implementaciones individuales.

Grupos de usuarios

En primer lugar, debemos definir un grupo de usuarios que contenga los usuarios que deben tener acceso al contenido protegido.

Grupo de usuarios de contenido protegido de AEM sin encabezado

Los grupos de usuarios asignan acceso al contenido sin encabezado de AEM, incluidos los fragmentos de contenido u otros recursos a los que se hace referencia.

  1. Inicie sesión en AEM Author como administrador de usuarios.
  2. Vaya a Herramientas > Seguridad > Grupos.
  3. Seleccione Crear en la esquina superior derecha.
  4. En la ficha Detalles, especifique el Id. de grupo y el Nombre de grupo.
    • El identificador de grupo y el nombre de grupo pueden ser cualquier cosa, pero en este ejemplo se usa el nombre usuarios de API sin encabezado de AEM.
  5. Seleccione Guardar y cerrar.
  6. Seleccione el grupo recién creado y, a continuación, elija Activar en la barra de acciones.

Si se requieren varios niveles de acceso, cree varios grupos de usuarios que se puedan asociar con contenido diferente.

Adición de usuarios a grupos de usuarios

Para conceder acceso a las solicitudes de API de GraphQL sin encabezado de AEM al contenido protegido, puede asociar la solicitud sin encabezado a un usuario que pertenezca a un grupo de usuarios específico. Estos son dos enfoques comunes:

  1. Cuentas técnicas de AEM as a Cloud Service:

    • Cree una cuenta técnica en AEM as a Cloud Service Developer Console.
    • Inicie sesión en AEM Author una vez con la cuenta técnica de.
    • Agregue la cuenta técnica al grupo de usuarios mediante Herramientas > Seguridad > Grupos > Usuarios de API sin encabezado de AEM > Miembros.
    • Activar tanto el usuario de la cuenta técnica como el grupo de usuarios en AEM Publish.
    • Este método requiere que el cliente sin encabezado no exponga las credenciales de servicio al usuario, ya que son credenciales para un usuario específico y no se deben compartir.

    Administración del grupo de cuentas técnicas de AEM

  2. Usuarios con nombre:

    • Autentique usuarios con nombre y agréguelos directamente al grupo de usuarios en AEM Publish.
    • Este método requiere que el cliente sin encabezado autentique las credenciales de usuario con AEM Publish, obtenga un inicio de sesión o un token de acceso de AEM y utilice este token para las solicitudes posteriores a AEM. Los detalles de cómo conseguirlo no se tratan en este procedimiento y dependen de la implementación de.

Protección de fragmentos de contenido

La protección de los fragmentos de contenido es esencial para proteger el contenido sin encabezado de AEM y se logra asociando el contenido con un grupo de usuarios cerrado (CUG). Cuando un usuario realiza una solicitud a la API de GraphQL sin encabezado de AEM, el contenido devuelto se filtra en función de los CUG del usuario.

CUG sin encabezado de AEM

Siga estos pasos para lograr esto a través de Grupos de usuarios cerrados (CUG).

  1. Inicie sesión en AEM Author como usuario de DAM.
  2. Vaya a Assets > Archivos y seleccione la carpeta que contiene los fragmentos de contenido que desea proteger. Los CUG se aplican jerárquicamente y afectan a las subcarpetas a menos que un CUG diferente los sustituya.
    • Asegúrese de que los usuarios que pertenecen a otros canales que utilizan el contenido de las carpetas están incluidos en este grupo de usuarios. También puede incluir los grupos de usuarios asociados a esos canales en la lista de CUG. Si no es así, esos canales no podrán acceder al contenido.
  3. Seleccione la carpeta y elija Propiedades en la barra de herramientas.
  4. Seleccione la ficha Permisos.
  5. Escriba el Nombre de grupo y seleccione el botón Agregar para agregar el nuevo CUG.
  6. Guardar para aplicar el CUG.
  7. Seleccione la carpeta de recursos y seleccione Publicar para enviar la carpeta con los CUG aplicados a AEM Publish, donde se evaluará como un permiso.

Realice estos mismos pasos para todas las carpetas que contienen fragmentos de contenido que deben protegerse, aplicando los CUG correctos a cada carpeta.

Ahora, cuando se realiza una solicitud HTTP al extremo de la API de GraphQL sin encabezado de AEM, solo se incluyen en el resultado los fragmentos de contenido accesibles mediante los CUG especificados por el usuario solicitante. Si el usuario no tiene acceso a ningún fragmento de contenido, el resultado estará vacío, aunque devolverá un código de estado HTTP 200.