エンジニアの皆さん、こんにちは。現場でConfluenceを使いこなしていると、「HTMLでリッチなUIを作りたい」「社内の業務ツールをページに埋め込みたい」といった欲求に駆られることはありませんか？
しかし、その「便利さ」の裏には、組織の資産を危険に晒す「セキュリティの穴」が潜んでいます。今回は、Confluenceという強力なナレッジベースを、「いかに安全に、かつ最大限に拡張するか」という、管理者としての生存戦略を伝授します。
—
1. なぜConfluenceの「HTML埋め込み」が危険なのか？
Confluenceには強力な「HTMLマクロ」という機能があります。これを使うと、JavaScriptやCSSを直接ページに埋め込めます。これがなぜ危険か、直感的に理解しましょう。
- XSS（クロスサイトスクリプティング）の温床: 悪意のあるユーザーがスクリプトを埋め込めば、閲覧した他メンバーの認証Cookieを盗んだり、ブラウザ上で勝手な操作を行わせたりすることが可能です。
- 権限昇格の踏み台: 「管理者権限を持つユーザー」がそのページを開いた瞬間、スクリプトが管理者の権限で実行されてしまうリスクがあります。
これを防ぐための第一歩は、「デフォルトですべてを禁止し、信頼できるものだけを許可する」というゼロトラストの思想です。
—
2. 管理者のための「防御の要」：HTMLマクロの制御
初心者の方はまず、HTMLマクロが誰でも使える状態になっていないか確認してください。これが「裸で戦場に立つ」ような状態です。
手順1：HTMLマクロの無効化（基本中の基本）
1. 右上の歯車アイコン > 「一般設定」へ。
2. 左メニューの 「マクロ」 をクリック。
3. 「HTML」マクロを探し、「無効（Disable）」に設定してください。
これだけで、不用意なスクリプト挿入を物理的にシャットアウトできます。「えっ、使えなくなると困る！」という声が聞こえますが、ここからが「賢い管理者」の腕の見せ所です。
—
3. 「信頼の境界」を作る：スペースポリシーによる運用
全て禁止した上で、特定の信頼できるユーザーにのみ機能を解放する、これがチームのベロシティを落とさないための最適解です。
手順2：スペース権限によるコントロール
HTML埋め込みが必要な場合、特定の「検証用スペース」を作成し、そこに「システム管理者」または「極めて信頼のおけるエンジニア」のみがページ編集権限を持つように設定します。
- 鉄則: 開発・実験用のスペースと、全社的なナレッジベースを分離する。
- 運用フロー: 「HTMLでリッチなUIを作りたい」という要望があれば、管理者であるあなたがコードをレビューし、安全性を確認してから本番ページに適用する（または管理者のみが編集できる別ページとして運用する）。
—
4. Hello World: 安全な「埋め込み」の作法
どうしても外部ツールを埋め込みたい場合、HTMLマクロを直接叩くのではなく、「Iframeマクロ」を活用してください。これはサンドボックス化された環境で動作するため、XSSを防ぐための強力な防壁になります。
安全な埋め込みのテスト（HelloWorld的アプローチ）
1. Confluenceページで `/iframe` と入力。
2. ソースURL: 信頼できる外部ツールのURLを入力。
3. セキュリティ設定: `sandbox` 属性を有効にし、スクリプト実行を必要最小限に制限します。
—
5. 最後に：現場を動かす「守りの文化」
「制限が多いと開発スピードが落ちる」と嘆く声もあるかもしれません。しかし、一度セキュリティ事故が起きれば、信頼回復には数倍の時間がかかります。
- コードレビューの習慣化: HTMLやJSをページに埋め込む際は、必ず「ペアプロ」ならぬ「ペア・ドキュメント構成」を行い、セキュリティリスクがないか二人で確認する。
- 公式プラグインの優先: HTMLマクロを使う前に、Atlassian Marketplaceに安全なプラグインがないか探す。それが最も近道で安全な方法です。
「制限は、創造性を殺すものではなく、安全という土台の上で自由に飛ぶための翼である」
このマインドセットでConfluenceを管理すれば、あなたのチームのナレッジ管理は、驚くほど強固で、かつ生産的なものに進化するはずです。まずは今日、HTMLマクロの設定を見直すことから始めてみてくださいね！
何か具体的なツールの埋め込みで困っていることがあれば、いつでも相談してください。あなたの現場の安全を、全力でサポートします。