Instale e configure o ImageMagick para trabalhar com o AEM Assets

ImageMagick é um plug-in de software para criar, editar, compor ou converter imagens de bitmap. Ele pode ler e gravar imagens em vários formatos (mais de 200), incluindo PNG, JPEG, JPEG-2000, GIF, TIFF, DPX, EXR, WebP, Postscript, PDF e SVG. Use o ImageMagick para redimensionar, virar, espelhar, girar, distorcer, distorcer e transformar imagens. Você também pode ajustar as cores da imagem, aplicar vários efeitos especiais ou desenhar texto, linhas, polígonos, elipses e curvas usando o ImageMagick.

Use o manipulador de mídia do Adobe Experience Manager (AEM) na linha de comando para processar imagens por meio do ImageMagick. Para trabalhar com vários formatos de arquivo usando o ImageMagick, consulte Práticas recomendadas para formatos de arquivo do Assets. Para saber mais sobre todos os formatos de arquivo suportados, consulte Formatos suportados pelos ativos.

Para processar arquivos grandes usando o ImageMagick, considere requisitos de memória mais altos do que o normal, possíveis alterações necessárias às políticas de IM e o impacto geral no desempenho. Os requisitos de memória dependem de vários fatores, como resolução, profundidade de bits, perfil de cores e formato de arquivo. Se você pretende processar arquivos muito grandes usando o ImageMagick, faça o benchmark adequado do servidor AEM. Alguns recursos úteis são fornecidos no final.

OBSERVAÇÃO

Se você estiver usando AEM no Adobe Managed Services (AMS), entre em contato com o Atendimento ao cliente da Adobe se planeja processar vários arquivos PSD ou PSB grandes. O Experience Manager pode não processar arquivos PSB de alta resolução que tenham mais de 30000 x 23000 pixels.

Instale o ImageMagick

Várias versões dos arquivos de instalação do ImageMagic estão disponíveis para vários sistemas operacionais. Use a versão apropriada para seu sistema operacional.

  1. Baixe os arquivos de instalação do ImageMagick apropriados para seu sistema operacional.

  2. Para instalar o ImageMagick no disco que hospeda o servidor AEM, inicie o arquivo de instalação.

  3. Defina a variável path Ambiente para o diretório de instalação ImageMagic.

  4. Para verificar se a instalação foi bem-sucedida, execute o comando identify -version.

Configure a etapa do processo da linha de comando

Você pode configurar a etapa do processo da linha de comando para seu caso de uso específico. Execute estas etapas para gerar uma imagem invertida e miniaturas (140x100, 48x48, 319x319 e 1280x1280) sempre que adicionar um arquivo de imagem JPEG a /content/dam no servidor AEM:

  1. No servidor AEM, vá para o console Fluxo de trabalho (https://[aem_server]:[Port]/workflow) e abra o modelo de fluxo de trabalho DAM Update Asset.

  2. No modelo de fluxo de trabalho DAM Update Asset, abra as miniaturas EPS (fornecidas por ImageMagick).

  3. Na guia Argumentos, adicione image/jpeg à lista Mime Types.

    mime_types_jpeg

  4. Na caixa Comandos, digite o seguinte comando:

    convert ./${filename} -flip ./${basename}.flipped.jpg

  5. Selecione os sinalizadores Excluir representação gerada e Gerar representação da Web.

    select_flags

  6. Na guia Imagem ativada pela Web, especifique os detalhes para a representação com dimensões de 1280x1280 pixels. Além disso, especifique i mage/jpeg na caixa Mimetype.

    web_enabled_image

  7. Toque/clique em OK para salvar as alterações.

    OBSERVAÇÃO

    O comando convert pode não ser executado com determinadas versões do Windows (por exemplo, Windows SE), porque está em conflito com o utilitário nativo convert que faz parte da instalação do Windows. Nesse caso, mencione o caminho completo do utilitário ImageMagick. Por exemplo, especifique,

    "C:\Program Files\ImageMagick-6.8.9-Q16\convert.exe" -define jpeg:size=319x319 ./${filename} -thumbnail 319x319 cq5dam.thumbnail.319.319.png

  8. Abra a etapa Processar miniaturas e adicione o tipo MIME image/jpeg em Ignorar tipos MIME.

    skip_mime_types

  9. Na guia Imagem ativada pela Web, adicione o tipo MIME image/jpeg sob Ignorar Lista. Toque/clique em OK para salvar as alterações.

    web_enabled

  10. Salve o fluxo de trabalho.

  11. Para verificar se o ImageMagic consegue processar imagens corretamente, carregue uma imagem JPG para o AEM Assets. Verifique se uma imagem invertida e as execuções são geradas para ela.

Reduzir as vulnerabilidades de segurança

Há várias vulnerabilidades de segurança associadas ao uso do ImageMagick para processar imagens. Por exemplo, o processamento de imagens enviadas pelo usuário envolve o risco de execução remota de código (RCE).

Além disso, vários plug-ins de processamento de imagens dependem da biblioteca do ImageMagick, incluindo, mas não limitado às imagens do PHP, o rmagick e o clipe de papel de Ruby e a imagem do Node.js.

Se você usar o ImageMagick ou uma biblioteca afetada, o Adobe recomenda atenuar as vulnerabilidades conhecidas, executando pelo menos uma das seguintes tarefas (mas, de preferência, ambas):

  1. Verifique se todos os arquivos de imagem começam com os "bytes mágicos" esperados correspondentes aos tipos de arquivos de imagem suportados antes de enviá-los para o ImageMagick para processamento.
  2. Use um arquivo de política para desativar os codificadores vulneráveis do ImageMagick. A política global para ImageMagick foi encontrada em /etc/ImageMagick.

Nesta página