Instalar e configurar o ImageMagick para funcionar com ele Experience Manager Assets

Última atualização em 2023-11-07
  • Criado para:
  • Admin

ImageMagick é um plug-in de software para criar, editar, compor ou converter imagens 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 cores da imagem, aplicar vários efeitos especiais ou desenhar texto, linhas, polígonos, elipses e curvas usando o ImageMagick.

Use o Adobe Experience Manager manipulador de mídia da 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 de ativos compatíveis.

Para processar arquivos grandes usando o ImageMagick, considere os requisitos de memória mais altos que o normal, as possíveis alterações necessárias às políticas de mensagens instantâneas 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 Experience Manager servidor. Alguns recursos úteis são fornecidos no final.

OBSERVAÇÃO

Se você estiver usando Experience Manager em Adobe Managed Services (AMS), entre em contato com o Suporte ao cliente do Adobe se você planejar processar muitos arquivos PSD ou PSB de alta resolução. Experience ManagerO pode não processar arquivos PSB de resolução muito alta com mais de 30.000 x 23.000 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 o apropriado Arquivos de instalação do ImageMagick para o seu sistema operacional.

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

  3. Defina a variável de ambiente path para o diretório de instalação do 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 de 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 de JPEG a /content/dam no Experience Manager servidor:

  1. No Experience Manager , acesse o console Fluxo de trabalho (https://[aem_server]:[port]/workflow) e abra a guia Ativo de atualização DAM modelo de fluxo de trabalho.

  2. No Ativo de atualização DAM modelo de fluxo de trabalho, abra a variável Miniaturas do EPS (ativado por ImageMagick) etapa.

  3. No Guia Argumentos, adicionar image/jpeg para o Tipos de Mime lista.

    mime_types_jpeg

  4. No Comandos digite o seguinte comando:

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

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

    select_flags

  6. No Imagem ativada pela Web especifique os detalhes da representação com dimensões de 1280x1280 pixels. Além disso, especifique image/jpeg no Mimetype caixa.

    web_enabled_image

  7. Clique em OK para salvar as alterações.

    OBSERVAÇÃO

    A variável convert pode não ser executado com determinadas versões do Windows (por exemplo, Windows SE), porque está em conflito com o convert que faz parte da instalação do Windows. Nesse caso, mencione o caminho completo para o 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 o Miniaturas do processo etapa e adicionar o tipo MIME image/jpeg em Ignorar tipos MIME.

    skip_mime_types

  9. No Imagem ativada pela Web , adicionar o tipo MIME image/jpeg no Ignorar lista. Clique em OK para salvar as alterações.

    web_enabled

  10. Salve o workflow.

  11. Para verificar o processamento correto, carregue uma imagem de JPG no 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, mas não limitado a, a imagem do PHP, o Magick e o Clipe de Papel do Ruby e o Imagemagick do Nodejs.

Se você usa o ImageMagick ou uma biblioteca afetada, o Adobe recomenda que você reduza as vulnerabilidades conhecidas executando pelo menos uma das seguintes tarefas (mas preferencialmente ambas):

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

Nesta página