Show Menu
TÓPICOS×

Instalar e configurar o ImageMagick para trabalhar com os ativos AEM

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 de Ativos. Para saber mais sobre todos os formatos de arquivo suportados, consulte Formatos compatíveis com o Assets.
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.
Se você estiver usando o AEM no Adobe Managed Services (AMS), entre em contato com o Atendimento ao cliente da Adobe se você planeja processar muitos arquivos grandes PSD ou PSB. O Experience Manager talvez não processe arquivos PSB de alta resolução com mais de 30000 x 23000 pixels.

Instalar 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 apropriados do ImageMagick 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 identify -version comando.

Configurar 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) cada vez que você adicionar um arquivo de imagem JPEG /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 Atualizar ativo do DAM.
  2. No modelo de fluxo de trabalho Atualizar ativo do DAM, abra a etapa de miniaturas EPS (acionada pelo 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 execução com dimensões de 1280x1280 pixels. Além disso, especifique image/jpeg na caixa Mimetype .
  7. Tap/click OK to save the changes.
    O convert convert comando pode não ser executado com determinadas versões do Windows (por exemplo, Windows SE), pois está em conflito com o utilitário nativo 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 a Lista Ignorar . Tap/click OK to save the changes.
  10. Salve o fluxo de trabalho.
  11. Para verificar se o ImageMagic consegue processar imagens corretamente, carregue uma imagem JPG para os ativos AEM. 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, a 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 encontra-se em /etc/ImageMagick .