Smartsheet Jira コネクタの管理とセットアップ

Smartsheet Jira コネクタを使用して、Smartsheet と 1 個以上の Jira インスタンス間で情報を同期することができます。この記事では、Jira Cloud および Jira セルフホスト型サーバーで Smartsheet Jira コネクタをセットアップする手順について説明します。

PLANS

  • Business
  • Enterprise
  • Smartsheet Advance Package

権限

ワークフローを作成または編集するには、次の権限が必要です。

  • Smartsheet 環境では、ライセンス ユーザーである必要があります。これには、ワークフロー内でマッピングされたシートに対する編集者以上の権限が含まれます。
  • ワークフローを構築したい Jira プロジェクトへの十分なアクセス権を持つ、有効な Jira アカウントが必要です。

Jira 環境への初回接続が、ご自身のプランのプレミアム Smartsheet Jira コネクタを通じて確立されていることを確認してください。コネクタを構成するには、Smartsheet および Jira のシステム管理者であることが必要です。

Smartsheet Jira コネクタは、プレミアム サービスとして提供されています。ご利用のプランで Smartsheet Jira コネクタを購入している場合は、ログインして Smartsheet と Jira 間のワークフローの作成を開始します。


用語と権限のタイプ

始めに、いくつかの役立つ用語をご紹介します。

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

Smartsheet Jira コネクタを操作できるのは、次の 3 つのユーザー レベルです。

  • Smartsheet システム管理者 — Smartsheet アプリケーションで Jira コネクタ管理者と Jira コネクタ ユーザーを管理できます。システム管理者は、コネクタへのアクセスを制限する設定を有効にすることもできます。
  • Jira コネクタ管理者 — コネクタに対する一意のユーザー タイプ。Jira コネクタ ユーザーを指定し、アクセス制限リストにユーザーを追加できます (システム管理者がこの設定を有効にした後)。
  • Jira コネクタ ユーザー — コネクタに対する一意のユーザー タイプ。Smartsheet と Jira の間で情報を同期するワークフローを作成できます。(これは、ユーザー制限リストの設定がコネクタで有効になった場合にのみ使用可能です。)

権限タイプ別機能

この表は、どのユーザーが Jira コネクタを使用して特定のタスクを完了できるかを示しています。

 Smartsheet システム管理者Jira コネクタ管理者Jira コネクタ ユーザー
ワークフローの作成可*可*
所有しているワークフローの編集可*可*
所有しているワークフローの無効化不可不可
組織内のすべてのワークフローの閲覧不可
組織内のワークフローの無効化不可
組織内のワークフローの有効化または実行不可不可不可
Jira コネクタ ユーザーの役割を割り当てる不可
Jira コネクタ管理者の役割を割り当てる不可不可
アクセス制限設定の有効化不可
アクセス制限リストへの個人の追加 (制限を有効にした後)不可

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


接続のセットアップ

Smartsheet Jira コネクタの使用を開始するには、まず Smartsheet と Jira インスタンス間の接続をセットアップする必要があります。これにより、ユーザーは Smartsheet と Jira の特定の要素を接続するワークフローを構築できます。 

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

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

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

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

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

 

ステップ 1: Smartsheet Jira コネクタに新しい Jira サーバーを登録する

セルフホスト型 Jira サーバーとファイアウォールを使用してコネクタのセットアップを行う場合は、Jira コネクタのファイアウォール設定の手順に従ってください。

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

 

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

  1. Jira にサインインします (Jira の管理者権限が必要です)。
  2. Jira の [Settings (設定)] (右上の歯車アイコン) に移動し、[Products (製品)] を選択します。
    Jira 製品設定を表示する画像。
  3. [Products (製品)] ページの [Integrations (統合)][Application Links (アプリケーション リンク)] をクリックします。Jira アプリケーション リンクを示す画像

 

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

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

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

Jira での新しいリンク作成を示す画像。

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

Jira 9 以降の画像

5. 次のいずれかのメッセージが表示されたら、[Continue (続行)] を選択して、新しい URL を変更せずそのままにします。

  • No response was received from the URL you entered - it may not be valid. Please fix the URL below, if needed, and select Continue. (入力された URL からの応答がありません。有効でない可能性があります。必要に応じて以下の URL を修正し、[Continue (続行)] を選択してください。)
    または
  • The supplied Application URL has been redirected once. Please 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 (続行)] を選択します。

 

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

  1. ステップ 2 で作成したアプリケーション リンクについて、そのアプリケーション リンクにカーソルを合わせたときに表示される 3 点リーダー メニューを選択するか、[Edit (編集)] アイコンJira の編集アイコン (バージョンによって異なります) を選択します。 
  2. [Configure (構成)] ボックスが表示されます。[Incoming Authentication (受信の認証)] を選択します。
    Smartsheet 認証の構成を示す画像
  3. 以下のようにフィールドに入力します。
    • [Service Provider Name (サービス プロバイダー名)] (必要な場合): Smartsheet
    • [Consumer Name (コンシューマー名)]: ステップ 1 で Jira コネクタからコピーした [Consumer Name (コンシューマー名)] を貼り付けます
    • [Consumer Key (コンシューマー キー)]: ステップ 1 で Jira コネクタからコピーした [Consumer Key (コンシューマー キー)] を貼り付けます
    • [Public Key/Shared Secret (パブリック キー/共有シークレット)]: ステップ 1 で Jira コネクタからコピーした [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 (受信の認証)] の一番下にある [保存] を選択し、右下の [Close (閉じる)] を選択します。

     

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

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

Welcome to Jira での許可または拒否に関するメッセージを示す画像

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

Smartsheet Jira コネクタを使用して、複数の Jira 環境を Smartsheet アカウントに接続できます。登録する追加の Jira インスタンスごとに上記の手順を繰り返します。 


Smartsheet Jira コネクタへのアクセスを制限する

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

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

アクセスを制限するには

Jira コネクタを使用してワークフローを作成できるユーザーを制限するために、Smartsheet システム/Jira 管理者は [アクセス制限] を設定することができます。

  1. Smartsheet の資格情報で、Smartsheet Jira コネクタにサインインします。
  2. ページ左上のメニューを選択し、[ユーザー管理] を選択します。
  3. [Restrict which users can access the Smartsheet Jira integration (Smartsheet Jira の統合機能にアクセスできるユーザーを制限する)] の横にあるチェックボックスにチェックを入れます。 

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

アクセスを削除するには

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

  1. Smartsheet の資格情報で、Smartsheet Jira コネクタにサインインします。
  2. [ユーザー管理] に進みます。
  3. そのユーザーのアカウント情報の右にある [削除] アイコンを選択します。
この記事はお役に立ちましたか?
はいいいえ