Confluence Cloud との統合

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：16分

    • ソフトウェア資産管理 アプリケーションを Confluence Cloud アプリケーションと統合すると、ソフトウェアサブスクリプションを追跡し、未使用のライセンスを再利用することができます。

    現在、この統合はプロファイルごとに 1 つのサイト統合のみをサポートしています。

    重要:
    必要なユーザーまたは API 権限のみにアクセス権を付与することで、セキュリティリスクを最小限に抑え、情報を保護します。
    表 : 1. 最小限のユーザー権限
    プロセス Confluence Cloud アプリケーションで必要なユーザーロール 認証スコープ
    サブスクリプションをダウンロード Confluence 製品のユーザーロール
    • ユーザーグループの読み取り (read:confluence-groups)
    • 読み込みユーザー (read:confluence-user)
    ユーザーアクティビティのプル Confluence 製品のユーザーロール Confluence コンテンツとスペースのサマリーを検索 (search:confluence)
    サブスクリプションを再利用 サイトアドミン
    • ユーザーグループの読み取り (read:confluence-groups)
    • ユーザーグループの作成、削除、更新 (write:confluence-groups)

    Confluence Cloud OAuth 2.0 (3LO) アプリケーションの作成

    Confluence Cloud OAuth 2.0 (3LO) アプリケーションを作成して、Confluence Cloud API へのアクセスを有効にします。

    始める前に

    Atlassian 必要なロール: 「最小限のユーザー権限 」表を参照してください。

    手順

    1. Web ブラウザーから、Atlassian Developer portalを開きます。
    2. サイトアドミンアカウントにログインします。
    3. ポータルのページヘッダーで、プロファイルアイコンを選択し、[ 開発者コンソール] を選択します。
      Atlassian 開発者コンソールの [自分のアプリケーション (My apps)] ページが開きます。
    4. [ アプリを作成 ] メニューを選択し、[ OAuth 2.0 (3LO) 統合] を選択します。
      [新しい OAuth 2.0 (3LO) データ連携を作成 (Create a new OAuth 2.0 (3LO) integration)] ページが開きます。
    5. [名前] フィールドに OAuth 2.0 (3LO) アプリケーションの名前を入力します。
    6. [Atlassian の開発者規約に拘束されることに同意する] チェック ボックスを選択し、[作成] を選択します。
    7. アプリケーションの認証設定を構成します。
      1. 左側のナビゲーションペインで、[認証 (Authorizatio)] を選択します。
      2. [OAuth 2.0 (3LO) 認証タイプ] で [ 構成 ] を選択します。
        [アプリの OAuth 2.0 認証コード許可 (3LO) (OAuth 2.0 authorization code grants (3LO) for apps)] ページが開きます。
      3. [コールバック URL] フィールドで、ユーザーが認証後にリダイレクトされる OAuth プロバイダーの URL を入力します。
        https://instance.service-now.com/oauth_redirect.do と入力します。<instance> はServiceNowインスタンスの名前です。
      4. [変更内容を保存] を選択します。
    8. アプリケーションの API スコープを構成します。
      API スコープは、アプリケーションが Atlassian API に対して保持する必要がるアクセスのレベルを指定します。
      1. 左側のナビゲーションペインで、[権限 (Permissions)] を選択します。
      2. 使用可能な API の一覧から Confluence API を見つけて、 追加 を選択します。
        [追加] アクションボタンが自動的に [構成] アクションボタンに変わります。
      3. [Configure] を選択します。
        [Confluence API] ページが開きます。
      4. Confluence API の次のスコープを追加します。
        • Confluence コンテンツとスペースのサマリーの検索
        • ユーザーグループの読み取り
        • ユーザーグループの作成、削除、更新
        • ユーザーの読み取り
    9. アプリケーションにアサインされているクライアント ID とクライアントシークレットを取得します。
      1. 左側のナビゲーションペインで、[設定] を選択します。
      2. [認証の詳細] セクションで、[クライアント ID] と [シークレット] フィールドの値をコピーします。
        後で使用できるように安全な場所に保存してください。

    Confluence Cloudインスタンスのクラウド ID 値を取得する

    Confluence Cloudクラウドインスタンスのクラウド ID の値を取得します。この値は、ServiceNow インスタンスの接続レコードを構成するときに必要です。

    始める前に

    Confluence Cloud 必要なロール：admin

    手順

    1. Atlassian Administration にログインします。
    2. 必要な組織に対して [ 選択 ] ボタンを選択します。
    3. [製品] タブを選択します。
    4. [製品] ページで、Confluence 製品行の [製品の管理 ] を選択します。

      新しいウィンドウでは、URL は次の形式です: https://admin.atlassian.com/o/<orgID>/products/conf/<Cloud-Id>。

    5. 後で使用するためにクラウド ID の値をコピーします。

    Confluence Cloud 統合プロファイルの作成

    Confluence Cloud 統合プロファイルを作成して、ソフトウェアサブスクリプションを追跡し、Confluence Cloudアプリケーションのライセンスを最適化します。

    始める前に

    Confluence Cloud統合プロファイルを作成するには、ServiceNow Store から ソフトウェア資産管理 - SaaS ライセンス管理 プラグイン (sn_sam_saas_int) を要求します。

    Atlassian 必要なロール:サイトアドミン

    ServiceNow 必要なロール:sam_integrator、sn_confluence_spoke.confluence_cloud_admin

    重要:
    [Application Manager] ページでオプション機能をインストールする際には、この統合の [Confluence Cloud スポーク] チェックボックスをオンにする必要があります。必要な SaaS アプリケーションの選択の詳細については、「 SaaS ライセンス管理の要求」を参照してください。

    このタスクについて

    ソフトウェア資産ワークスペースを使用している場合、コア UI でConfluence Cloud統合プロファイルを作成するオプションは非アクティブです。

    手順

    1. 統合プロファイルに移動します。
      インターフェイスアクション
      コア UI
      1. 移動先 すべて > ソフトウェア資産 > SaaS ライセンス > 直接統合プロファイル.
      2. [New (新規)] を選択します。
      3. Confluence Cloud 統合プロファイルを選択します。
      ソフトウェア資産ワークスペース
      1. 移動先 ライセンス操作 > ユーザー登録 > 直接統合プロファイル.
      2. [New (新規)] を選択します。
      3. ドロップダウン リストから Confluence Cloud を選択します。
      4. [Continue (続行)] を選択します。
    2. フォームで、フィールドに入力します。
      表 : 2. 統合プロファイルフォーム
      フィールド 値
      表示名 データ連携プロファイルの名前例:Confluence Cloud 統合。
      ステータス 統合プロファイルのステータス。
      • 統合プロファイルを公開していない場合、このフィールドは自動的に [ドラフト] に設定されます。
      • 統合プロファイルを既に公開している場合、このフィールドは自動的に [公開済み] に設定されます。
      プロファイルタイプ 統合プロファイルのタイプ。

      このフィールドは自動的に Confluence Cloud サブスクリプションに設定されます。
    3. 各プロセスの [ ベンダー構成 ] フィールドで指定された必要なユーザーロールまたは API 権限を確認して、セキュリティリスクを最小限に抑え、 SaaS ライセンスを最適化します。
      注:
      詳細については、「 最小限のユーザーアクセス許可 」テーブルを参照してください。
      1. [サブスクリプションのダウンロードサブフロー] セクションで、[ サブフロー ] フィールドが [Confluence Cloud サブスクリプションのダウンロード] に設定されていることを確認します。
        注:
        [ サブスクリプションをダウンロード ] チェックボックスはデフォルトでオンになっており、オフにすることはできません。
      2. [アクティビティ サブフローを計算] セクションで、[ サブフロー ] フィールドが [Confluence Cloud ユーザー アクティビティの更新] に設定されていることを確認します。
        注:
        [ ダウンロードアクティビティ ] チェックボックスはデフォルトでオンになっています。これをクリアすると、アクティビティのスケジュール済みジョブ SAM - Refresh <displayname> Activity は作成されません。
        [ ユーザーアクティビティを分析 ] フィールドで、ユーザーアクティビティを分析する開始日時を選択することもできます。デフォルトでは、現在の日付の 60 日前までのユーザーアクティビティを分析し、このプロファイルを作成したときから個々のユーザーが実行したイベントを表示できます。
        注:
        ソフトウェア資産管理 は、プロファイルの作成日に関係なく、ユーザーアクティビティの分析を開始した時点からのイベントをプルします。
        この値は、ソフトウェア再利用ルールの [前回のアクティビティしきい値] フィールドで変更できます。詳細については、「ソフトウェア再利用ルールのレビュー」を参照してください。
      3. [サブスクリプションサブフローの再利用] セクションで、[ サブフロー ] フィールドが [Confluence Cloud サブスクリプションの再利用] に設定されていることを確認します。
        注:
        [ サブスクリプションを再利用 ] チェックボックスはデフォルトでオンになっています。サブスクリプションを再利用しない場合は、このチェックボックスをオフにします。これをクリアすると、削除候補は作成されますが、サブスクリプションの再利用サブフローがトリガーされないか、再利用プロセスが開始されません。
    4. [Save (保存)] を選択します。
      ドラフトの統合プロファイルが作成されます。

      [接続と資格情報] フィールドが表示され、すべてのプロセスが選択されている場合に自動的に sn_conflunce_spoke.confluence_subscription_activity_reclaim に設定されます。

      注:
      [接続と資格情報] フィールドに自動的に入力された値は、[アクティビティのダウンロード] チェック ボックスと [サブスクリプションの再利用] チェック ボックスでの選択に基づいて変更されます。
      表 : 3. 選択に基づいて自動的に入力される接続および認証情報の値
      選択 接続と認証情報の値
      [ダウンロードアクティビティ] と [サブスクリプションを再利用] の両方が選択されています。 sn_conflunce_spoke.confluence_subscription_activity_reclaim
      ダウンロードアクティビティのみが選択されています。 sn_conflunce_spoke.confluence_subscription_activity
      [サブスクリプションを再利用] のみが選択されています。 sn_conflunce_spoke.confluence_subscription_reclaim
      [ダウンロードアクティビティ] と [サブスクリプションを再利用] の両方が選択されていません。 sn_conflunce_spoke.confluence_subscription
    5. [接続および資格情報] フィールドの横にあるプレビューアイコン (プレビューアイコン)を選択し、レコードプレビューで [レコードを開く] を選択して、接続および資格情報エイリアスレコードを開きます。
    6. [接続および資格情報エイリアス] フォームで、[ 新しい接続および資格情報を作成 ] 関連リンクを選択します。
    7. ダイアログボックスで、フィールドに入力します。
      表 : 4. [接続と資格情報を作成] ダイアログボックス
      フィールド 説明
      名前 接続の名前。
      接続 URL Confluence Cloudインスタンスの URL を https://api.atlassian.com/ex/confluence/<Cloud-ID 形式で指定します。

      クラウド ID の値の取得の詳細については、「 Confluence Cloudインスタンスのクラウド ID 値を取得する」を参照してください。
      OAuth クライアント ID Confluence Cloud OAuth 2.0 (3LO) アプリケーションにアサインされているクライアント ID。
      OAuth クライアントシークレット Confluence Cloud OAuth 2.0 (3LO) アプリケーションにアサインされているクライアントシークレット。
      OAuth リダイレクト URL 認証後にユーザーがリダイレクトされる OAuth プロバイダーの URL。

      このフィールドは、「Confluence Cloud OAuth 2.0 (3LO) アプリケーションの作成」で指定したコールバック URL に基づいて自動的に入力されます。
    8. [OAuth トークンを作成して取得] を選択します。
      注:
      この手順を実行するために必要なロールについては、「 最小限のユーザー権限 」表を参照してください。
    9. ダイアログボックスが表示されたら、 Confluence Cloud アプリケーションに権限を付与します。
      ダイアログボックスが閉じ、自動的に [接続および資格情報エイリアス] フォームに戻ります。
    10. Confluence 製品にアクセスできるグループを指定します。
      ServiceNowインスタンスでこれらのグループを指定すると、これらのグループ内のユーザーのみのデータを取得し、ライセンスを管理できます。
      1. 新しいタブで、 Atlassian 管理ポータルを開きます。
      2. site_admin ロールで admin アカウントにログインします。
      3. 必要な組織に対して [ 選択 ] ボタンを選択します。
      4. [製品] タブを選択します。
      5. [製品] ページで、Confluence 製品行の [製品の管理 ] を選択します。
      6. Confluence 製品にアクセスできるグループのリストを表示します。
        後で使用するために、この情報をメモします。
      7. ServiceNowインスタンスに戻り、次に移動します: Confluence Cloud > Confluence グループ.
      8. Confluence グループ フォームで、[ グループの追加 ] 関連リンクを選択します。
        [Confluence グループを追加 (Add Confluence Groups)] ダイアログボックスが開きます。
      9. 統合プロファイルで設定された接続と資格情報を選択します。
      10. [利用可能] リストで、Confluence 製品にアクセスできるグループを選択します。
        ヒント:
        [利用可能] リストには、Atlassian アカウントに関連付けられているすべてのグループが含まれます。Confluence 製品にアクセスできるグループのみを選択します。
      11. 右矢印ボタンを選択して、グループを [利用可能] リストから [選択済み] リストに移動します。
      12. [OK] を選択します。
    11. 統合プロファイルに戻り、統合プロファイルを選択します。
    12. 統合プロファイルフォームで、[ 接続を検証 ] を選択して、この統合の接続と資格情報の詳細を確認します。

      接続を検証すると、Download Subscriptions API と Calculate Activity API は検証されますが、Reclaim Subscriptions API は検証されません。

    13. 接続を確認したら、[ 公開] を選択します。
    14. 公開の確認 ダイアログ ボックスで、 OK を選択します。
      注:
      統合プロファイルの公開後に [ ダウンロードアクティビティ ] チェックボックスをオフにすると、次のイベントが発生するため、接続を再検証してから統合プロファイルを再公開する必要があります。
      • 統合プロファイルフォームの [ ステータス ] フィールドが [ドラフト] に変わります。
      • [ 接続を検証] ボタンがフォームに表示されます。
      • 現在の SAM - Refresh <displayname> Activity ジョブが削除されます。

    次のタスク

    統合が接続されると、 ServiceNow インスタンスでソフトウェアモデル、再利用ルール、ソフトウェアサブスクリプションが自動的に作成され、毎日更新されます。

    統合プロファイルを作成した後、次の場所に移動して、 ソフトウェア資産ワークスペース 内のプロファイルに関する情報を表示します ライセンス操作 > ユーザーサブスクリプション > 直接統合プロファイル. 統合プロファイルを選択すると、次の関連リストを表示できます。デフォルトビューの統合プロファイルに対して次の関連リストがすべて表示されない場合は、[詳細] タブからカスタム統合ビューを選択できます。
    • ソフトウェアモデル
    • 認識されないサブスクリプション識別子
    • スケジュール済みジョブ
    • スケジュール済みジョブの結果
    • ソフトウェアサブスクリプション
    • サブスクリプション識別子除外ルール
    • サブスクリプションユーザー除外ルール

    統合プロファイルを作成した後、サブスクリプション除外ルールを定義して、特定のサブスクリプションをライセンスコストの計算対象にしないようにすることができます。詳細については、「SaaS および SSO アプリケーションのサブスクリプション除外」を参照してください。

    一意の接続を持つ複数の統合プロファイルを設定する場合は、子エイリアスを作成して、統合プロファイルごとに異なる構成と設定を管理します。詳細については、「子エイリアスを作成して複数の Confluence Cloud 統合プロファイルを設定する」を参照してください。

    ユーザーサブスクリプションを再利用するために、自動的に生成されたすべての再利用ルールを確認します。詳細については、「ソフトウェア再利用ルールのレビュー」を参照してください。

    自動生成されたソフトウェアモデルのソフトウェアエンタイトルメントを作成して、使用済みソフトウェアを所有ソフトウェアに対して追跡します。
    調整は、サブスクリプションでもスケジュール済みジョブとして、またはオンデマンドで実行されます。調整結果は、 ライセンスワークベンチ (クラシックアプリケーションソフトウェア資産管理 ) または ライセンス使用状況ビュー (ソフトウェア資産ワークスペース) で表示できます。これらの結果を使用して、ライセンスコンプライアンスの状況を判断し、コンプライアンス違反を修正します。