atlassian-admin

Atlassian 管理者エキスパート

ワークフロー

ユーザーのプロビジョニング

1. ユーザーアカウントを作成します：admin.atlassian.com > User management > Invite users
   • REST API：POST /rest/api/3/user with {"emailAddress": "...", "displayName": "...","products": [...]}
2. 適切なグループに追加します：admin.atlassian.com > User management > Groups > [group] > Add members
3. admin.atlassian.com > Products > [product] > Access から製品へのアクセス権（Jira、Confluence）を割り当てます
4. グループスキームごとにデフォルトの権限を設定します
5. オンボーディング情報を添えてウェルカムメールを送信します
6. 通知：新しいメンバーについて、関係するチームリーダーに知らせます
7. 確認：admin.atlassian.com/o/{orgId}/users でユーザーがアクティブとして表示され、ログインできることを確認します

ユーザーのプロビジョニング解除

1. 重要：ユーザーが所有するコンテンツとチケットを監査します
   • Jira：GET /rest/api/3/search?jql=assignee={accountId} で未完了の課題を検索します
   • Confluence：GET /wiki/rest/api/user/{accountId}/property で所有するスペース／ページを確認します
2. 以下の所有権を再割り当てします：
   • Jira プロジェクト：Project settings > People > Change lead
   • Confluence スペース：Space settings > Overview > Edit space details
   • 未完了の課題：Jira > Issues > Bulk change から一括で再割り当てします
   • フィルターとダッシュボード：User management > [user] > Managed content から移管します
3. すべてのグループから削除します：admin.atlassian.com > User management > [user] > Groups
4. 製品へのアクセス権を取り消します
5. アカウントを無効化します：admin.atlassian.com > User management > [user] > Deactivate
   • REST API：DELETE /rest/api/3/user?accountId={accountId}
6. 確認：GET /rest/api/3/user?accountId={accountId} が "active": false を返すことを確認します
7. プロビジョニング解除を監査ログに記録します
8. 利用：残っている課題を再割り当てするには、Jira エキスパートを利用します

グループ管理

1. グループを作成します：admin.atlassian.com > User management > Groups > Create group
   • REST API：POST /rest/api/3/group with {"name": "..."}
   • 次のように構成します：チーム（engineering、product、sales）、役割（admins、users、viewers）、プロジェクト（project-alpha-team）
2. グループの目的とメンバーシップの基準を定義します（Confluence に記録します）
3. グループごとにデフォルトの権限を割り当てます
4. ユーザーを適切なグループに追加します
5. 確認：GET /rest/api/3/group/member?groupName={name} でグループメンバーを確認します
6. 定期的に見直して整理します（四半期ごと）
7. 利用：グループ構成を記録するには、Confluence エキスパートを利用します

権限スキームの設計

Jira の権限スキーム（Jira Settings > Issues > Permission Schemes）：

• 公開プロジェクト：すべてのユーザーが閲覧でき、メンバーは編集できます
• チームプロジェクト：チームメンバーにはフルアクセス、関係者には閲覧権限を付与します
• 制限付きプロジェクト：指定された個人のみがアクセスできます
• 管理者プロジェクト：管理者のみがアクセスできます

Confluence の権限スキーム（Confluence Admin > Space permissions）：

• 公開スペース：すべてのユーザーが閲覧でき、スペースメンバーは編集できます
• チームスペース：チーム固有のアクセス権を設定します
• 個人スペース：個々のユーザーのみがアクセスできます
• 制限付きスペース：指定された個人およびグループのみがアクセスできます

ベストプラクティス：

• 個別の権限ではなく、グループを使用します
• 最小権限の原則を適用します
• 権限を定期的に監査します
• 権限の設定理由を記録します

SSO の設定

1. ID プロバイダー（Okta、Azure AD、Google）を選択します
2. SAML 設定を行います：admin.atlassian.com > Security > SAML single sign-on > Add SAML configuration
   • IdP の Entity ID、ACS URL、X.509 証明書を設定します
3. 管理者アカウントで SSO をテストします（テスト中はパスワードログインを有効のままにします）
4. 一般ユーザーアカウントでテストします
5. 組織で SSO を有効にします
6. SSO を強制します：admin.atlassian.com > Security > Authentication policies > Enforce SSO
7. 自動プロビジョニング用に SCIM を設定します：admin.atlassian.com > User provisioning > [IdP] > Enable SCIM
8. 確認：SSO フローが成功し、監査ログに saml.login.success イベントが記録されることを確認します
9. SSO ログを監視します：admin.atlassian.com > Security > Audit log > filter: SSO

Marketplace アプリの管理

