Jiraの統合

Jiraと統合して、任意のデバイス、イントラネット、またはメッセンジャーで問題を追跡し、タスクに関する自動更新を行います。

次のプロセスを使用して、Jiraとの統合を有効にします。このプロセスを完了すると、Citrixマイクロアプリの使用によって実行されたすべてのアクションを含む、既存のレベルの監査ログが保持されます。

追加設定不要のJiraマイクロアプリの一覧については、「Jiraマイクロアプリの使用」を参照してください。

必須条件の確認

この統合を通じて使用するすべてのユーザーアカウントでは、アカウント設定のメールの表示をAnyoneに設定する必要があります。これはサービスアカウント、およびユーザーがOAuthを介してCitrix Workspaceにログインするアカウントを指します。https://id.atlassian.com/manage-profile/profile-and-visibilityに移動し(必要な場合はログインして)、[Contact] セクションで、メールアカウントの横のWho can see this?メニューでAnyoneを選択します。

Jiraでこの統合を準備したら、Citrix Workspaceマイクロアプリに統合を追加するには、以下のアーティファクトが必要になります:

  • URL
  • ユーザー名
  • パスワード - 統合をCitrix Workspaceマイクロアプリに追加するときに、パスワードとしてAPIトークンを入力する必要があります。
  • 認証方法(資格情報またはOAuth2のいずれか)

OAuth 2.0の場合は、以下も必要です:

  • クライアントID
  • クライアントシークレット

注: 利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。

統合プロセスを開始する前に、以下の前提条件を満たしておく必要があります:

  • 管理するJiraプロジェクトに対するプロジェクト参照アクセス権を持つ、専用ユーザーアカウント。

    ユーザーの管理について詳しくは、「https://www.atlassian.com/software/jira/guides#ManagingUsers-Addingusers」を参照してください。

    Jiraプロジェクトの権限スキームにユーザーを追加する方法については、「プロジェクトの権限の管理」を参照してください。

  • Citrix GatewayがJiraのシングルサインオンに対応するように構成して、ユーザーがログインすると、再度資格情報を入力しなくても自動的に再ログインできるようにします。Jira Single Sign-on構成の手順に従ってください。SSOの構成について詳しくは、「Citrix Gatewayサービス」を参照してください。

OAuth 2.0(3LO)の有効化

OAuth 2.0(3LO)を実装する前に、Jiraアプリ管理でアプリに対してOAuth 2.0を有効にする必要があります。

  1. アプリの管理にアクセスします。
  2. [Create new app] を選択して新しいアプリを作成し、名前を入力して条件に同意し、[Create]を選択します。
  3. クライアントIDシークレットを、後で使用するためにコピーしておきます。
  4. サイドナビゲーションの [APIS AND FEATURES] セクションで、[+Add]をクリックします。
  5. [APIs and features]ページ の[Features]セクションで、[OAuth 2.0 (3LO)]を見つけて、[Add][Configure]の順に選択します。
  6. [Callback URL] を入力します。このURLを、アプリからアクセス可能なURLに設定します。アプリにOAuth 2.0(3LO)を実装するときに(次のセクションを参照)、redirect_uriがこのURLと一致する必要があります。
  7. [Save changes]をクリックします。

画面は次のように表示されます: Jira OAuth2

APIトークンの作成

スクリプトまたはその他のプロセスでAPIトークンを使用して、Jira CloudアプリケーションまたはConfluence Cloudで基本認証を実行できます。認証に使用するAtlassianアカウントで2段階認証を有効にしている場合は、APIトークンを使用する必要があります。APIトークンを使用してログインしている場合は、[APIトークン]ページに直接進んで手順3を実行します。

  1. 左下のユーザープロファイルをクリックします。
  2. [Profile]>[Manage your account]>[Security]>[Create and manage API tokens] と選択します。
  3. [Create API token] を選択して、[Label]フィールドにトークンの名前を入力します。
  4. 後で使用するために、クリップボードにコピーして保存します。

統合をCitrix Workspaceマイクロアプリに追加するときに、パスワードとしてAPIトークンを入力する必要があります。

JiraプラットフォームREST APIの追加

JiraプラットフォームREST APIをまだ追加していない場合は、ここで追加します:

  1. サイドナビゲーションの [APIS AND FEATURES] セクションで、[+Add]をクリックします。
  2. [APIs and features]ページ[API] セクションで、[OAuth 2.0 (3LO)]を見つけて、[Add][Configure]の順に選択します。
  3. アプリに目的のスコープを追加します。

課題を検索する期間の設定

Jiraで課題を検索する期間を設定します。統合をCitrix Workspaceマイクロアプリに追加するときに、統合がJiraから検索するデータの量は、負荷フィルターを適用することで制限できます。

  1. 専用のユーザーアカウントとパスワードでJiraにログインします。

    注:

    既存のアカウントを使用している場合、ユーザー名はアカウントの電子メールではありません。アカウントのユーザー名を見つけるには、Jiraインスタンスにログインし、プロファイルのサムネイルを選択して、 [Profile] を選択します。

  2. 課題を取得する日数を入力します。

    デフォルト:90日。

コールバックURLの追加

