DocumentaçãoAEM 6.4Guia do Assets

Instale e configure o ImageMagick para trabalhar com o Experience Manager Assets install-and-configure-imagemagick-to-work-with-aem-assets

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Admin
CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

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 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 dos formatos de arquivo de ativos. Para saber mais sobre todos os formatos de arquivo compatíveis, consulte Formatos compatíveis com os 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 correto de Experience Manager servidor. Alguns recursos úteis são fornecidos no final.

NOTE
Se estiver usando Experience Manager no Adobe Managed Services (AMS), entre em contato com o Suporte ao cliente do Adobe se você planeja processar muitos arquivos grandes do PSD ou PSB. O Experience Manager pode não processar arquivos PSB de resolução muito alta com mais de 30.000 x 23.000 pixels.

Instalar o ImageMagick installing-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 Arquivos de instalação do ImageMagick para seu sistema operacional.

  2. Para instalar o ImageMagick no disco que hospeda o 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 identify -version comando.

Configurar a etapa do processo da linha de comando set-up-the-command-line-process-step

Você pode configurar a etapa do processo da linha de comando para o caso de uso específico. Execute essas 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 Experience Manager servidor:

  1. No Experience Manager vá para o console Fluxo de trabalho (https://[aem_server]:[Port]/workflow) e abra o Ativo de atualização DAM modelo de fluxo de trabalho.

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

  3. No Guia Argumentos, adicionar image/jpeg para Tipos 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 na Web , especifique os detalhes da representação com dimensões de 1280x1280 pixels. Além disso, especifique magem/jpeg no Mimetype caixa.

    web_enabled_image

  7. Toque/clique OK para salvar as alterações.

    note note
    NOTE
    O convert pode não ser executado com determinadas versões do Windows (por exemplo, Windows SE), pois está em conflito com o comando 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 o Processar miniaturas e adicionar o tipo MIME image/jpeg under Ignorar Tipos Mime.

    skip_mime_types

  9. No Imagem ativada na Web , adicione o tipo MIME image/jpeg nos termos do Ignorar Lista. Toque/clique 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 para Assets. Verifique se uma imagem invertida e as representações são geradas para ela.

Reduzir as vulnerabilidades de segurança mitigating-security-vulnerabilities

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 o esperado "bytes mágicos" correspondendo 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 o ImageMagick é encontrada em /etc/ImageMagick.
Related Articles
recommendation-more-help
4452738f-2bdf-4cd4-9b45-905a69d607ad