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

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 コネクタを使用して特定のタスクを完了するために必要な権限を示しています。

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

接続のセットアップ

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

Smartsheet と Jira を接続する際は、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 管理者の資格情報が削除された場合は、トークンの変更が生じるため、アプリケーション リンクを再構築する必要があります。

セットアップ手順

接続を確立する手順は、Jira の展開タイプや OAuth バージョンによって異なります。以下のうち、条件に合った手順を実行してください。

接続をセットアップするには、Jira の管理者権限が必要です。

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

Jira Cloud OAuth 1.0、OAuth 2.0、または Jira Data Center OAuth 1.0

ステップ 1: 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 バージョンを選択します。Jira Server 7 か、Jira クラウド インスタンスの場合は Cloud を選択します。

Brandfolder Image

5. [Settings (設定)] ページでこれらの項目を入力したら、[Continue (続行)] を選択します。
6. [Configuration (構成)] ページで、Consumer Key (コンシューマー キー)、Consumer Name (コンシューマー名)、および Public Key (パブリック キー) を確認します。次のステップで使用するため、これらをコピーします。
7. [Continue (続行)] を選択して次のページに移動します。

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

OAuth 2.0 を使用している場合は、このステップをスキップしてください。

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

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

   Brandfolder Image

   

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

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

   Brandfolder Image

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

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

     Brandfolder Image

     

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

     Brandfolder Image

     
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 (続行)] を選択します。

     Brandfolder Image

     

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

OAuth 2.0 を使用している場合は、このステップをスキップしてください。

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

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

   Brandfolder Image

   
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 (閉じる)] を選択します。

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

1. Smartsheet Jira Connector の構成画面に移動します。
2. [Connect (接続)] 画面で [Connect (接続)] を選択し、Smartsheet 側からの接続を完了させます。

ダイアログ画面で、Smartsheet に Jira 環境での読み取りと書き込みを許可するかどうかを尋ねるメッセージが表示されます。 

3. OAuth 2.0 を使用している場合は、[Use app on (以下でアプリを使用)] ドロップダウンからホストを選択します。使用していない場合は、次のステップにスキップします。 

Brandfolder Image

4. [Allow (許可する)] を選択します。 

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

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

Jira Data Center OAuth 2.0

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

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

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

4. [Create link (リンクの作成)] を選択します。[リンクの作成] ボックスが表示されます。以下のようにフィールドに入力します。
   • アプリケーション タイプとして [External Application (外部アプリケーション)] を選択します
   • [Direction (方向)] として [Incoming (受信)] を選択します
   • [Continue (続行)] を選択します

Brandfolder Image

4. 受信リンクを設定するために、フィールドに以下の内容を入力します。
   1. [Name (名前)] には、わかりやすい名前を追加します。
   2. [Redirect URL (リダイレクト URL)]には、{smartsheet-connector-host}/c/jira/signInCallback} を追加します。「smartsheet-connector-host」の部分はリージョンごとに異なります。

      • 米国の場合: https://connectors.smartsheet.com

      • オーストラリアの場合: https://connectors.smartsheet.au

      • EUの場合: https://connectors.smartsheet.eu
   3. [Application Permission (アプリケーションの権限)] については、[System Admin (システム管理者)] を選択します。
5. [Save (保存)] を選択します。

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

ステップ 2: 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 (構成)] ページで、[Client ID (クライアント ID)] と [Client Secret (クライアント シークレット)] を確認し、ステップ 1 で取得した値を入力します。

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

1. クライアント ID とクライアント シークレットを入力したら、[Continue (続行)] を選択します。
2. [Connect (接続)] 画面で [Connect (接続)] を選択し、Smartsheet 側からの接続を完了させます。

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

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

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 の統合機能にアクセスできるユーザーを制限する)] の横にあるチェックボックスにチェックを入れます。 

   Brandfolder Image

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

アクセスを削除するには

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

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