1. アプリの必要性とセキュリティを評価します。marketplace.atlassian.com でベンダーのセキュリティ自己評価を確認します
2. ベンダーのセキュリティ関連ドキュメント（侵入テストレポート、SOC 2）を確認します
3. サンドボックス環境でアプリをテストします
4. 購入またはトライアルをリクエストします：admin.atlassian.com > Billing > Manage subscriptions
5. アプリをインストールします：admin.atlassian.com > Products > [product] > Apps > Find new apps
6. ベンダーのドキュメントに従ってアプリの設定を構成します
7. アプリの使用方法をユーザーにトレーニングします
8. 確認：アプリが GET /rest/plugins/1.0/ に表示され、ヘルスチェックに合格することを確認します
9. アプリのパフォーマンスと使用状況を監視し、引き続き必要かどうかを毎年見直します

システムパフォーマンスの最適化

Jira（Jira Settings > System）：

• 古いプロジェクトをアーカイブします：Project settings > Archive project
• 再インデックスを実行します：Jira Settings > System > Indexing > Full re-index
• 使用していないワークフローとスキームを整理します：Jira Settings > Issues > Workflows
• キュー／スレッド数を監視します：Jira Settings > System > System info

Confluence（Confluence Admin > Configuration）：

• 使用されていないスペースをアーカイブします：Space tools > Overview > Archive space
• 孤立したページを削除します：Confluence Admin > Orphaned pages
• インデックスとキャッシュを監視します：Confluence Admin > Cache management

監視の頻度：

• 毎日のヘルスチェック：admin.atlassian.com > Products > [product] > Health
• 週次のパフォーマンスレポート
• 月次のキャパシティプランニング
• 四半期ごとの最適化レビュー

インテグレーションの設定

一般的なインテグレーション：

• Slack：Jira Settings > Apps > Slack integration — Jira と Confluence の通知
• GitHub/Bitbucket：Jira Settings > Apps > DVCS accounts — コミットを課題にリンクします
• Microsoft Teams：admin.atlassian.com > Apps > Microsoft Teams
• Zoom：Marketplace アプリ zoom-for-jira から利用できます
• Salesforce：Marketplace アプリ salesforce-connector を使用します

設定手順：

1. インテグレーションの要件と必要な OAuth スコープを確認します
2. OAuth または API 認証を構成します（トークンはプレーンテキストではなく、安全な保管庫に保存します）
3. フィールドとデータフローをマッピングします
4. サンプルデータを使ってインテグレーションを十分にテストします
5. Confluence の運用手順書に設定を記録します
6. インテグレーションの機能についてユーザーをトレーニングします
7. 確認：Jira Settings > System > WebHooks > [webhook] > Test で Webhook が配信されることを確認します
8. アプリ固有のダッシュボードでインテグレーションの状態を監視します

グローバル設定

Jira のグローバル設定（Jira Settings > Issues）

課題タイプ：組織全体で使用する課題タイプを作成・管理し、課題タイプスキームを定義して、プロジェクト間で標準化します ワークフロー：Workflows > Add workflow からグローバルなワークフローテンプレートを作成し、ワークフロースキームを管理します カスタムフィールド：Custom fields > Add custom field で組織全体のカスタムフィールドを作成し、フィールド構成とコンテキストを管理します 通知スキーム：デフォルトの通知ルールを構成し、カスタム通知スキームを作成して、メールテンプレートを管理します

Confluence のグローバル設定（Confluence Admin）

ブループリントとテンプレート：Configuration > Global Templates and Blueprints で組織全体のテンプレートを作成し、ブループリントの利用可否を管理します テーマと外観：Configuration > Themes で組織のブランディングを構成し、ロゴと色をカスタマイズします マクロ：Configuration > Macro usage でマクロを有効／無効にし、マクロの権限を構成します

セキュリティ設定（admin.atlassian.com > Security）

認証：

• パスワードポリシー：Security > Authentication policies > Edit
• セッションタイムアウト：Security > Session duration
• API トークン管理：Security > API token controls

データレジデンシー：admin.atlassian.com > Data residency > Pin products でデータの保存場所を構成します

監査ログ：admin.atlassian.com > Security > Audit log

• 包括的なロギングを有効にします。GET /admin/v1/orgs/{orgId}/audit-log でエクスポートします
• ポリシーに従って保持します（SOC 2／GDPR 準拠のため、最低 7 年間）

ガバナンスとポリシー

アクセスガバナンス

• すべてのユーザーアクセスを四半期ごとにレビューします：admin.atlassian.com > User management > Export users
• ユーザーの役割と権限を確認し、非アクティブなユーザーを削除します
• 組織管理者を2～3人に制限し、管理者の操作を毎月監査します
• すべての管理者にMFAを必須にします：Security > Authentication policies > Require 2FA

命名規則

Jira：プロジェクトキーは大文字3～4文字（PROJ、WEB）、課題タイプはタイトルケース、カスタムフィールドには接頭辞を付けます（CF: Story Points） Confluence：スペース名にはチーム／プロジェクトの接頭辞を使用します（TEAM: Engineering）。ページ名は内容が分かりやすく、一貫性のあるものにします。ラベルは小文字で、ハイフン区切りにします

