Jira クラウド用の Jira スポークの設定
ServiceNow インスタンスと Jira クラウドインスタンスを統合し、ServiceNow からの要求を認証します。
始める前に
- 統合ハブサブスクリプションを要求します。
- Jira スポークを有効化します。
- 必要なロール:admin。
このタスクについて
要件に応じて、ベーシック認証または OAuth 認証を使用して Jira クラウドインスタンスの Jira スポークを設定できます。
オプション 1:ベーシック認証の使用 (API トークン)
API キーを使用して ServiceNow インスタンスと Jira クラウドインスタンスを統合し、ServiceNow 要求を認証します。
始める前に
必要なロール:admin。
このタスクについて
Atlassian アカウント API トークンの生成
Atlassian アカウント API トークンを生成し、Atlassian アカウントに関連付けられたスポークの要求を認証できるようにします。
始める前に
Atlassian アカウントを持っていることを確認してください。
必要なロール:Atlassian アドミニストレーター認証情報
このタスクについて
手順
次のタスク
Jira スポークの接続の設定
Jira 接続を追加して設定し、Jira スポークで ServiceNow 要求を認証します。
始める前に
必要なロール:admin
手順
オプション 2:ベーシック認証 (スコープ付きの API トークン) を使用する
ServiceNow 要求を認証するスコープを持つ API キーを使用して、ServiceNow インスタンスと Jira クラウドインスタンスを統合します。
始める前に
必要なロール:admin
このタスクについて
スコープを指定して Atlassian アカウント API トークンを生成する
Atlassian アカウントに関連付けられたスポークの要求を認証するために必要なスコープを持つ Atlassian アカウント API トークンを生成します。
始める前に
Atlassian アカウントを持っていることを確認してください。
必要なロール:Atlassian アドミニストレーター認証情報
このタスクについて
手順
Jira スポークの接続の設定
Jira 接続を追加して設定し、Jira スポークで ServiceNow 要求を認証します。
始める前に
必要なロール:admin
手順
必要な API トークンスコープ
必要なスポークアクションを使用するために必要な API トークンスコープがここにリストされます。
これらのスコープは、スコープを指定して API トークンを使用して Jira Cloud の Jira スポークを設定する場合に必要です。詳細については、「オプション 2:ベーシック認証 (スコープ付きの API トークン) を使用する」を参照してください。
| カテゴリ | アクション | 説明 | 必要なスコープ (クラシック) | 必要なスコープ (詳細) |
|---|---|---|---|---|
| 監査管理 | 監査ログストリームを検索 | Atlassian Jira ユーザーサブスクリプションのログインアクティビティを取得します。 注: このアクションは、 Jira Server 9 以前のバージョンと Jira Cloud でサポートされています。 |
manage:jira-configuration | read:audit-log:jira、read:user:jira |
| 監査ログストリームを検索 (Server 10 以降) | 指定された日付範囲内の監査ログレコードを Jira インスタンスから取得します。 注: このアクションは Jira サーバー 9 以降のバージョンでサポートされています。 |
このアクションは、Jira サーバーでのみサポートされています。 | ||
| グループ管理 | グループにユーザーを追加 | Jiraのグループに指定されたユーザーを追加します。 | manage:jira-configuration | 書き込み:グループ:jira、読み取り:アバター:jira、読み取り:グループ:jira、読み取り:ユーザー: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の問題は、ServiceNow AI 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 | |
| スプリント課題ストリームを検索 | 指定されたスプリントのすべての問題の詳細を取得します。 | 利用可能なクラシックスコープはありません。 | 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 |
| 編集可能なフィールド (メタデータ) を取得 | 必要なJira問題のすべての編集可能なフィールドのリストを取得します。 | write:jira-work, read:jira-work | read:issue-meta:jira, read:field-configuration:jira | |
| 課題タイプ (メタデータ) を取得 | 必要なJiraプロジェクト内のすべての問題タイプのリストを取得します。 | write:jira-work, read:jira-work | read:issue-meta:jira, read:avatar:jira, read:field-configuration:jira | |
| プロジェクト管理 (PM) | プロジェクト作成 | Jira でプロジェクトを作成します。 | manage:jira-configuration | 書き込み:project:jira、読み取り: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 サーバーでのみサポートされています。 | ||
| プロジェクトストリームを検索 | すべてのプロジェクトの詳細を取得します。 注: このアクションは 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 | |
| スプリントを検索 | 必要なスプリントの詳細を複合オブジェクトとして取得します。 | 利用可能なクラシックスコープはありません。 | 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 サーバーでのみサポートされています。 | ||
| ユーザーを削除 | 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 トークンはサポートされていません。 | ||
オプション 3:OAuth 認証の使用
OAuth を使用して ServiceNow インスタンスと Jira アカウントをデータ連携し、ServiceNow 要求を認証します。
始める前に
必要なロール:admin。
Jira アカウントでの OAuth 2.0 統合の作成
Atlassian 開発者コンソールで OAuth 2.0 統合を作成して、要求を認証します。
始める前に
必要なロール:admin
手順
クラウド ID の値の取得
Jira クラウドインスタンスのクラウド ID の値を取得します。この値は、ServiceNow インスタンスの接続レコードを構成するときに必要です。
始める前に
必要なロール:admin
手順
ServiceNow インスタンスでのアプリケーションレジストリの作成
OAuth 2.0 統合の作成中に生成された情報を使用して、ServiceNow インスタンスでアプリケーションレジストリレコードを作成します。
始める前に
必要なロール:admin
手順
Jira スポークの認証情報レコートを作成
Jira アカウント用の認証情報レコードを作成します。Jira スポーク接続および資格情報エイリアスでは、この認証情報を使用してアクションを許可します。
始める前に
必要なロール:admin
手順
JiraSpoke の接続レコードを作成します。
Jiraアカウントの接続レコードを作成します。接続および資格情報エイリアスでは、この接続を使用して Jira でアクションを実行します。
始める前に
必要なロール:admin。