Instale e configure o ImageMagick para funcionar com o AEM Assets

O 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 das imagens, 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 pelo ImageMagick. Para trabalhar com vários formatos de arquivo usando o ImageMagick, consulte Práticas recomendadas para formatos de arquivo de ativos. Para saber mais sobre todos os formatos de arquivo compatíveis, consulte Formatos compatíveis com 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 cor e formato de arquivo. Se você pretende processar arquivos muito grandes usando o ImageMagick, faça o benchmark adequado do servidor de 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 do Adobe caso planeje processar muitos arquivos grandes de PSD ou PSB. O Experience Manager pode não processar arquivos PSB de alta resolução com mais de 30000 x 23000 pixels.

Instalar 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 de AEM, inicie o arquivo de instalação.

  3. Defina a variável de caminho Ambiente para o diretório de instalação do 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 o 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 de 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 Ativo de atualização DAM.

  2. No modelo de fluxo de trabalho Ativo de atualização do DAM, abra a etapa Miniaturas do EPS (alimentado pelo ImageMagick).

  3. Na guia Argumentos, adicione image/jpeg à lista Tipos MIME.

    mime_types_jpeg

  4. Na caixa Commands, 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 o Ignorar lista. Toque/clique em OK para salvar as alterações.

    web_enabled

  10. Salve o workflow.

  11. Para verificar se o ImageMagic é capaz de processar as imagens corretamente, carregue uma imagem JPG no AEM Assets. Verifique se uma imagem invertida e as representaçõ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 ImageMagick, incluindo, entre outros, a imagem do PHP, o magnífico 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 arquivo de imagem que você suporta 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 é encontrada em /etc/ImageMagick.

Nesta página