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

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 Experience Manager, 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 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 Ativo de atualização do 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.

   

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 .

   

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

   

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 o Ignorar lista. Clique em OK para salvar as alterações.

   

10. Salve o workflow.

11. Para verificar o processamento correto, carregue uma imagem JPG para Assets. Após a conclusão do processamento, verifique se uma imagem invertida 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 ImageMagick, incluindo, entre outros, a imagem do PHP, o clipe de papel e o clipe de imagem 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 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.