クライアント証明書を利用している環境での Companion アプリの利用


Confluence バージョン 6.11 より、「Office で編集」機能に代わって Companion アプリでの編集機能が実装されました。
クライアント証明書を利用している環境では、Confluence の Companion アプリを使用した Office ファイルの編集ができません。
このドキュメントでは、その回避策について案内します。



事象

Companion アプリを使用してファイルを編集しようとすると、以下の「オープン中」の画面のまま進行せず、ファイルが開けません。


Companion アプリが使用できない条件

リバースプロキシサーバーなどでクライアント証明書による認証を有効化している場合、Companion アプリの仕様により Confluence 上で Office ファイルの編集ができません。
以下は Nginx での設定例です。

ssl_verify_client optional;

Companion アプリ機能実装以前の「Office で編集」機能を有効化することで、Companion アプリではなく「Office で編集」機能でファイルを編集することができます。
「Office で編集」機能を有効化すると Companion アプリの機能は無効になります。


「Office で編集」機能を有効化できるバージョン

以下の特定のバージョンで、Office で編集機能を有効にすることができます。

一部バージョンでは WebDAV の脆弱性対策により、WebDAV 機能と「Office で編集」機能を無効化している場合があります。
「Office で編集」機能を有効化すると WebDAV 機能も有効となってしまいますので、
脆弱性対応等で無効化されている場合は有効化にあたり十分ご注意ください。
脆弱性の内容については以下ドキュメントをご参照ください。


Confluence バージョン「Office で編集」のダーク機能との互換性

6.13 (6.13.6 よりもあとのエンタープライズ リリース バージョン)

(ティック) 互換性あり
6.14.x(エラー) 互換性なし

6.15 (6.15.6 よりもあとのバージョン)

(ティック) 互換性あり
7.0.x(エラー) 互換性なし
7.1.x(ティック) 互換性あり
7.2.x(ティック) 互換性あり
7.3.x 以降(情報) Confluence の UI で有効化可能


ダーク機能との互換性があるバージョンでの手順

「Office で編集」機能をダーク機能として有効化する必要があります。これを行うには、管理者としてログインしている必要があります。

    1. <Confluence-url>/admin/darkfeatures.action にアクセスします。
    2. enable.legacy.edit.in.office ダーク機能フラグを入力し、[送信] を選択します。



7.3.x 以降のバージョンでの手順

Confluence のUI 上で有効化が可能です。

    1.  > 一般設定 > Office コネクタの設定に移動します。
    2. Enable Edit in Office for all users を選択し、保存します。



ダーク機能との互換性がないバージョン

残念ながら「Office で編集」機能を有効化することができないため、Confluence 上で Office ファイルを編集することができません。
以下いずれかの回避策で対応するか、バージョンアップを検討してください。

    • クライアント証明書でのアクセス制限を廃止して、アクセス元の IP アドレスを制限するなど別の方法のアクセス制限へ切り替えていただく ⇢ Companion アプリでの編集が可能になります。
    • Companion アプリを使用せず、Office ファイルをローカルにダウンロードして編集し、同ファイル名でアップロードする。
       > アプリを管理 > システムアプリの Confluence Previews プラグインの以下モジュールを無効にして、編集機能を無効化してください。
      • Edit With plugin for the Media Viewer (companion-plugin) 
      • Embedded 'Edit With' button (embedded-edit)

リックソフト株式会社 は、日本でトップレベルのAtlassian Platinum Solution Partnerです。
大規模ユーザーへの対応実績が認められたEnterpriseの認定をうけ、高度なトレーニング要件をクリアし、小規模から大規模のお客様まで対応可能な実績を示したパートナー企業です。


Copyright © Ricksoft Co., Ltd. プライバシーポリシー お問い合わせ