Confluence Cloud との統合

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む11読むのに数分
  • インスタンスをアプリケーションとConfluence Cloud統合ServiceNowして、ソフトウェアサブスクリプションを追跡し、未使用のライセンスを再利用することができます。

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

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

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

    始める前に

    Atlassian 必要なロール:site admin

    手順

    1. Web ブラウザーから、Atlassian 開発者ポータルを開きます。
    2. サイト管理者アカウントにログインします。
    3. ポータルのページヘッダーで、プロファイルアイコンをクリックし、[開発者コンソール (Developer console)] を選択します。
      Atlassian 開発者コンソールの [自分のアプリケーション (My apps)] ページが開きます。
    4. [アプリを作成 (Create app)] メニューをクリックし、[OAuth 2.0 (3LO) データ連携 (OAuth 2.0 (3LO) integration)] を選択します。
      [新しい OAuth 2.0 (3LO) データ連携を作成 (Create a new OAuth 2.0 (3LO) integration)] ページが開きます。
    5. [名前] フィールドに OAuth 2.0 (3LO) アプリケーションの名前を入力します。
    6. [Atlassian の開発者条件に従うことに同意します (I agree to be bound by Atlassian's developer terms)] チェックボックスをオンにして、[作成] をクリックします。
      新しく作成されたアプリの概要および設定が開きます。
    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. [構成] をクリックします。
        [Confluence API] ページが開きます。
      4. Confluence API の次のスコープを追加します。
        • Confluence コンテンツとスペースのサマリーの検索
        • ユーザーグループの読み取り
        • ユーザーグループの作成、削除、更新
        • ユーザーの読み取り
    9. アプリケーションにアサインされているクライアント ID とクライアントシークレットを取得します。
      1. 左側のナビゲーションペインで、[設定] を選択します。
      2. [認証の詳細] セクションで、[クライアント ID] [シークレット] フィールドの値をコピーします。
        後で使用できるように安全な場所に保存してください。

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

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

    始める前に

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

    Atlassian 必要なロール:site admin

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

    このタスクについて

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

    手順

    1. 統合プロファイルに移動します。
      インターフェイスアクション
      コア UI
      1. 移動先 すべて > ソフトウェア資産 > SaaS ライセンス > 直接統合プロファイル.
      2. [New (新規)] を選択します。
      3. [Confluence Cloud 統合プロファイル] を選択します。
      Software Asset Workspace
      1. 移動先 ライセンス操作 > ユーザー登録 > 直接統合プロファイル.
      2. [New (新規)] を選択します。
      3. ドロップダウン リストから [Confluence Cloud ] を選択します。
      4. [続行] を選択します。
    2. フォームのフィールドに入力します。
      表 : 1. 統合プロファイルフォーム
      フィールド
      表示名 データ連携プロファイルの名前例: Confluence Cloud 統合
      接続と資格情報 Confluence Cloud の接続と認証情報エイリアス。このフィールドは、自動的に入力されます。
      ステータス 統合プロファイルのステータス。統合プロファイルを公開していない場合、このフィールドは自動的に [ドラフト] に設定されます。統合プロファイルを既に公開している場合、このフィールドは自動的に [公開済み] に設定されます。
      プロファイルタイプ 統合プロファイルのタイプ。このフィールドは自動的に [ Confluence Cloud サブスクリプション] に設定されます。
    3. [ サブスクリプションのダウンロードサブフロー ] タブで、[ サブフロー ] フィールドが [ Confluence Cloud サブスクリプションのダウンロードサブフロー] に設定されていることを確認します。
    4. [ アクティビティサブフローを計算] タブで、[ サブフロー ] フィールドが [Confluence Cloud ユーザーアクティビティサブフローを更新] に設定されていることを確認します。
      [ユーザー アクティビティの分析元] フィールドで、ユーザー アクティビティを分析する日時を選択することもできます。デフォルトでは、現在の日付の 60 日前までのユーザーアクティビティを分析し、このプロファイルの作成以降に個々のユーザーが実行したイベントを表示できます。
      注:
      ソフトウェア資産管理 は、プロファイルの作成日に関係なく、ユーザーアクティビティの分析を開始した時点からのイベントをプルします。
      この値は、ソフトウェア再利用ルールの [前回のアクティビティしきい値] フィールドで変更できます。詳細については、「ソフトウェア再利用ルールのレビュー」を参照してください。
    5. [ サブスクリプションの再利用サブフロー ] タブで、[ サブフロー ] フィールドが [ Confluence Cloud サブスクリプションの再利用サブフロー] に設定されていることを確認します。
    6. [保存] をクリックします。
      ServiceNowインスタンスによってドラフト統合プロファイルが作成されます。統合プロファイルは、[ Confluence Cloud サブスクリプションのダウンロード]、[ユーザーアクティビティの更新]、 Confluence Cloud および Confluence Cloud [サブスクリプションの再利用] サブフローを使用して、アプリケーションから Confluence Cloud ユーザーデータを取得します。
    7. [接続および資格情報] フィールドの横にあるプレビューアイコン (プレビューアイコン)をクリックし、レコードプレビューで [レコードを開く] をクリックして、接続および資格情報エイリアスレコードを開きます。
    8. [接続 & 資格情報エイリアス] フォームで、[新しい接続 & 資格情報の作成] 関連リンクをクリックします。
    9. ダイアログボックスで、フィールドに入力します。
      表 : 2. [接続と資格情報を作成] ダイアログボックス
      フィールド 説明
      名前 接続の名前。
      サイト URL
      注:
      このフィールドは、バージョン 6.0.0 以前の統合を要求してインストールソフトウェア資産管理SaaS ライセンス管理した場合にのみ表示されます。
      Confluence Cloud サイトの URL。
      接続 URL
      注:
      このフィールドは、統合バージョン 7.0.0 以降を要求してインストールソフトウェア資産管理SaaS ライセンス管理した場合にのみ表示されます。
      Confluence Cloud の API URL。このフィールドは自動的に https://api.atlassian.com に設定されます。
      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 に基づいて自動的に入力されます。
    10. [OAuth トークンを作成して取得] をクリックします。
      ダイアログボックスが閉じ、自動的に [接続および資格情報エイリアス] フォームに戻ります。
    11. Confluence 製品にアクセスできるグループを指定します。
      インスタンスで ServiceNow これらのグループを指定することで、これらのグループ内のユーザーのみのデータを取得し、ライセンスを管理できます。
      1. 新しいタブで、 Atlassian 管理ポータルを開きます。
      2. サイト管理者アカウントにログインします。
      3. 移動先 サイトの設定 > 製品アクセス.
      4. [Confluence] セクションで、Confluence 製品にアクセスできるグループのリストを表示します。
        後で使用するために、この情報をメモします。
      5. インスタンスに戻り ServiceNowConfluence Cloud > Confluence グループ.
      6. Confluence グループ (Confluence Groups) フォームで、[グループを追加] 関連リンクをクリックします。
        [Confluence グループを追加 (Add Confluence Groups)] ダイアログボックスが開きます。
      7. [利用可能] リストで、Confluence 製品にアクセスできるグループを選択します。
        ヒント:
        [利用可能] リストには、Atlassian アカウントに関連付けられているすべてのグループが含まれます。Confluence 製品にアクセスできるグループのみを選択します。
      8. 右矢印ボタンをクリックして、グループを [利用可能] リストから [選択済み] リストに移動します。
      9. [OK] をクリックします。
    12. 次に移動して統合プロファイルに戻ります SaaS ライセンス > 管理 > 直接統合プロファイル をクリックし、[統合プロファイル] リストからプロファイルを選択します。
    13. [公開] をクリックします。
      [公開の確認] ダイアログボックスが開きます。
    14. ダイアログボックスで、「 OK」をクリックします。

    次のタスク

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

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

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