Jira クラウド用の Jira スポークの設定

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：11分

    • ServiceNow インスタンスと Jira クラウドインスタンスを統合し、ServiceNow からの要求を認証します。

    始める前に

    • 統合ハブ サブスクリプションの要求
    • Jira スポークの有効化
    • 必要なロール：admin

    このタスクについて

    要件に応じて、ベーシック認証または OAuth 認証を使用して Jira クラウドインスタンスの Jira スポークを設定できます。

    オプション 1：ベーシック認証の使用

    API キーを使用して ServiceNow インスタンスと Jira クラウドインスタンスを統合し、ServiceNow 要求を認証します。

    始める前に

    必要なロール：admin。

    このタスクについて

    ServiceNow インスタンスを複数の Jira インスタンスと統合できます。この統合に対して、接続および資格情報エイリアスレコードを作成し、Jira インスタンスごとに接続レコードを作成します。

    Atlassian アカウント API トークンの生成

    Atlassian アカウント API トークンを生成し、Atlassian アカウントに関連付けられたスポークの要求を認証できるようにします。

    始める前に

    Atlassian アカウントを持っていることを確認してください。

    必要なロール：Atlassian アドミニストレーター認証情報

    このタスクについて

    Atlassian アカウントから、次の手順を完了します。API トークンを生成する手順については、Atlassian Developer Portal ドキュメントを参照してください。
    注:
    この手順は、Jira Cloud サブスクリプションを使用している 場合にのみ適用されます。

    手順

    1. へのログイン Atlassian 開始 管理者としてログインします
    2. アカウントのプロフィール写真に移動し、[アカウント設定 (Account Settings)] を選択します。
      選択したプロファイル画像のドロップダウンメニューがあるアトラシアンスタートページ。強調されたアカウント設定オプション。
    3. [セキュリティ] に移動します。
    4. [API トークン] セクションで、[API トークンの作成と管理 (Create and manage API tokens)] を選択します。
    5. [API トークン]を選択します。
    6. フォームの [ラベル] フィールドに統合名を入力します。
    7. [作成] を選択します。
      [作成] ボタンが強調された [API トークンを作成] モーダル。
      API トークンが生成されます。
    8. [コピー] を選択し、後で使用するためにトークンの値を記録します。
      [コピー] ボタンが強調された新しい API トークンの確認モーダル。

    次のタスク

    API トークンを使用して、Jira または Jira サービス管理スポークのクラウド接続を構成します。

    Jira スポークの接続の設定

    Jira 接続を追加して設定し、Jira スポークで ServiceNow 要求を認証します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 プロセスの自動化 > Flow Designer.
    2. [接続] タブをクリックします。
    3. Jira 接続エイリアスを見つけて、[詳細を表示] をクリックします。
      • Jira スポークに付属するデフォルトの接続および資格情報エイリアスレコードを構成するには、[詳細を表示] をクリックします。
      • 複数の Jira スポーク接続レコードを管理するには、[接続を追加] をクリックして新しい子エイリアスレコードを作成する必要があります。複数の接続の使用の詳細については、「複数接続のサポート」を参照してください。
      スポークを初めて設定する場合は、[設定 (Configure)] をクリックします。それ以外の場合は、[編集] をクリックします。
    4. [接続] フォームのフィールドに入力します。
      フィールド 説明
      接続名 接続を一意に識別する名前。例：Jira スポーククラウドベーシック接続。
      接続 URL https://<provider-domain-name>.atlassian.net 形式の Jira インスタンスの URL。
      サーバータイプ [クラウド] を選択します。
      ユーザー名 ユーザーのメールアドレスを入力します。
      API キー Jira クラウドインスタンスに対して生成した API トークンを入力します。

      Jira Cloud の接続構成。

    5. [接続を作成] をクリックします。

    オプション 2：OAuth 認証の使用

    OAuth を使用して ServiceNow インスタンスと Jira アカウントをデータ連携し、ServiceNow 要求を認証します。

    始める前に

    必要なロール：admin。

    Jira アカウントでの OAuth 2.0 統合の作成

    Atlassian 開発者コンソールで OAuth 2.0 統合を作成して、要求を認証します。

    始める前に

    必要なロール：admin

    手順

    1. へのログイン Atlassian 開発者コンソール 管理者としてログインします
    2. [自分のアプリ] で [作成] をクリックし、[OAuth 2.0 統合 (OAuth 2.0 integration)] を選択します。
      OAuth 2.0 統合を作成する。
    3. フォームで、統合の名前を入力し、[作成] をクリックします。
      統合名を入力する。
      統合が作成され、アプリ ID の値が表示されます。
    4. [認証] をクリックします。
      1. [アクション] の下にある [追加] をクリックします。
        API にアクセスするための認証。
      2. [コールバック URL] に、https://<ServiceNow-Instance-Name>.service-now.com/oauth_redirect.do の形式で ServiceNow インスタンスの URL を入力します。
        例：https://example.service-now.com/oauth_redirect.do
        コールバック URL を追加する。
      3. [変更を保存] をクリックします。
    5. [設定] をクリックします。

      [認証の詳細] で、[クライアント ID] と [クライアントシークレット] の値をコピーします。

      [クライアント ID] と [クライアントシークレット] の値をコピーする。
    6. [権限] をクリックします。
      1. [クラシックスコープ (Classic scopes)] では、必ず以下のスコープを選択してください。
        • manage:jira-configuration
        • manage:jira-project
        • manage:jira-webhook
        • read:jira-work
        • read:jira-user
        • write:jira-work
      2. [詳細スコープ (Granular scopes)] では、必ず以下のスコープを選択してください。
        • delete:sprint:jira-software
        • read:issue-details:jira
        • read:jql:jira
        • read:sprint:jira-software
        • write:sprint:jira-software
        • read:board-scope:jira-software
        • read:project:jira
      要件に応じて他のスコープを構成できます。

    クラウド ID の値の取得

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

    始める前に

    必要なロール：admin

    手順

    1. へのログイン Atlassian 管理 管理者としてログインします
    2. 必要な組織で [選択] をクリックします。
    3. Jira ソフトウェア製品から、[製品アクセスの管理 (Manage product access)] をクリックします。
      新しいウィンドウが開き、URL が https://admin.atlassian.com/s/<Cloud-ID>/apps の形式になります。
    4. 後で使用するためにクラウド ID の値をコピーします。

    ServiceNow インスタンスでのアプリケーションレジストリの作成

    OAuth 2.0 統合の作成中に生成された情報を使用して、ServiceNow インスタンスでアプリケーションレジストリレコードを作成します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > システム OAuth > アプリケーションレジストリ.
    2. [新規] をクリックします。
      「どのような OAuth アプリケーションですか？」というメッセージが表示されます。
    3. [サードパーティ OAuth プロバイダーに接続します] を選択します。
    4. フォームに、次の値を入力します。
      フィールド 説明
      名前 アプリケーションレジストリレコードを識別する名前です。例：Jira クラウド OAuth アプリレジストリ。
      クライアント ID Atlassian 開発者コンソールで OAuth 2.0 統合を作成したときに生成されたクライアント ID。
      クライアントシークレット Atlassian 開発者コンソールで OAuth 2.0 統合を作成したときに生成されたクライアントシークレット。
      デフォルトの権限許可タイプ トークンを確立するために使用される権限許可のタイプ。[認証コード] を選択します。
      認証 URL OAuth 認証コードのエンドポイントです。「https://auth.atlassian.com/authorize」と入力します。
      トークン URL OAuth サーバートークンエンドポイントです。「https://auth.atlassian.com/oauth/token」と入力します。
      リダイレクト URL OAuth コールバックエンドポイント。アプリケーションレジストリの保存時に URL が生成されます。
      リフレッシュトークン URL トークンを更新する URL です。「https://auth.atlassian.com/oauth/token」と入力します。
      注:
      このフィールドはフォーマットのレイアウトで非表示になります。フォームレイアウトを設定してこのフィールドを表示します。
    5. [OAuth エンティティスコープ] タブで、以下のエンティティスコープレコードを作成します。
      名前 OAuth スコープ
      delete:sprint:jira-software delete:sprint:jira-software
      manage:jira-configuration manage:jira-configuration
      manage:jira-project manage:jira-project
      manage:jira-webhook manage:jira-webhook
      offline_access offline_access
      read:issue-details:jira read:issue-details:jira
      read:jira-user read:jira-user
      read:jira-work read:jira-work
      read:jql:jira read:jql:jira
      read:sprint:jira-software read:sprint:jira-software
      write:jira-work write:jira-work
      write:sprint:jira-software write:sprint:jira-software
      read:board-scope:jira-software read:board-scope:jira-software
      read:project:jira read:project:jira
    6. フォームヘッダーを右クリックし、[保存] をクリックします。
    7. [OAuth エンティティプロファイル] タブをクリックして、デフォルトのレコードを開きます。
      例：Jira OAuth プロファイル。
    8. [OAuth エンティティプロファイルスコープ] で、同じエンティティスコープが指定されていることを確認します。
      または、新しい行を挿入し、以前に [OAuth エンティティスコープ] タブで指定したものと同じエンティティスコープを選択します。
    9. フォームヘッダーを右クリックし、[保存] をクリックします。

    Jira スポークの認証情報レコートを作成

    Jira アカウント用の認証情報レコードを作成します。Jira スポーク接続および資格情報エイリアスでは、この認証情報を使用してアクションを許可します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > 接続 & 認証情報 > 認証情報.
    2. [新規] をクリックします。
      「作成する認証情報のタイプは？」というメッセージが表示されます。
    3. [OAuth 2.0 認証情報] を選択します。
    4. フォームに、これらの値を入力します。
      フィールド 説明
      名前 Jira スポークの認証情報レコードを識別する名前です。例：Jira クラウド OAuth 認証情報
      OAuth エンティティプロファイル アプリケーションレジストリレコードの構成時に作成されるデフォルトの OAuth エンティティプロファイルレコードです。
    5. [送信] をクリックします。

    JiraSpoke の接続レコードを作成します。

    Jiraアカウントの接続レコードを作成します。接続および資格情報エイリアスでは、この接続を使用して Jira でアクションを実行します。

    始める前に

    必要なロール：admin。

    手順

    1. 移動先 すべて > 接続 & 認証情報 > 接続および資格情報エイリアス.
    2. スポークに付属している Jira のエイリアスレコードを開きます。
    3. [接続] タブで、[新規] をクリックします。
      空の HTTP(s) 接続フォームが表示されます。
    4. 次の値を入力し、[送信] をクリックします。
      フィールド 必要な値
      名前 接続レコードを一意に識別する名前を入力します。たとえば、「Jira クラウド OAuth 接続」と入力します。
      認証情報 Jira 用に作成された認証情報レコードを選択します。たとえば、[Jira クラウド OAuth 認証情報] を選択します。
      接続 URL Jira インスタンスの URL を https://api.atlassian.com/ex/jira/<Cloud-ID> の形式で入力します。

      クラウド ID の値の取得については、「クラウド ID の値の取得」を参照してください。
    5. [属性] 関連リストで、次の値を入力します。
      1. [api_version] に値「2」を入力します。
      2. [server_type] に値「cloud」を入力します。
      属性値。
    6. [送信] をクリックします。
    7. 移動先 すべて > 接続 & 認証情報 > 認証情報.
    8. Jira スポーク用に作成された認証情報レコードを開きます。
      例：Jira OAuth 認証情報。
    9. [OAuth トークンの取得] 関連リンクをクリックします。
      新しいウィンドウで、Atlassian アカウントへのアクセスが要求されます。
    10. [承認] をクリックします。
      Atlassian アカウントにアクセス権が付与され、リフレッシュトークンが利用可能であることを示す確認メッセージが ServiceNow インスタンスに表示されます。