DocumentaçãoAEM 6.5Guia do usuário

Instalar e configurar o ImageMagick para funcionar com Experience Manager Assets install-and-configure-imagemagick-to-work-with-aem-assets

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Administrador

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 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 de formatos de arquivo do Assets. Para saber mais sobre todos os formatos de arquivo compatíveis, consulte formatos compatíveis com o Assets.

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, compare apropriadamente o servidor Experience Manager. Alguns recursos úteis são fornecidos no final.

NOTE
Se você estiver usando o Experience Manager em Adobe Managed Services (AMS), entre em contato com o Suporte ao Cliente do Adobe se planejar processar muitos arquivos PSD ou PSB de alta resolução. 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 os arquivos de instalação do ImageMagick apropriados para o 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 ambiente path para o diretório de instalação do ImageMagic.

  4. Para verificar se a instalação teve êxito, execute o comando identify -version.

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

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

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

  3. Na guia Argumentos, adicione image/jpeg à lista Tipos MIME.

    mime_types_jpeg

  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.

    select_flags

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

    imagem_habilitada_para_Web

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

    note note
    NOTE
    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 convert nativo 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 a etapa Processar Miniaturas e adicione o tipo MIME image/jpeg em Ignorar Tipos MIME.

    skip_mime_types

  9. Na guia Imagem Habilitada para Web, adicione o tipo MIME image/jpeg na Lista de permissões. 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 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 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, 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 os "bytes mágicos" esperados, correspondentes aos tipos de arquivos de imagem aos quais você oferece suporte, 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 ImageMagick foi encontrada em /etc/ImageMagick.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2