Skip to main content

​
Jira について

Jira ソースは、Jira Cloud から プロジェクト構成、課題のメタデータ、ワークフロー定義、ユーザーと担当者の情報、Jira Service Management のリクエストデータを Iru Compliance に取り込み、アクションやコントロールに関連付けられるエビデンスにします。Iru は Atlassian の 3-legged OAuth 2.0（3LO） 認可コードフローを通じて接続します。この連携は 読み取り専用 です。Iru が課題、プロジェクト、ワークスペースの設定を作成または変更することはありません。 このコネクタは Jira Cloud 専用です。Jira Data Center（セルフホスト）は異なる認証モデルを使用するため、このソースでは サポートされていません。

​
仕組み

Cloud ID を入力すると、コネクタウィザードによって Atlassian に移動し、サインインして同意します。Iru は有効期間の短い アクセストークン と ローテーションするリフレッシュトークン を受け取り、同期サイクルごとにトークンを自動的に更新します。 ドキュメントハブ: Atlassian サポート - Jira。OAuth: Jira Cloud OAuth 2.0 (3LO)、OAuth 2.0 スコープ。Cloud ID: Atlassian Cloud ID の取得。

​
前提条件

  • 有料 の Jira Cloud サイト（Free は、ここで必要な OAuth API アクセスをサポートしていません）。
  • Jira Cloud ID（UUID）。以下の Jira Cloud ID を確認する を参照してください。
  • OAuth ステップを開けるよう、Iru ドメインに対してブラウザの ポップアップ が許可されていること。
  • サインインするユーザーは Jira 管理者である 必要はありません が、Iru はそのユーザーがアクセスできるデータのみを読み取れます。幅広いエビデンスを収集するには、少なくとも次の権限を持つアカウントを使用してください:
    • Iru に読み取らせるすべてのプロジェクトに対する Browse projects。
    • ユーザーと担当者のメタデータが必要な場合は Browse users and groups（グローバル権限）。
適切なプロジェクト全体に読み取りアクセス権を持つ 専用のサービスアカウント を使用すると、多くの場合、対象範囲を安定させやすくなります。

​
Jira を Iru に接続する

Compliance でソースを接続する前に、このタブの手順を完了してください。

​
Jira Cloud ID を確認する

Cloud ID は、Iru が https://api.atlassian.com/ex/jira/{cloudId} で使用する UUID です。
1

Jira Cloud と有料アクセスを確認する

このコネクタは、Iru に必要な OAuth API アクセスを許可する 有料 プランの Jira Cloud をサポートしています。連携がブロックされる Free サイトでないことを確認してください。
2

Jira サイトを開く

ブラウザで Jira Cloud の URL（例: https://yoursite.atlassian.net）を開き、以下の手順で置き換える サブドメイン を確認します。
3

Cloud ID の確認方法を選択する

JSON で素早く確認する場合は オプション A を、すでに Atlassian Admin を使用している場合は オプション B を使用します。
4

オプション A: テナント情報（最速）

新しいブラウザタブで次の URL を開きます（yoursite を Jira のサブドメインに置き換えます）:https://yoursite.atlassian.net/_edge/tenant_infoJSON レスポンスから cloudId の値をコピーします。
5

オプション B: Atlassian Admin

admin.atlassian.com にサインインして組織を選択し、ブラウザの URL で Cloud ID を確認します（/s/ の後に表示されます）。
6

Iru 用に Cloud ID を保存する

Iru Compliance タブで Iru コネクタウィザードの cloudId フィールドに貼り付けるまで、UUID を安全な場所に保管します。
Iru Compliance タブに進んでください。

​
トラブルシューティング

Iru サイトの ポップアップブロッカー の設定を確認して、もう一度 Launch OAuth Authentication をお試しください。
ウィザードのリンクの有効期限が切れている可能性があります。ソース で Jira をオフにしてから再度オンにし、Cloud ID をもう一度入力してください。
OAuth を完了したアカウントに、一部のスペースに対する Browse projects がない可能性があります。Jira の権限を調整するか、必要な読み取り範囲を持つ サービスアカウント で接続してください。
Jira Cloud は、有効期間が 90 日 の ローテーションするリフレッシュトークン を使用します。接続がそれ以上アイドル状態になった場合は、Jira ソースカードから OAuth フローを再度完了してください。
Free ティアは、このコネクタに必要な OAuth API アクセスをサポートしていません。接続するには 有料 の Jira Cloud プランを使用してください。
Cloud ID が対象のサイトと一致していることを確認してください（Jira Cloud ID を確認する を参照）。一致しない場合、Iru は誤ったテナントを参照します。

​
考慮事項

リフレッシュトークンとアイドル状態の接続

Iru は同期サイクルごとにアクセストークンを更新します。同期が 90 日間 実行されない場合は、ソースカードから 再認証 する必要があります。

大規模なプロジェクトと保持

大規模なプロジェクトでは大量の履歴が生成されます。可能な範囲でプロジェクトの対象範囲を絞り、監査でワークフローのエビデンスに依存する前に、保持 と プライバシー のポリシーを整合させてください。

​
関連記事

Sources の管理

すべての Compliance ソースを参照、管理します。

Compliance を使い始める

フレームワーク、アクション、アーティファクト。

Iru の概要

Endpoint、Compliance、Identity がどのように連携するか。

Artifacts の管理

ソースやアクションから得たエビデンスをアップロード、確認、整理します。