外部コンテンツのインデックス作成のための Atlassian Jira Cloud の構成

Atlassian 開発者コンソールで OAuth 2.0 統合を登録し、Atlassian Administration で API キーを作成して、Atlassian Jira Cloud 外部コンテンツコネクタが Atlassian Jira Cloud ソースシステム内のプロジェクトとセキュリティプリンシパルをクロールできるようにします。

始める前に

組織の Atlassian 管理アプリケーションには、次の認証情報と権限が必要です。

Atlassian portal	必要な認証情報と権限
Atlassian 開発者コンソール (https://developer.atlassian.com/console/myapps/)	ログイン認証情報 登録済みアプリケーションの設定を表示する権限 新しいアプリケーションを登録する権限 アプリケーションの詳細な Jira API スコープを設定する権限 アプリケーションの OAuth 2.0 コールバック URL を設定する権限
Atlassian Administration (https://admin.atlassian.com/)	ログイン認証情報 新しいアドミン API キーを作成する権限

必要なロール：admin

このタスクについて

Atlassian Jira Cloud 外部コンテンツコネクタは、Jira API を使用して Atlassian Jira Cloud ソースシステムからコンテンツを取得します。

コネクタが Jira API を介して Atlassian Jira Cloud ソースシステムにアクセスできるようにするには、Atlassian 開発者コンソールで OAuth 2.0 統合を構成し、Atlassian Administration で API キーを構成する必要があります。ServiceNow AI Platformインスタンスアドミニストレーターは、OAuth 2.0 統合からコピーした設定と API キーを使用して、Atlassian Jira Cloud ソースシステムに適切に接続できるように Atlassian Jira Cloud 外部コンテンツコネクタを構成できます。

手順

1. Atlassian Jira Cloud テナントのインスタンス ID を見つけます。
   1. https://<tenant-name>.atlassian.net/_edge/tenant_info に移動し、<tenant-name> を Atlassian Jira Cloud テナントの名前に置き換えます。

      Web エンドポイントには、テナントのクラウド ID (インスタンス ID) を示す JSON 応答が表示されます。

      

   2. cloudId JSON パラメーターの値を安全な場所に記録します。
      重要:

      ServiceNow AI Platform アドミニストレーターは、Atlassian Jira Cloud 外部コンテンツコネクタを設定するときにこのインスタンス ID 値を必要とします。
2. Atlassian 開発者コンソールで、Atlassian Jira Cloud 外部コンテンツコネクタの新しい OAuth 2.0 統合を登録します。
   1. https://developer.atlassian.com/console/myapps/ で Atlassian 開発者コンソールにログインします。
   2. [自分のアプリ] セクションで、 作成 > OAuth 2.0 統合.
      
   3. OAuth 2.0 統合の名前を入力し、 Atlassian の開発者規約に同意するオプションを選択して、 作成 を選択します。
      

      たとえば、OAuth 2.0 統合の名前として「 Jira Cloud 外部コンテンツコネクタ 」と入力します。

   4. OAuth 2.0 統合の [アクセス許可] ページに移動し、[Jira API] 行で [追加] を選択します。
      
   5. [ Jira API] 行で、[ 構成] を選択します。
      
   6. [詳細なスコープ] タブで、[ スコープの編集 ] を選択し、次の各スコープのオプションを選択します。
      • read:application-role:jira
      • read:attachment:jira
      • read:audit-log:jira
      • read:アバター:jira
      • read:comment.property:jira
      • read:comment:jira
      • read:field-configuration:jira
      • read:field:jira
      • read:group:jira
      • read:issue-details:jira
      • read:issue-meta:jira
      • read:issue-security-level:jira
      • read:issue-security-scheme:jira
      • read:issue-type-hierarchy:jira
      • read:issue-type:jira
      • read:issue.changelog:jira
      • read:issue.vote:jira
      • read:issue:jira
      • read:permission-scheme:jira
      • read:permission:jira
      • read:project-category:jira
      • read:project-role:jira
      • read:project-type:jira
      • read:project-version:jira
      • read:project.component:jira
      • read:project.feature:jira
      • read:project.property:jira
      • read:project:jira
      • read:status:jira
      • read:user.property:jira
      • read:user:jira

      
   7. [Save (保存)] を選択します。
      
   8. OAuth 2.0 統合の [認証] ページに移動し、OAuth 2.0 (3LO) 認証タイプの行で [追加 ] を選択します。
      
   9. コールバック URL として 「https://<instance-name>.service-now.com/oauth_redirect.do 」と入力し、 <instance-name> を ServiceNow AI Platform® インスタンス名に置き換えて、[ 変更を保存] を選択します。
      
   10. OAuth 2.0 統合の [設定] ページに移動し、クライアント ID とシークレットの値を安全な場所に記録します。
       

       重要:

       ServiceNow AI Platformアドミンは、Atlassian Jira Cloud 外部コンテンツコネクタを設定するときに、これらのクライアント ID とシークレットの値を必要とします。
3. Atlassian Administration、新しいアドミン API キーを作成します。
   1. https://admin.atlassian.com/でAtlassian Administrationにログインします。
   2. タブリストの [設定 ] を選択します。
      
   3. [API キー] を選択し、[API キーの作成] を選択します。
      
   4. [開始する前に] ページで、 [スコープのない API キー] を選択し、 [次へ] を選択します。
      
   5. 新しい API キーの名前と有効期限を入力します。
      

      たとえば、API キーの名前として 「Jira Cloud 外部コンテンツコネクタ 」と入力し、その有効期限を 1 年後に設定します。

   6. [Create (作成)] を選択します。
   7. 安全な場所に API キーの値を記録します。
      

      重要:

      Atlassian Jira Cloud 外部コンテンツコネクタを設定する場合、ServiceNow AI Platformアドミンは API キーの値が必要です。
   8. [Done (完了)] を選択します。
4. Atlassian Jira Cloud 外部コンテンツコネクタによるアクセスを許可するように、Atlassian Jira Cloud テナントでテクニカルユーザーを構成します。
   この手順の詳細については、「Atlassian Jira Cloud でのコネクタユーザーの構成」を参照してください。

次のタスク

ServiceNow AI Platformアドミンに次のアイテムを提供します。

• ステップ 1.b で記録したインスタンス ID (クラウド ID) の値。
• ステップ 2.j で記録した OAuth 2.0 統合のクライアント ID とシークレットの値。
• ステップ 3.g で記録した API キーの値。
• ステップ 4 で作成した Atlassian Jira Cloud ユーザーの認証情報。

ServiceNow AI Platform アドミンは、Atlassian Jira クラウドインスタンスからプロジェクトとセキュリティプリンシパルを取得するように Atlassian Jira Cloud 外部コンテンツコネクタを構成するために、これらのアイテムを必要としています。

Atlassian Jira Cloud 外部コンテンツコネクタの作成と構成の詳細については、「Atlassian Jira Cloud 外部コンテンツコネクタの作成」を参照してください。