変更管理

大規模な変更：2週間前に告知し、サンドボックスでテストし、ロールバック計画を作成し、利用の少ない時間帯に実施して、実施後にレビューします 小規模な変更：48時間前に告知し、変更ログに記録し、問題がないか監視します

災害復旧

バックアップ戦略

JiraとConfluence：毎日の自動バックアップ、毎週の手動確認、30日間の保持、オフサイト保管

• 手動バックアップを実行するには：Jira Settings > System > Backup system / Confluence Admin > Backup and Restore

復旧テスト：四半期ごとに復旧訓練を実施し、手順を文書化して、RTOとRPOを測定します

インシデント対応

重大度レベル：

• P1（重大）：システム停止 — 15分以内に対応
• P2（高）：主要機能の障害 — 1時間以内に対応
• P3（中）：軽微な問題 — 4時間以内に対応
• P4（低）：機能改善 — 24時間以内に対応

対応手順：

1. インシデントを受け付け、記録します
2. 影響と重大度を評価します
3. 関係者に状況を伝えます
4. 根本原因を調査します（admin.atlassian.com > Products > [product] > HealthとAtlassian Status Pageを確認します）
5. 修正を適用します
6. 検証：影響を受けたユーザーによるテストとヘルスチェックを通じて、解決を確認します
7. 事後分析を行い、教訓をまとめます

指標とレポート

システムの健全性：アクティブユーザー数（日次／週次／月次）、ストレージ使用率、APIレート制限、連携の健全性、応答時間

• エクスポート方法：ユーザー数にはGET /admin/v1/orgs/{orgId}/usersを使用します。製品固有の分析ダッシュボードも利用できます

利用状況分析：最もアクティブなプロジェクト／スペース、コンテンツ作成の傾向、ユーザーエンゲージメント、検索パターン コンプライアンス指標：ユーザーアクセスレビューの完了状況、セキュリティ監査の指摘事項、ログイン失敗回数、APIトークンの使用状況

意思決定フレームワークと引き継ぎプロトコル

Atlassianサポートにエスカレーション：システム障害、組織全体に及ぶパフォーマンスの低下、データの損失／破損、ライセンス／請求の問題、複雑な移行

製品エキスパートに委任：

• Jiraエキスパート：プロジェクト固有の設定
• Confluenceエキスパート：スペース固有の設定
• スクラムマスター：チームのワークフローに関するニーズ
• シニアPM：戦略計画への助言

セキュリティチームを関与させる：セキュリティインシデント、不審なアクセスパターン、コンプライアンス監査の準備、新しい連携のセキュリティレビュー

Jiraエキスパートへ：新しいグローバルワークフロー、カスタムフィールド、権限スキーム、または利用可能な自動化機能 Confluenceエキスパートへ：新しいグローバルテンプレート、スペース権限スキーム、ブループリント、または設定済みのマクロ シニアPMへ：利用状況分析、キャパシティプランニングの知見、コスト最適化、セキュリティコンプライアンスの状況 スクラムマスターへ：チームアクセスのプロビジョニング、ボード設定の選択肢、自動化ルール、有効化された連携 すべての役割から：ユーザーアクセス申請、権限変更、アプリのインストール申請、設定サポート、インシデント報告

Atlassian MCP 統合 — 対応範囲の制限

Atlassian Remote MCP サーバー（同梱の .mcp.json、サーバーキー atlassian）では、管理操作を利用できません。正規のツール一覧（project-management/references/atlassian-mcp-tools.md）には、ユーザー／グループ管理、権限スキーム、フィールド／ワークフロー設定、SSO、アプリ管理、組織設定のためのツールはありません。ツール名を決して捏造しないでください。このスキルの管理ワークフローはすべて、admin.atlassian.com または上記でインライン引用した REST API を通じて実行します。

MCP が管理作業に提供できること（主に読み取りをサポート）：

• mcp__atlassian__lookupJiraAccountId — アカウントの停止処理の監査前に、ユーザーを accountId に解決します
• mcp__atlassian__searchJiraIssuesUsingJql — 再割り当て対象となる退職者の未完了課題を検索します（assignee = <accountId>）
• mcp__atlassian__getVisibleJiraProjects / mcp__atlassian__getConfluenceSpaces — アクセスレビューの棚卸しに使用する情報を取得します
• mcp__atlassian__atlassianUserInfo / mcp__atlassian__getAccessibleAtlassianResources — 操作中のユーザー ID とアクセス可能なサイトを確認します

統合ポイント：

• MCP では実行できない UI／REST による管理変更を実施し、Jira／Confluence エキスパートをサポートします
• admin.atlassian.com からエクスポートした情報を使って、シニア PM が組織の健全性を把握できるようにします
• 管理コンソールを使ってチームのプロビジョニングを行い、スクラムマスターをサポートします