概要¶

何かとやりとりする機会が多いPDF。これをチケット上でサムネイル表示させるプラグインをインストールします。

注意事項¶

本項で実施する作業は、ImageMagicの脆弱性対応の制限を外すものです。作業の際はセキュリティポリシーに鑑みてください。

プラグイン名¶

• Redmine_Preview_PDF
  • https://github.com/nanego/redmine_preview_pdf

動作を確認した環境¶

Redmine 4.2

導入時¶

追加パッケージのインストール：要
設定ファイルの修正：要
Gem追加：要
DBマイグレーション：不要

実施した手順¶

さっくりとした手順¶

1. SSHログイン後、追加パッケージをインストール
2. 設定ファイルの書き換え
3. Redmineプラグインに移動
4. gitでレポジトリをダウンロード
5. 新規ジェムをインストール
6. Webサービス再起動

動作に必要な追加パッケージのインストールと設定¶

追加パッケージをインストールします。¶

sudo aptitude install libmagic-dev

パッケージの設定ファイルを修正します。¶

※こちらが上述した脆弱性対応の制限を外す設定です。

• ○バックアップ作成

sudo cp -pi /etc/ImageMagick-6/policy.xml /path/to/backup/directory/policy.xml.$(date +%Y%m%d)
# 任意のバックアップディレクトリを指定してください

diff -u /etc/ImageMagick-6/policy.xml /path/to/backup/directory/policy.xml.$(date +%Y%m%d)
# 差分が無いことでバックアップが取れていることを確認します。

• ○ファイル書き換え

sudo sed -i 's/rights="none" pattern="\(PS\|EPS\|PDF\|XPS\)"/rights="read|write" pattern="\1"/g' /etc/ImageMagick-6/policy.xml

• ○書き換え後の差分確認

diff -u /path/to/backup/directory/policy.xml.$(date +%Y%m%d) /etc/ImageMagick-6/policy.xml
# 保存したバックアップファイルを指定してください

• ●差分

   <!-- in order to avoid to get image with password text -->
   <policy domain="path" rights="none" pattern="@*"/>
   <!-- disable ghostscript format types -->
-  <policy domain="coder" rights="none" pattern="PS" />
+  <policy domain="coder" rights="read|write" pattern="PS" />
   <policy domain="coder" rights="none" pattern="PS2" />
   <policy domain="coder" rights="none" pattern="PS3" />
-  <policy domain="coder" rights="none" pattern="EPS" />
-  <policy domain="coder" rights="none" pattern="PDF" />
-  <policy domain="coder" rights="none" pattern="XPS" />
+  <policy domain="coder" rights="read|write" pattern="EPS" />
+  <policy domain="coder" rights="read|write" pattern="PDF" />
+  <policy domain="coder" rights="read|write" pattern="XPS" />

プラグインのインストール¶

プラグイン格納ディレクトリに移動します。¶

cd /home/www-data/redmine/plugins
# 自分の環境に合わせます。

プラグインを配置します。¶

sudo -u www-data git clone https://github.com/nanego/redmine_preview_pdf

ls -ld redmine_preview_pdf
# このディレクトリがあることを確認します

Gemをインストールします¶

cd /home/www-data/redmine/
# 自分の環境に合わせます。

sudo -u www-data bundle install

Webサービスを再起動します。¶

sudo systemctl restart apache2

動作¶

1. 任意のチケットでPDFを添付して保存します。
2. 保存したチケットを開きます。
3. PDFがサムネイル表示されること、それをクリックしてPDFの拡大ページに遷移すること。

が確認できれば作業は完了です。