Contents
スポンサードリンク
前提条件と権限設定
必要な権限
- Site admin（サイト全体の管理者）であること
- Settings → Users から自分のアカウントが Site admin に設定されているか確認。
- 複数人で管理する場合は、
atlassian-adminsというグループを作成しメンバーを追加すると運用が楽になる。
対象となるクラウドプラン
| プラン | 主な機能 |
|---|---|
| Standard | Application Links の基本設定、API アクセス（Read‑only） |
| Premium | 監査ログの詳細検索、IP 制限・SAML SSO など高度なセキュリティ機能 |
| Enterprise | 大規模組織向けのカスタム SLA と高度権限管理 |
ポイント：最低でも Standard プランが必要です。
高度なトラブルシューティングや監査要件がある場合は Premium 以上 を推奨します。
出典: Atlassian Cloud 製品比較ページ（2024‑11‑12 取得）[^1]
Application Links の作成手順
UI フロー
- Jira Cloud 管理画面 → Settings → Applications → Application Links を開く
- 「Link a new application」に Confluence の URL（例:
https://<site>.atlassian.net/wiki）を入力し Create new link をクリック - ウィザードが表示されたら以下を設定
- Application Name：任意の名称（例：Confluence）
- Application Type：自動で
Confluenceが選択されるはずです - 「Continue」→「Configure」画面で認証方式を選択
認証方式の比較
| 項目 | OAuth 1.0a | 3‑legged OAuth（3LO） |
|---|---|---|
| フロー | シークレット交換だけで完結 | ユーザー同意画面が必須 |
| 適用シーン | 社内スクリプトや自動化ツール向け | 外部ユーザーや SSO 環境での利用に最適 |
| 推奨度 | 旧来環境の保守的な選択肢 | 現行では Premium 以上 のプランで標準推奨 |
Atlassian 公式ドキュメント「Application Links の認証方式」(2024‑10‑30 取得) を参照[^2]
Confluence 側で Jira Issue / Jira カードマクロを利用する手順
マクロ挿入の基本フロー
- Confluence の編集画面で 「＋」メニュー → 「その他のマクロ」 を選択
- 検索ボックスに
Jira IssueもしくはJira カードと入力し、該当マクロをクリック - ダイアログに Jira 課題キー（例：
PROJ-1234）または JQL クエリを入力 - 表示オプション（列・ステータス・担当者の有無、カードサイズなど）を設定し Insert
主な表示オプション
| オプション | 効果 |
|---|---|
| Columns | 必要なフィールドだけを表示し、ページ幅に合わせて最適化 |
| Show summary | 課題の概要テキストをカード上部に表示 |
| Compact view | カードサイズを小さくし、一覧性を向上 |
詳細は Atlassian 公式ガイド「Confluence と Jira を連携させる方法」(2024‑11‑05 取得) に記載[^3]
接続確認と一般的なトラブルシューティング
基本テスト手順
| 手順 | 内容 |
|---|---|
| 1. 課題キー埋め込み | Confluence ページに {jira:PROJ-1234}（Issue マクロ）または Jira カードマクロを挿入し、保存後に課題情報が正しく表示されるか確認 |
| 2. 監査ログのエラーチェック | Settings → Audit log に移動し、App フィルタで Jira または Confluence を選択、過去 24 時間の「Error」タグ付きレコードを確認 |
主な認証エラーと対処法
| エラーコード | 想定原因 | 推奨対策 |
|---|---|---|
| 401 Unauthorized | OAuth シークレットが古い、もしくは 3LO 同意が失効 | Application Links → Edit でシークレットを再生成、またはユーザーに再認証を依頼 |
| 403 Forbidden (App filter mismatch) | Audit log の App フィルタ設定が Jira と Confluence で別々になっている | Settings → Audit log で同一アプリ（例：Jira）だけを選択し、エラーレコードを再確認 |
| 404 Not Found | URL タイプミスやサブドメイン不一致 | Application Links の URL を正規化（https://<site>.atlassian.net/wiki 形式） |
エラー発生時は必ず Audit log と Application Links 設定画面 の両方をクロスチェックしてください。
ステージングでの検証推奨
- 本番環境に適用する前に、別途作成した ステージングスペース で同様の手順を実施し、すべてのマクロが期待通り表示されることを確認。
- 問題が解消されたら、本番ページへ同一設定を展開することでリスクを最小化できます。
まとめ（要点）
| 項目 | キーポイント |
|---|---|
| 権限 | Site admin 権限と Standard 以上 のクラウドプランが必須 |
| リンク作成 | Jira → Settings → Applications → Application Links で Confluence URL を登録 |
| 認証方式 | 新規導入は 3LO（Premium 推奨）、既存スクリプトは OAuth 1.0a でも可だが将来的に 3LO 移行を検討 |
| マクロ使用 | 正しくリンクできていれば Confluence に Jira Issue / カードマクロが即時表示 |
| テスト・監査 | 課題キー埋め込みと Audit log のエラーチェックで接続状態を定期的に検証 |
参考情報
[^1]: Atlassian Cloud 製品比較ページ, https://www.atlassian.com/ja/software/cloud/comparison, 2024‑11‑12 取得。
[^2]: Application Links の認証方式（公式サポート），https://support.atlassian.com/ja/jira-cloud/docs/configure-application-links/, 2024‑10‑30 取得。
[^3]: Confluence と Jira を連携させる方法（公式ガイド），https://www.atlassian.com/ja/software/confluence/resources/guides/extend-functionality/confluence-jira, 2024‑11‑05 取得。
スポンサードリンク