インスタンス構成にカスタムURLを追加して、プライベートデータへのアクセスを許可し、OAuth認証済みユーザーアクションを有効にします。マイクロアプリのサーバーURLを見つけるには、Citrix Cloudにサインインしてマイクロアプリタイルを選択します。URLバーで、URLの最初のセクションをコピーします。これはマイクロアプリサーバーのURLです。セクション{yourmicroappserverurl}は、テナント部分、リージョン部分、環境部分で構成されています:https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com

管理者としてJiraにログインし、この統合用に以下の承認済みリダイレクトURLを追加します:

https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback

Citrix Workspaceマイクロアプリへの統合の追加

Jira統合をCitrix Workspaceマイクロアプリに追加して、アプリケーションに接続します。これにより、通知とアクションが設定済みとなっている追加設定不要のマイクロアプリを、Workspace内で使用できるようになります。

次の手順を実行します:

  1. 概要ページから、[はじめに]を選択します。

    [統合の管理]ページが開きます。

  2. [新しい統合を追加] および [Citrix提供のテンプレートから新しい統合を追加する] を選択します。
  3. 追加するJiraタイルを選択します。
  4. 統合の名前を入力します。

    Jiraコネクタのパラメーター、URL、ユーザー名、パスワード、ユーザー認証

  5. 前提条件として収集したコネクタのパラメーターを入力します。
    • [URL] を入力します。
    • サービス認証の [ユーザー名][パスワード] を入力します。

      注:

      統合をCitrix Workspaceマイクロアプリに追加するときに、前の手順で収集したAPIトークンパスワードとして入力します。

  6. [認証方法] を選択します。OAuth 2.0セキュリティプロトコルを使用して、委任されたアクセスの要求/承認トークンを生成します。
    • 資格情報 - 資格情報。クライアントの資格情報が使用されます。
    • Oauth 2.0 - 前提条件の手順で収集したOAuthクライアントIDOAuthクライアントシークレットを入力します。
  7. [Changed Tickets Weeks To Load] の数値を選択します。
  8. [追加] を選択します。

[マイクロアプリ統合] ページが開き、追加した統合とそのマイクロアプリが表示されています。ここから別の統合を追加したり、追加設定不要のマイクロアプリのセットアップを続行したり、この統合用の新しいマイクロアプリを作成したりできます。

これで、最初のデータ同期を設定して実行する準備ができました。統合アプリケーションからマイクロアプリプラットフォームに大量のデータをプルできるので、[テーブル] ページを使用して、最初のデータ同期のエンティティをフィルタリングし、同期を高速化することをお勧めします。

詳しくは、「統合の構成」で「必要なエンティティの確認」および「データ同期の設定」を参照してください。

APIエンドポイントとテーブルエンティティについて詳しくは、「Jiraコネクタの仕様」を参照してください。

Jiraマイクロアプリの使用

既存のアプリケーション統合には、追加設定不要のマイクロアプリが付属しています。これらのマイクロアプリから開始して、ニーズに合わせてカスタマイズします。

Jiraマイクロアプリ

Jira統合には、以下の設定済みで追加設定不要のマイクロアプリが付属しています:

チケットの作成: 詳細を指定して新しいJiraチケットを作成します。

通知またはページ ユースケースワークフロー
チケットの作成ページ 問題の種類、プロジェクト、オプションでの担当者の選択と説明を追加するためのフィールドを含む、新しいJiraチケットを作成するためのフォームを提供します。

チケット: チケットを表示し、コメントを追加し、サブタスクを作成し、状況および担当者を変更します。

通知またはページ ユースケースワークフロー
コメント編集(割り当てられているチケット)通知 ユーザーに割り当てられている既存のチケットでコメントが編集されると、ユーザーはWorkspaceでコメント編集通知を受け取ります。
コメント編集(報告)通知 ユーザーが報告した既存のチケットでコメントが編集されると、ユーザーはWorkspaceでコメント編集通知を受け取ります。
新規コメント(割り当てられているチケット)通知 ユーザーに割り当てられている既存のチケットに新しいコメントが追加されると、ユーザーは通知を受け取ります。
新規コメント(報告されたチケット)通知 ユーザーが報告した既存のチケットに新しいコメントが追加されると、ユーザーは通知を受け取ります。
チケット割り当て(変更)通知 既存のチケットがユーザーに割り当てられると、ユーザーは通知を受け取ります。
チケット割り当て(新規)通知 新しいチケットがユーザーに割り当てられると、ユーザーは通知を受け取ります。
チケット担当者変更(報告済み)通知 チケットが再割り当てされると、チケットの報告者は通知を受け取ります。
チケット状況変更(割り当てられたチケット)通知 チケットの状況が変更されると、チケットの担当者は通知を受け取ります。
チケット状況変更(報告済み)通知 チケットの状況が変更されると、チケットの報告者は通知を受け取ります。
コメントの追加ページ Jiraチケットにコメントを追加するためのフォームを提供します。
担当者の変更ページ Jiraチケットの担当者を変更するためのフォームを提供します。
状況の変更ページ Jiraチケットの状況を変更するためのフォームを提供します。
コメントの詳細ページ コメントの詳細の読み取り専用ビューを提供します。
サブタスクの作成ページ Jiraチケットのサブタスクを作成するためのフォームを提供します。
チケットの詳細ページ Jiraチケットの詳細の読み取り専用ビューを提供します。
チケットページ ユーザーに割り当てられているJiraチケット、ユーザーが報告したJiraチケット、またはユーザーがコメントしたJiraチケットをユーザーが検索できます。