Smartsheet Jira Connector の管理とセットアップ

この記事では、Jira Cloud および Jira セルフホスト型サーバーで Smartsheet Jira Connector をセットアップする手順について説明します。

ご利用可能なユーザー

プラン:

  • Smartsheet
  • Business
  • Business
  • Smartsheet Advance Package

権限:

Smartsheet Jira コネクタを使用してワークフローの作成や編集を行うには、次の条件を満たす必要があります。

  • ライセンス ユーザーである。
  • マッピングしたシートにおいて編集者以上の権限がある。
  • Jira にログインでき、ワークフローを作成するプロジェクトにアクセスできる。
  • システム管理者が Jira コネクタの設定で [Restrict Users (ユーザーを制限)] をアクティブにした場合、Smartsheet で Jira ユーザーの役割も保持する必要があります。
  • Smartsheet Jira コネクタはプランで使用できるプレミアム アプリケーションであり、Jira 環境への初期接続が既に確立されている必要があります。

Find out if this capability is included in Smartsheet Regions or Smartsheet Gov.

Smartsheet Jira Connector では、ワークフローを作成することで、Smartsheet と 1 個以上の Jira インスタンス間で情報を同期することができます。

Smartsheet Jira Connector は、プレミアム サービスです。プランと価格の詳細は、当社のセールス チームにお問い合わせください。

ご利用のプランで Smartsheet Jira Connector をすでに購入済みの場合は、ログインして Smartsheet と Jira 間のワークフローを作成します。

Smartsheet Jira Connector にログイン

用語と権限のタイプ

  • 接続: Smartsheet と特定の Jira インスタンス間のリンク。
  • ワークフロー: Jira の要素を Smartsheet のシートに接続する Jira Connector 内のリンク。

ユーザーは次の 3 つのユーザー タイプで Smartsheet Jira Connector を操作できます。

  • Smartsheet システム管理者: Smartsheet アプリケーションで Jira Connector 管理者と Jira Connector ユーザーを管理できます。システム管理者は、コネクタへのアクセスを制限する設定を有効にすることもできます。
  • Jira Connector 管理者: Jira インスタンスと Smartsheet Jira Connector 間の接続を確立できます。
  • Jira Connector ユーザー: Smartsheet と Jira の間で情報を同期するワークフローを作成できます。

各機能に必要な権限タイプ

次の表では、Jira コネクタを使用して特定のタスクを完了するために必要な権限を示しています。

    
接続の作成   
ワークフローの作成  Jira 管理者
所有しているワークフローの編集✓*✓*可
自分のワークフローの非アクティブ化不可✕✓
組織内のすべてのワークフローの閲覧✓✓不可
組織内のワークフローの非アクティブ化可✓✕
組織内のワークフローの有効化または実行✕✕不可
Jira Connector ユーザーの役割を割り当てる可✓不可
Jira Connector 管理者の役割を割り当てる可✕✕
アクセス制限設定の有効化✓✓不可
アクセス制限リストへの個人の追加 (制限を有効にした後)可✓不可

 *Smartsheet システム管理者およびコネクタ管理者は、アクセス リストの制限機能が有効になっている場合、独自のワークフローを作成および編集できます。システム管理者が Jira Connector の設定で [Restrict Users (ユーザーを制限)] をアクティブにした場合、Smartsheet で Jira ユーザーの役割も保持する必要があります。アクセス制限の詳細はこちらをご覧ください。

接続のセットアップ

まず、Smartsheet と Jira インスタンス間の接続をセットアップする必要があります。これにより、ユーザーは Smartsheet と Jira の要素を結びつけるワークフローを構築できます。Smartsheet Jira Connector は、Jira Cloud、Jira Server (v6.x - v10.x)、および Jira Data Center と互換性があります。

Smartsheet と Jira を接続する際は、ライセンスありの汎用メール アカウント (smartsheet-jira@yourdomain.com) を使用してください。これにより、Jira リンクを管理する担当者が組織を離れても、接続の所有権は変更されないため、接続やワークフローをやり直す必要がなくなります。

事前準備

Smartsheet と Jira の間の接続をセットアップするには、次の権限が必要です。

