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

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む11読むのに数分

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

    始める前に

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

    このタスクについて

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

    オプション 1：基本認証の使用

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

    始める前に

    必要なロール：admin

    このタスクについて

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

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

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

    始める前に

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

    必要なロール：Atlassian 管理者資格情報

    このタスクについて

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

    手順

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

    次のタスク

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

    Jira スポークの接続の設定

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

    始める前に

    必要なロール：管理者

    手順

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

    次のタスク

    接続レコードで正しいサーバータイプを選択していることを確認します。
    1. 移動先 統合ハブ > 接続 & 資格情報エイリアス.
    2. Jira レコードを開きます。
    3. [接続] タブで、アクティブな接続レコードを開きます。
    4. [属性] タブで、[server_type] の値が [サーバー] に設定されていることを確認します。属性値。

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

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

    始める前に

    必要なロール：admin

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

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

    始める前に

    必要なロール：管理者

    手順

    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
      要件に応じて他のスコープを構成できます。

    クラウド ID の値の取得

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

    始める前に

    必要なロール：管理者

    手順

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

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

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

    始める前に

    必要なロール：管理者

    手順

    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
    6. フォームヘッダーを右クリックし、[保存] をクリックします。
    7. [OAuth エンティティプロファイル] タブをクリックして、デフォルトのレコードを開きます。
      例：Jira OAuth プロファイル。
    8. [OAuth エンティティプロファイルスコープ] で、同じエンティティスコープが指定されていることを確認します。
      それ以外の場合は、新しい行を挿入し、以前に [OAuth エンティティスコープ ] タブで指定したものと同じエンティティスコープを選択します。
    9. フォームヘッダーを右クリックし、 [保存] をクリックします。

    Jira スポークの資格情報レコートを作成

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

    始める前に

    必要なロール：管理者

    手順

    1. 移動先 すべて > 接続 & 認証情報 > 資格情報.
    2. [新規] をクリックします。
      「作成する資格情報のタイプは？」というメッセージが表示されます。
    3. [OAuth 2.0 資格情報] を選択します。
    4. フォームに、これらの値を入力します。
      フィールド 説明
      名前 Jira スポークの資格情報レコードを識別する名前です。例: Jira Cloud 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. [Submit (送信)] をクリックします。
    7. 移動先 すべて > 接続 & 認証情報 > 資格情報.
    8. Jira スポーク用に作成された資格情報レコードを開きます。
      例：Jira OAuth 資格情報。
    9. [OAuth トークンの取得] 関連リンクをクリックします。
      新しいウィンドウで、Atlassian アカウントへのアクセスが要求されます。
    10. [承認] をクリックします。
      Atlassian アカウントにアクセス権が付与され、リフレッシュトークンが利用可能であることを示す確認メッセージが ServiceNow インスタンスに表示されます。