Jira の認証

前提条件

選択した認証の種類に応じて、次のいずれかの資格情報が必要です。

• OAuth 2.0 Authorization code: Site URL、Scope、Atlassian のメール アドレスとパスワード。
• 独自の OAuth 2.0 アプリ (クライアント ID、クライアント シークレット、サイト URL、スコープ) を使用します。
• 基本: サイト URL、ユーザー名、API トークン。

OAuth 2.0 の認可コード

次の資格情報が必要です。

• サイト URL – Jira サイトの URL です (例: https://your-domain.atlassian.net)。Jira にアクセスするための権限を UiPath アプリに付与するよう求められたら、必ず同じ Jira サイトを選択してください。
• スコープ – この接続をリクエストするスコープを選択します。クライアントが使用を許可されているスコープのみを含めます。選択したスコープは、既定のスコープに自動的に追加されます。
• メール アドレスとパスワード – サイト URL とスコープを指定したら、メール アドレスとパスワードを使用して Atlassian アカウントにログインする必要があります。

独自の OAuth 2.0 アプリ (BYOA) を使用する

この認証の種類は OAuth 2.0 認可コードに似ていますが、独自のクライアント ID とクライアント シークレットの資格情報を使用する必要があります。

独自のアプリの作成に関する Jira のガイドライン「 OAuth 2.0 (3LO) apps」に従います。アプリケーションは Jira 開発者コンソールから作成できます。独自の Oauth2.0 を設定する場合アプリは必ずリダイレクト/コールバック URL を {baseURL\\_CallBack\}のように指定してください。

次の資格情報が必要です。

• クライアント ID – Jira インスタンスに対して生成されるクライアント ID です。
• クライアント シークレット – Jira インスタンスに対して生成されるクライアント シークレットです。
• サイト URL – Jira インスタンスの URL です。サイト URL の形式の例は「 https://company.atlassian.net」です。
• スコープ – この接続をリクエストするスコープを選択します。クライアントが使用を許可されているスコープのみを含めます。選択したスコープは、既定のスコープに自動的に追加されます。

基本認証

この認証の種類では、独自の API トークンを生成する必要があります。詳しくは、「 Manage API tokens for your Atlassian account (お使いの Atlassian アカウントの API トークンを管理する)」をご覧ください。

次の資格情報が必要です。

• サイト URL – Jira サイトの URL です (例: https://your-domain.atlassian.net)。Jira にアクセスするための権限を UiPath アプリに付与するよう求められたら、必ず同じ Jira サイトを選択してください。
• ユーザー名 – Atlassian アカウントのユーザー名です。
• API トークン – Jira インスタンス用に生成されるトークンです。

スコープ

スコープは、アプリが Atlassian 製品と対話するために要求できるアクセス レベルを定義します。コネクションが確立され、ユーザーが Jira アクティビティを通じて (API 経由で) アプリを認可すると、OAuth アプリはユーザーに代わって、指定された操作を実行する権限を得られます。この権限は、ユーザーの権限設定に応じて付与されます。利用可能なスコープの完全なリストについては、「 Jira スコープ」をご覧ください 。

コネクションを設定するときに、事前に選択したスコープをそのまま使用するか、カスタムのコンマ区切りリストを指定できます。これにより、OAuth アプリが要求するアクセス許可を制御し、既定で不要なアクセスを回避できます。

すべてのコネクションに次のスコープが必須であり、自動的に選択されます。

• read:jira-work
• write:jira-work
• read:jira-user
• manage:jira-configuration
• manage:jira-project
• manage:jira-data-provider
• offline_access

要件に基づいて、利用可能な複数選択リストから追加のスコープを選択することもできます。

Jira コネクションを追加する

お使いの Jira インスタンスへのコネクションを作成するには、次の手順を実行する必要があります。

1. 左側のレールから [Integration Service] を選択します。
2. [コネクタ] のリストから [Jira] を選択します。検索バーで検索して、表示されるコネクタの数を絞ることもできます。
3. [ Jira に接続 ] ボタンを選択します。
4. 認証の種類を選択します。
5. 使用する認証方法に必要な資格情報を入力し、[ 接続] を選択します。

権限

お使いのアカウントへのアクセス権があることにより、UiPath for Jira Cloud は以下の操作を実行できます。

• 設定を管理する:

  • Jira の管理アクション (例: プロジェクトとカスタム フィールドの作成、ワークフローの表示、課題のリンクの種類の管理)。
  • サード パーティ向けの開発およびリリース情報を Jira で管理できます。
  • プロジェクト設定の作成と編集、および新しいプロジェクト レベルのオブジェクト (例: バージョンとコンポーネント)。

• データを表示:

  • ユーザーがアクセスできる Jira でユーザー情報 (ユーザー名、メール アドレス、アバターを含む) を表示する。
  • Jira プロジェクトと課題のデータの読み取り、課題ならびに添付ファイルやワークログなどの課題に関連するオブジェクトを検索します。

  更新 の問題:

  • Jira での課題の作成と編集、ユーザーとしてのコメントの投稿、ワークログの作成、課題の削除を実行できます。