Instale e configure o ImageMagick para trabalhar com Experience Manager 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 Adobe Experience Manager 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 Experience Manager. Alguns recursos úteis são fornecidos no final.

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 Experience Manager, 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 Experience Manager:

1. No servidor Experience Manager, 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.

   

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.

   

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

   

7. 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.

   

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

   

10. Salve o fluxo de trabalho.

11. Para verificar o processamento correto, carregue uma imagem JPG para Assets. Após a conclusão do processamento, verifique se uma imagem virada e as representações são geradas ou não.

Reduzindo 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 o imagemagick do nodejs.

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.