Jira 内:

  • Jira システム管理者 (製品管理者または組織管理者)

Smartsheet 内:

  • Smartsheet のライセンス ユーザー (旧モデル) またはメンバー (ユーザー モデル)
  • Smartsheet システム管理者の役割または Smartsheet Jira Connector 管理者の役割

コネクタのセットアップに必要な権限は、Smartsheet システム管理者の役割、または Smartsheet Jira Connector 管理者の役割のいずれかのみですが、Smartsheet では両方の役割を保有することを推奨しています。

Smartsheet Jira Connector により自動ワークフローが有効になるので、Jira REST API 経由で Webhook を作成または構成するには、アプリケーションで Jira システム管理者の資格情報が必要です。Jira システム管理者の資格情報は、Webhook の作成と構成にのみ使用されます。

セットアップに使用するアカウントは、Jira と Smartsheet の両方で、管理者権限があり、アクティブになっている必要があります。このユーザーの管理者ステータスを削除すると、「Missing user credentials for this endpoint (このエンドポイントのユーザー資格情報がありません)」というエラーが発生します。管理者権限を復元することで接続が修正され、通常のワークフロー同期が再開されます。Jira 管理者の資格情報が削除された場合は、トークンが変更されているため、アプリケーション リンクを再構築する必要があります。

OAuth 1.0 と OAuth 2.0 では、接続のセットアップ手順が多少異なりますが、どちらも Smartsheet Jira Connector で新しい Jira サーバーが必要です。

接続を設定するには、Jira の管理者権限が必要です。

Smartsheet Jira Connector に新しい Jira サーバーを登録する

