DocumentaçãoAEM 6.5Guia do usuário

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

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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.

NOTE
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 Manager O não pode 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 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 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 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.

    note note
    NOTE
    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 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 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.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2