Jira クラウド用の Jira スポークの設定
ServiceNow インスタンスと Jira クラウドインスタンスを統合し、ServiceNow からの要求を認証します。
始める前に
- 統合ハブ サブスクリプションを要求します。
- Jira スポークを有効化します。
- 必要なロール：admin
このタスクについて
要件に応じて、ベーシック認証または OAuth 認証を使用して Jira クラウドインスタンスの Jira スポークを設定できます。
オプション 1:OAuth 認証の使用 (認証コード権限許可タイプ)
OAuth を使用して ServiceNow インスタンスと Jira アカウントをデータ連携し、ServiceNow 要求を認証します。
始める前に
必要なロール：admin
クラウド ID の値の取得
Jira クラウドインスタンスのクラウド ID の値を取得します。この値は、ServiceNow インスタンスの接続レコードを構成するときに必要です。
始める前に
必要なロール：アドミン
手順
Jira スポークの接続の設定
Jira 接続を追加して設定し、Jira スポークで ServiceNow 要求を認証します。
始める前に
必要なロール：アドミン
手順
-
[接続] フォームのフィールドに入力します。
フィールド 説明 接続名 接続を一意に識別する名前。例: Jira スポーク OAuth 基本接続。 接続 URL Jira インスタンスの URL の形式は https://api.atlassian.com/ex/jira/{cloud-id}/ です。{cloud-id} を以前に取得したクラウド ID の値に置き換えます。 スコープ デフォルトでは、これらのスコープは read:jira-work、read:jira-user、write:jira-work、manage:jira-project、manage:jira-configuration、manage:jira-webhook、manage:jira-data-provider、delete:sprint:jira-software、read:sprint:jira-software、write:sprint:jira-software、read:board-scope:jira-software、read:project:jira、read:jql:jira、read:issue-details:jira、read:me、read:account、offline_access です。要件に応じてスコープを変更できます。
オプション 2:OAuth 認証の使用 (クライアント認証情報権限許可タイプ)
OAuth を使用して ServiceNow インスタンスと Jira アカウントをデータ連携し、ServiceNow 要求を認証します。
始める前に
- Jira Cloud インスタンスで、 サービスアカウントの OAuth 2.0 認証情報を作成します。
[ クライアント ID]、[ クライアントシークレット]、および [クラウド ID] の値を保存します。これらは、ServiceNow インスタンスでの構成に必要になります。
- 必要なロール：admin
アプリケーションレジストリレコードの作成
始める前に
必要なロール：アドミン
手順
Jira スポークの認証情報レコードの作成
Jiraアカウント用の認証情報レコードを作成します。Jira スポーク接続および資格情報エイリアスでは、この認証情報を使用してアクションを許可します。
始める前に
必要なロール：アドミン
手順
Jira スポークの接続レコードの作成
Jira アカウントの接続レコードを作成します。接続および資格情報エイリアスでは、この接続を使用して Jira でアクションを実行します。
始める前に
必要なロール：アドミン
手順
オプション 3:ベーシック認証 および API トークンを使用する
API キーを使用して ServiceNow インスタンスと Jira クラウドインスタンスを統合し、ServiceNow 要求を認証します。
始める前に
重要:
必要なロール：adminAPI トークンを収集して個々の 3LO アプリを作成するアプリは、クラウド アプリの Atlassian セキュリティ要件に準拠しておらず、使用ポリシー Atlassian 受け入れられます。
このタスクについて
Atlassian アカウント API トークンの生成
Atlassian アカウント API トークンを生成し、Atlassian アカウントに関連付けられたスポークの要求を認証できるようにします。
始める前に
Atlassian アカウントを持っていることを確認してください。
必要なロール：Atlassian アドミニストレーター認証情報
このタスクについて
注:
この手順は、Jira Cloud サブスクリプションを使用している 場合にのみ適用されます。
手順
-
アカウントのプロフィール写真に移動し、[アカウント設定 (Account Settings)] を選択します。
-
[作成] を選択します。
API トークンが生成されます。
-
[コピー] を選択し、後で使用するためにトークンの値を記録します。
次のタスク
Jira スポークの認証情報レコードの作成
Jiraアカウント用の認証情報レコードを作成します。Jira スポーク接続および資格情報エイリアスでは、この認証情報を使用してアクションを許可します。
始める前に
必要なロール：アドミン
手順
Jira スポークの接続レコードの作成
Jira アカウントの接続レコードを作成します。接続および資格情報エイリアスでは、この接続を使用して Jira でアクションを実行します。
始める前に
必要なロール：アドミン
手順
オプション 4:API トークンとスコープでベーシック認証を使用する
スコープ付きの API キーを使用して ServiceNow インスタンスと Jira クラウドインスタンスを統合し、 ServiceNow 要求を認証します。
始める前に
重要:
必要なロール：adminAPI トークンを収集して個々の 3LO アプリを作成するアプリは、クラウド アプリの Atlassian セキュリティ要件に準拠しておらず、使用ポリシー Atlassian 受け入れられます。
このタスクについて
スコープを指定して Atlassian アカウント API トークンを生成する
Atlassianアカウントに関連付けられたスポークの要求を認証するために必要なスコープを持つ Atlassian アカウント API トークンを生成します。
始める前に
Atlassian アカウントを持っていることを確認してください。
必要なロール：Atlassian アドミニストレーター認証情報
このタスクについて
注:
この手順は、Jira Cloud サブスクリプションを使用している場合にのみ適用されます。
手順
-
アカウントのプロフィール写真に移動し、[アカウント設定 (Account Settings)] を選択します。
-
[ スコープを指定して API トークンを作成] をクリックします。
-
[名前 API トークン] フォームで「 名前」と入力し、トークンの有効期限を選択して、[ 次へ] をクリックします。
-
[アプリの選択] フォームで [Jira ] を選択し、[ 次へ] をクリックします。
-
[Jira スコープの選択] フォームで、必要なスコープを選択し、[ 次へ] をクリックします。
必要なスポークアクションを使用するために必要なスコープの詳細については、「 必要な API トークンスコープ」を参照してください。
-
API トークンスコープを確認し、[ トークンを作成] をクリックします。
API トークンが生成され、表示されます。後で使用するためにトークン値をコピーして記録します。
Jira スポークの認証情報レコードの作成
Jiraアカウント用の認証情報レコードを作成します。Jira スポーク接続および資格情報エイリアスでは、この認証情報を使用してアクションを許可します。
始める前に
必要なロール：アドミン
手順
Jira スポークの接続レコードの作成
Jira アカウントの接続レコードを作成します。接続および資格情報エイリアスでは、この接続を使用して Jira でアクションを実行します。
始める前に
必要なロール：アドミン
手順
必要な API トークンスコープ
必要なスポークアクションを使用するために必要な API トークンスコープがここにリストされます。
これらのスコープは、スコープ付きの API トークンを使用して Jira Cloud の Jira スポークを設定するときに必要です。詳細については、「オプション 4:API トークンとスコープでベーシック認証を使用する」を参照してください。
| カテゴリ | アクション | 説明 | 必要なスコープ (クラシック) | スコープが必要 (詳細) |
|---|---|---|---|---|
| 監査管理 | 監査ログストリームを検索 | Atlassian Jira ユーザーサブスクリプションのログインアクティビティを取得します。 注: このアクションは、 Jira Server 9 以前のバージョンと Jira Cloud でサポートされています。 |
manage:jira-configuration | read:audit-log:jira、read:user:jira |
| 監査ログストリームを検索 (Server 10+) | 指定された日付範囲内の監査ログレコードを Jira インスタンスから取得します。 注: このアクションは、 Jira Server 9 以降のバージョンでサポートされています。 |
このアクションは、Jira Server でのみサポートされています。 | ||
| グループ管理 | グループにユーザーを追加 | Jiraのグループに指定されたユーザーを追加します。 | manage:jira-configuration | write:group:jira, read:avatar:jira, read:group:jira, read:user:jira |
| グループの作成 | Jiraにグループを作成します。 | manage:jira-configuration | read:group:jira、read:user:jira、write:group:jira、read:avatar:jira | |
| グループストリームを検索 | デフォルトグループを含む、Atlassian アカウント内のすべてのグループを取得します。 注: このアクションは、Jira Cloud サブスクリプションでのみ使用できます。 |
read:jira-user | read:group:jira | |
| グループ名ストリームでユーザーを検索 | Atlassian グループ内のすべてのメンバーの詳細を取得します。 | manage:jira-configuration | read:group:jira、read:user:jira、read:avatar:jira | |
| グループを削除 | 指定されたグループをJiraから削除します。 | manage:jira-configuration | delete:group:jira | |
| グループからユーザーを削除 | Jiraのグループから指定されたユーザーを削除します。 | manage:jira-configuration | write:group:jira | |
| 問題管理 | コメントを追加 | Jiraで指定した問題にコメントを追加します。 | write:jira-work | read:comment:jira, read:comment.property:jira, read:group:jira, read:project:jira, read:project-role:jira, read:user:jira, write:comment:jira, read:avatar:jira |
| ウォッチャーを追加 | 指定された問題のウォッチャーとして、指定されたユーザーを追加します。 | write:jira-work | write:issue.watcher:jira | |
| 問題を割り当て | Jiraの問題をユーザーに割り当てます。 | write:jira-work | write:issue:jira | |
| 添付ファイルをコピー | ServiceNow レコードに関連付けられている必要な添付ファイルを、Jira の必要な問題にコピーします。 | write:jira-work | read:user:jira, write:attachment:jira, read:attachment:jira, read:avatar:jira | |
| 問題を作成 | Jiraに問題を作成します。組織がJiraをどのように使用しているかに応じて、ソフトウェアのバグ、プロジェクトタスク、ヘルプデスクチケットなど、様々な形で問題が現れます。Jiraの問題は、Now Platformのタスクを表します。 | write:jira-work、read:jira-work | write:issue:jira, write:comment:jira, write:comment.property:jira, write:attachment:jira, read:issue:jira | |
| 添付ファイルを削除 | Jiraの必要な添付ファイルを削除します。 | write:jira-work | delete:attachment:jira | |
| 問題の削除 | Jiraの問題を削除します。 | write:jira-work | delete:issue:jira | |
| 監視を削除 | 指定された問題のウォッチャーとして、ユーザーを削除します。 | write:jira-work | write:issue.watcher:jira | |
| 移行を実行 | Jiraの問題をある状態から別の状態に移行します。 | write:jira-work | write:issue:jira, write:issue.property:jira | |
| プロジェクトで問題タイプステータスを検索 (Look up Issue Type Statuses by Project) | プロジェクトのステータスの詳細を取得します。 | read:jira-work | read:issue-status:jira, read:issue-type:jira, read:status:jira | |
| 問題を検索 | 問題の詳細を取得します。 | read:jira-work | read:issue-meta:jira, read:issue-security-level:jira, read:issue.vote:jira, read:issue.changelog:jira, read:avatar:jira, read:issue:jira, read:status:jira, read:user:jira, read:field-configuration:jira | |
| 問題の優先度を検索 | 問題の優先度のリストと個々の問題の優先度の詳細を取得します。 | write:jira-work、read:jira-work | read:priority:jira | |
| 課題ストリームを検索 | JQL クエリ文字列に一致する問題のリストを取得します。 | read:jira-work | read:issue-details:jira, read:audit-log:jira, read:avatar:jira, read:field-configuration:jira, read:issue-meta:jira | |
| Sprint 問題ストリームを検索 | 指定されたスプリントのすべての問題の詳細を取得します。 | 利用可能なクラシックスコープはありません。 | read:sprint:jira-software , read:issue-details:jira, read:jql:jira | |
| 移行を検索 | 指定された問題 ID のすべての移行に関する情報を取得します。 | read:jira-work | read:issue.transition:jira、read:status:jira、read:field-configuration:jira | |
| ウォッチャーを検索 | 指定された問題のウォッチャーのリストを取得します。 | read:jira-work | read:issue.watcher:jira、read:user:jira、read:avatar:jira | |
| 問題を更新 | 入力として渡された値でJiraの問題の一連のフィールドを更新します。 | write:jira-work、read:jira-work | write:issue:jira | |
| メタデータの取得 | 作成可能なフィールド (メタデータ) を取得 (Get Creatable Fields (Metadata)) | 必要な Jira プロジェクトのすべてのフィールドのリストを取得します。 | write:jira-work、read:jira-work | read:issue-meta:jira、read:avatar:jira、read:field-configuration:jira |
| 編集可能なフィールド (メタデータ) を取得 (Get Editable Fields (Metadata)) | 必要なJira問題のすべての編集可能なフィールドのリストを取得します。 | write:jira-work、read:jira-work | read:issue-meta:jira、read:field-configuration:jira | |
| 問題タイプ (メタデータ) を取得 (Get Issue Types (Metadata)) | 必要なJiraプロジェクト内のすべての問題タイプのリストを取得します。 | write:jira-work、read:jira-work | read:issue-meta:jira、read:avatar:jira、read:field-configuration:jira | |
| プロジェクト管理 | プロジェクト作成 | Jira でプロジェクトを作成します。 | manage:jira-configuration | write:project:jira、read:project:jira |
| プロジェクトを検索 | ID またはキーで指定されたプロジェクトの詳細を取得します。 | write:jira-work、read:jira-work | read:issue-type:jira, read:project:jira, read:project.property:jira, read:user:jira, read:application-role:jira, read:avatar:jira, read:group:jira, read:issue-type-hierarchy:jira, read:project-category:jira, read:project-version:jira, read:project.component:jira | |
| プロジェクトを検索 | すべてのプロジェクトの詳細を取得します。 注: このアクションは Jira サーバーでのみ機能します。 |
このアクションは、Jira Server でのみサポートされています。 | ||
| プロジェクトストリームを検索 | すべてのプロジェクトの詳細を取得します。 注: このアクションは Jira クラウドでのみ機能します。 |
read:jira-work | read:issue-type:jira, read:project:jira, read:project.property:jira, read:user:jira, read:application-role:jira, read:avatar:jira, read:group:jira, read:issue-type-hierarchy:jira, read:project-category:jira, read:project-version:jira, read:project.component:jira | |
| プロジェクトにアサイン可能なユーザーを検索 | 1 つ以上のプロジェクトの問題にアサインできるユーザーのリストを取得します。 | read:jira-user | read:project:jira、read:user:jira、read:application-role:jira、read:avatar:jira、read:group:jira | |
| スプリント管理 | スプリントを作成 | Jiraにスプリントを作成します。 | 使用可能なクラシックスコープはありません。 | read:board-scope:jira-software , read:project:jira スプリントの作成 - write:sprint:jira-software |
| スプリントを削除 | Jiraのスプリントを削除します。 | 使用可能なクラシックスコープはありません。 | delete:sprint:jira-software | |
| スプリントを検索 (Look up Sprint) | 必要なスプリントの詳細を複合オブジェクトとして取得します。 | 使用可能なクラシックスコープはありません。 | read:sprint:jira-software | |
| ボードでスプリントを検索 | 必要なボードのすべてのスプリントの詳細を取得します。 | 使用可能なクラシックスコープはありません。 | read:sprint:jira-software | |
| スプリントを更新 | Jiraのスプリントの詳細を更新します。 | 使用可能なクラシックスコープはありません。 | write:sprint:jira-software | |
| ストーリー管理 | ストーリーの作成 | Jira Cloud インスタンスでストーリーを作成します。これは、ServiceNow Agile Development プラグインのストーリーに相当します。 | write:jira-work | write:issue:jira, write:comment:jira, write:comment.property:jira, write:attachment:jira, read:issue:jira |
| ストーリーストリームを検索 | すべてのストーリーの詳細を取得します。 | read:jira-work | read:issue-details:jira, read:field.default-value:jira, read:field.option:jira, read:field:jira, read:group:jira | |
| ストーリーを更新 | 提供された入力値で Jira Cloud におけるストーリーの一定数のフィールドを更新します。 | write:jira-work | write:issue:jira | |
| ユーザー管理 | ユーザーの作成 | Jira にユーザーを作成します。 注: OAuth 2.0 認証を使用する場合、このアクションはサポートされません。 |
このアクションでは、スコープ付き API トークンはサポートされていません。 | |
| 認証ユーザーを検索 | 認証されたユーザーアカウントの詳細を取得します。 | read:jira-user | read:application-role:jira, read:group:jira, read:user:jira, read:avatar:jira | |
| ユーザーのグループメンバーシップを検索 | Atlassian ユーザーのすべてのグループの詳細を取得します。 | read:jira-user | read:group:jira | |
| ユーザーストリームを検索 | すべての Atlassian Jira ユーザーサブスクリプションの詳細を取得します。 注: このアクションは、Jira クラウドサブスクリプションでのみ使用できます。 |
read:jira-user | read:user:jira、read:application-role:jira、read:avatar:jira、read:group:jira | |
| 名前でユーザーストリームを検索 | 検索文字列に一致するユーザーのリストを取得します。 注: このアクションは、Jira サーバーサブスクリプションでのみ使用できます。 |
このアクションは、Jira Server でのみサポートされています。 | ||
| ユーザーを削除 | Jiraからユーザーを削除します。 注: OAuth 2.0 認証を使用する場合、このアクションはサポートされません。 |
このアクションでは、スコープ付き API トークンはサポートされていません。 | ||
| ユーティリティアクション | 問題の添付ファイルをレコードにコピー | 添付ファイルをJiraからServiceNowインスタンスの任意のレコードにコピーします。サブフローでこのアクションを使用する場合は、[添付ファイル URL] フィールドに [コンテンツ URL] データピルが指定されていることを確認してください。 | このアクションでは Jira エンドポイントが使用されていないため、該当するスコープはありません。 | |
| フィールドを検索 | Jiraの必須フィールドラベルの内部名とその他の詳細を取得します。 | read:jira-work | read:field:jira, read:avatar:jira, read:project-category:jira, read:project:jira, read:field-configuration:jira | |
| コメントから問題を検索 | 指定されたコメントのペイロードを解析して、問題の詳細を取得します。このアクションは、Jira 問題に関する詳細なしでコメント関連情報のみが指定されている場合に、Jira オンプレミスサーバーの [Jira Webhook の処理] サブフローで使用できます。たとえば、コメント情報のみが指定されている場合、このアクションはペイロードを解析し、問題の詳細を抽出します。 | このアクションでは Jira エンドポイントが使用されていないため、該当するスコープはありません。 | ||
| 問題に関する最新の添付ファイルを検索 | 指定された問題の最新の添付ファイルを Jira から取得します。このアクションは、検証のためにフローまたはサブフローで使用できます。たとえば、サブフローは、Jira の問題の最新の添付ファイルが指定された添付ファイルと同じではない場合にのみ、追加の添付ファイルを追加します。 | read:jira-work | read:issue-meta:jira, read:issue-security-level:jira, read:issue.vote:jira, read:issue.changelog:jira, read:avatar:jira, read:issue:jira, read:status:jira, read:user:jira, read:field-configuration:jira | |
| 問題に関する最新のコメントを検索 | 指定された問題の最新のコメントを Jira から取得します。このアクションは、検証のためにフローまたはサブフローで使用できます。たとえば、Jira の問題に関する最新のコメントが、指定されたコメントと同じではない場合のみ、サブフローでさらにコメントが追加されます。 | read:jira-work | read:comment:jira, read:comment.property:jira, read:group:jira, read:project:jira, read:project-role:jira, read:user:jira, read:avatar:jira | |
| サーバーを検索 | 現在の Jira インスタンスに関する一般情報を取得します。 | 任意のスコープ | 任意のスコープ | |
| Webhook 管理 | Webhook を検索 | 登録されているすべての Webhook の詳細をJiraインスタンスから取得します。 | このアクションでは、スコープ付き API トークンはサポートされていません。 | |
| Webhook を登録 | Webhook をJiraインスタンスに登録します。 | このアクションでは、スコープ付き API トークンはサポートされていません。 | ||
| Webhook を登録解除 | Jira インスタンスに登録されている Webhook を削除します。 | このアクションでは、スコープ付き API トークンはサポートされていません。 | ||
| Webhook を更新 | Jira 内の指定された ID の Webhook を更新します。 注: OAuth 2.0 認証を使用する場合、このアクションはサポートされません。 |
このアクションでは、スコープ付き API トークンはサポートされていません。 | ||