この接続をセットアップする前に、ファイアウォールの設定と構成を完了させる必要があります。

  1. Smartsheet Jira Connector にログインします。Smartsheet アカウントへのアクセスを許可するように求められたら、[Allow (許可)] を選択します。
  2. ページ左上のメニューを選択して、[Account Admin (アカウント管理)] をクリックします。
  3. [Register New Jira Server (新規 Jira サーバーの登録)] を選択します。
  4. [Settings (設定)] ページで次の操作を行います。
    1. Smartsheet 環境に接続する Jira 環境の [JIRA Host (Jira ホスト)] の URL を入力します (https://mbfcorp.atlassian.net/)。 
    2. 多くの場合、JIRA API URL は JIRA Host と同じです。 
    3. [Name (名前)] に関しては、既定の名前をそのまま使用するか、より使いやすいものに変更します。 
    4. お使いの Jira バージョンを選択します。
  5. [Settings (設定)] ページでこれらの項目を入力したら、[Continue (続行)] を選択します。
  6. [Configuration (構成)] ページで、Consumer Key (コンシューマー キー)、Consumer Name (コンシューマー名)、および Public Key (パブリック キー) を確認します。これらをコピー、次の手順で使用します。

接続セットアップ - OAuth 1.0

ステップ 1: Jira で Smartsheet へのアプリケーション リンク (AppLink) を作成する

  1. Jira にサインインします (Jira の管理者権限が必要です)。

  2. Jira の [Settings (設定)] > [Products (製品)] の順に移動します。
     

    Jira product settings

  3. [Products (製品)] サイドバーの [Integrations (統合)] で [Application Links (アプリケーション リンク)] を選択します。

    Jira の以前のセルフホスト型バージョンでは、[Settings (設定)] > [Applications (アプリケーション)] を選択後、[Application Links (アプリケーション リンク)] を選択します。

    Jira application links
  4. [Create link (リンクを作成)] を選択すると、[Create link (リンクを作成)] ボックスが表示されます。以下のようにフィールドに入力します。

    • Jira Cloud の場合は、[Direct application link (ダイレクト アプリケーション リンク)] を選択し、[Application URL (アプリケーション URL)] に https://app.smartsheet.com と入力した後、[Next (次へ)] を選択します。

      Create a new application link

    • Jira のセルフホスト型バージョン 9 以降の場合は、[Atlassian product (アトラシアン製品)] を選択し、[Application URL (アプリケーション URL)] に https://app.smartsheet.com と入力した後、[Continue (続行)] を選択します。

      Jira 9 and above verions
  5. 次のいずれかのメッセージが表示されたら、[Continue (続行)] を選択して、新しい URL を変更せずそのままにします。
    • 入力した URL から応答が見つからない場合は、URL が無効になっている可能性があります。If needed, fix the URL below, and select Continue. (入力した URL からの応答がない場合、その URL は無効である可能性があります。必要に応じて、以下の URL を修正し、[Continue (続行)] を選択してください。)
    • The supplied Application URL has been redirected once.Check the redirected URL field to ensure this is a URL you trust. (指定されたアプリケーション URL は一度リダイレクトされています。リダイレクトされた URL フィールドをチェックして、これが信頼できる URL であることを確認してください。)
  6. これで、[Review link (リンクのレビュー)] または [Link applications (アプリケーションをリンク)] ボックスが表示されます。以下のようにフィールドに入力します。
    • [Application Name (アプリケーション名)] ボックスに「Smartsheet」と入力します。
    • [Application Type (アプリケーション タイプ)] は、デフォルト値の [Generic Application (汎用アプリケーション)] をそのまま使用します。
    • Jira セルフホスト型バージョン 9 以降の場合は、[Create incoming link (受信リンクを作成)] ボックスをオンにします。

    • [Continue (続行)] を選択します。

      Linked applications

 

ステップ 2: アプリケーション リンクを編集する

  1. ステップ 2 で作成したアプリケーション リンクについて、そのアプリケーション リンクにカーソルを合わせたときに表示される 3 点リーダー メニューを選択するか、編集アイコン を選択します(バージョンによって異なります)。 

  2. [Configure (構成)] ボックスが表示されます。[Incoming Authentication (受信の認証)] を選択します。
     

    Configuring Smartsheet authentication
  3. 以下のようにフィールドに入力します。 
    • [Service Provider Name (サービス プロバイダー名)] (必要な場合): Smartsheet
    • [Consumer Name (コンシューマー名)]: ステップ 1 で Jira Connector からコピーした [Consumer Name (コンシューマー名)] を貼り付けます
    • [Consumer Key (コンシューマー キー)]: ステップ 1 で Jira Connector からコピーした [Consumer Key (コンシューマー キー)] を貼り付けます
    • [Public Key/Shared Secret (パブリック キー/共有シークレット)]: ステップ 1 で Jira Connector からコピーした [Public Key (パブリック キー)] を貼り付けます
    • [Description (説明)]: 必要に応じて説明を追加します
    • Jira 環境で [Request Token URL (リクエスト トークン URL)]、[Access Token URL (アクセス トークン URL)]、または [Authorize URL (認証 URL)] が必要な場合は、次の URL を使用してそれらのフィールドに入力してください: https://api.smartsheet.com/2.0/token
  4. [Incoming Authentication (受信の認証)] の一番下にある [Save (保存)] を選択し、右下の [Close (閉じる)] を選択します。

ステップ 3: Smartsheet Jira の接続を完了する

  1. Smartsheet Jira Connector の構成に戻り (キーをコピーした [Configuration (構成)] ページがまだ表示されているはずです)、[Continue (続行)] を選択します。
  2. [Connect (接続)] 画面で、[Connect (接続)] を選択し、Smartsheet 側からの接続を完了させます。
  3. ダイアログ画面で、Smartsheet に Jira 環境での読み取りと書き込みを許可するかどうかを尋ねられます。[Allow (許可する)] を選択します。 

これで、Smartsheet と Jira 間の接続がセットアップされました。ご利用のアカウントのライセンス ユーザーまたはメンバーが、Jira のアイテムと Smartsheet のシート間のワークフローを作成できるようになりました。 

Smartsheet Jira Connector を使用して、複数の Jira 環境を Smartsheet アカウントに接続できます。他にも登録が必要な Jira インスタンスがある場合は、上記の手順を繰り返します。 

接続のセットアップ - OAuth 2.0

OAuth2.0 を使用して、Jira Cloud インスタンスごとに最大 3 つの接続を作成できます。

ステップ 1: Jira でコネクタへのアプリケーション リンクを設定する

  1. Atlassian (アトラシアン) のドキュメントに従って、Jira で受信アプリケーション リンクを作成して構成します。リンクを設定する際には、次の詳細を入力します。
    1. Name (名前): リンクの内容がわかる名前を入力します。
    2. リダイレクト URL: https://connectors.test.smartsheet.com/c/jira/signInCallback
    3. 権限: ドロップダウンからシステム管理者を選択します。

ステップ 2: Jira で Smartsheet へのアプリケーション リンク (AppLink) を作成する

  1. Jira にサインインします。
  2. Jira の [Settings (設定)] > [Applications (アプリケーション)] の順に移動します。
  3. アプリケーション サイドバーの [Integrations (統合)] で、[Application Links (アプリケーション リンク)] を選択します。

[Settings (設定)] の下に [Applications (アプリケーション)] が表示されない場合は、[Products (製品)] に移動します。[Products (製品)] サイドバーで、[Integrations (統合)] の下に [Application Links (アプリケーション リンク)] があります。

  1. [Create link (リンクの作成)] を選択します。[リンクの作成] ボックスが表示されます。以下のようにフィールドに入力します。
    • アプリケーション タイプとして [External Application (外部アプリケーション)] を選択します
    • 方向として [Incoming (受信)] を選択します
  2. [Continue (続行)] を選択します。
  3. 受信リンクを設定するために、以下のようにフィールドに入力します。
    • [Name (名前)] には、わかりやすい名前を追加します。
    • リダイレクト URL: {smartsheet-host}/c/jira/signInCallback
    • [Application Permission (アプリケーションの権限)] については、[System Admin (システム管理者)] を選択します。
  4. [Save (保存)] を選択します。

これらの手順を完了すると、「クライアント ID」と「クライアント シークレット」を取得できます。次の手順に進む前に、クライアント ID とクライアント シークレットをどちらもコピーしてください。

ステップ 3: Smartsheet Jira の接続を完了する

  1. Smartsheet Jira Connector に戻ります。
  2. [クライアント ID] と [クライアント シークレット] に、前のステップでコピーした値を入力します。
  3. [Continue (続行)] を選択します。
  4. [Connect (接続)] 画面で、[Connect (接続)] を選択し、Smartsheet 側からの接続を完了させます。

ダイアログ画面で、Smartsheet に Jira 環境での読み取りと書き込みを許可するかどうかを尋ねられます。[Allow (許可する)] を選択します。

Smartsheet Jira Connector へのアクセスを制限する

Smartsheet Jira Connector 内でワークフローを構築できるユーザーをさらに制限したい場合は、アカウント内の特定のライセンス ユーザーまたはメンバーに対しアクセスを制限できます。Jira Connector でできることは、追加の制限が有効になっているかどうかに関係なく、Smartsheet (シートの共有権限) と Jira (フィールドの読み取り/書き込み権限の発行) の両方のアイテムに対して持っている権限によって異なります。

コネクタは、Jira と Smartsheet の両方で許可された権限を尊重します。たとえば、コネクタでワークフローを作成した人が、Jira で特定のプロジェクト データを編集する権限を持っていないとします。その場合、ワークフローではコネクタを介してそのプロジェクトのデータを編集できません。

アクセスを制限するには

Smartsheet システム/Jira 管理者は、Jira Connector を使用してワークフローを作成できるユーザーを制限するために、[Restrict Access (アクセス制限)] の設定を有効にできます。

  1. Smartsheet の資格情報で、Smartsheet Jira Connector にサインインします。
  2. ページ左上のメニューを選択し、[ユーザー管理] を選択します。

  3. [Restrict which users can access the Smartsheet Jira integration (Smartsheet Jira の統合機能にアクセスできるユーザーを制限する)] の横にあるチェックボックスにチェックを入れます。 

    restrict access to the Smartsheet Jira Connector
  4. コネクタへのアクセス権を付与したいユーザーのメール アドレスを追加します。

アクセスを削除するには

リストから削除されたユーザーは、独自のワークフローを作成したり編集したりすることができなくなります。

  1. Smartsheet の資格情報で、Smartsheet Jira Connector にサインインします。
  2. [ユーザー管理] に進みます。
  3. そのユーザーのアカウント情報の右にある [削除] アイコンを選択します。