管理者向け : Jira のための Lucid カードを構成

Jira Cloud インスタンスでライブ同期を設定

次の手順を完了するには、Jira と Lucidspark の両方の管理者権限が必要です。このインテグレーションを設定する管理者は、Lucidspark ライセンスを保持している必要があります。 また、Jira サービスアカウントまたは Jira 管理者アカウントを使用することをお勧めします。

Lucid とのライブ同期用に Jira Cloud インスタンスを設定するには、アカウント管理者は Lucid で次の手順を実行します。 

1. Lucid ホームページから、ナビゲーションメニュー左下の [管理者] をクリックします。
2. 左側のメニューの [アプリのインテグレーション] をクリックします。 
3. ドロップダウンから [Lucidspark]を選択します。
4. Lucid Cards for Jira Cloud タイルを見つけて、[設定] をクリックします。
5. [新しいインスタンスを追加] を選択します。
   

これにより [Jira Cloud 設定] ページが開くので、以下の手順に従います。

1. [認証対象] ドロップダウンから、Lucidspark 用の Jira インスタンスを選択します。
2. [許可] をクリックします。
   
3. Jira インスタンスの認証情報で認証するには、[接続] をクリックします。
4. [送信] を選択します。

インテグレーションのライブ同期が設定されました。 

Jira Data Center インスタンスを有効にする

以下の手順に従って、Jira Data Center インスタンスを設定します。新しいインテグレーションには OAuth 2.0 の使用をお勧めします。以前に Application Links (OAuth 1.0) を使用してアカウントを接続していた場合、切り替える必要はなく、既存の接続は引き続き機能します。OAuth 1.0 のサポートが必要な場合は、こちらのコミュニティ投稿を参照してください。

このセクションに表示される Jira メニューは、使用している Jira Data Center のバージョンによって異なる場合がありますが、一般的な設定プロセスは同じです。

Lucid のサーバーから Jira インスタンスにアクセスできることを確認

パブリック向け DNS が設定されていることを確認し、以下に記載されている静的 IP からのインバウンドリクエストを許可してください。

FedRAMP 環境をご利用の場合は、以下に記載されている静的 IP からのインバウンドおよびアウトバウンドのリクエストを許可するようにしてください。

OAuth 2.0 を使用して Lucidspark を Jira Data Center に接続

次の手順を完了するには、Lucidspark ライセンスに加え、Jira と Lucidspark 両方の管理者権限が必要です。

ステップ 1: Jira Data Center で OAuth 2.0 アプリケーションを作成

Jira Data Center インスタンスで着信 OAuth 2.0 アプリケーションリンクを作成します。

1. Jiraで、Jira設定に移動します。
2. [アプリケーション] に移動します。
3. アプリケーションリンクを選択します。
4. [リンクを作成] を選択します。
5. [受信] 方向の外部アプリケーションを選択します。
6. [続行] を選択します。
7. アプリケーション名を設定してください。
   • 選択する名前は、「Lucidspark」など、Jira 用 Lucid カードの機能を表すものにしてください。
   • リダイレクト URL を「https://lucid.app/jiradatacenter/oauth2/callback」に設定します。
8. アプリケーション権限に ADMIN を含めるように設定します。
9. 生成されたクライアント ID とクライアントシークレットを保存してコピーしてください。

ステップ 2 : Lucid での接続の構成

1. Lucid で、ホームページの左下隅にあるメニューから管理者を選択します。
2. 左側のメニューから [アプリインテグレーション] を選択します。
3. ドロップダウンメニューから [Lucidspark] をクリックします。
4. 「Lucid Cards for Jira Data Center」タイルを探します。
5. タイルの [設定] (以前にインテグレーションを設定したことがない場合は [インストール]) をクリックします。
6. 新しいインスタンスを追加 (これまでにインテグレーションを設定したことがない場合は 設定を開始) を選択します。
7. リダイレクト URL が、Jira のアプリケーションリンクで設定した内容と一致していることを確認してください。
8. Jira からクライアント ID とクライアントシークレットを入力します。
9. Jira Data Center インスタンスの URL を入力してください。
   • これは例えば、「https://jira.yourcompany.com」のようになります。
   • 受信トラフィックがインスタンスに到達する前にインターセプトするようにリバースプロキシが設定されている場合は、そのリバースプロキシの URL を入力できます。そのリバースプロキシは、こちらに記載されている当社の IP アドレスからの受信トラフィックを許可する必要があります。

ステップ 3：接続を承認する

1. [有効にする] をクリックして OAuth 2.0 認可フローを開始します。

アクセスを承認するため、Jira Data Center インスタンスにリダイレクトされます。 承認後、Lucid へリダイレクトされます。 インテグレーションのライブ同期が設定されました。

管理者の設定が完了すると、エンドユーザーは各自の Jira 認証情報で認証を行い、Lucidspark で Jira の課題をインポートおよび作成できるようになります。 初回接続時、各ユーザーは Jira Data Center の同意画面にリダイレクトされます。

Jira で SSO 認証を使用しているアカウントの場合

Lucid のサーバーが Jira Data Center インスタンスに到達できる必要があります。Jira Data Center インスタンスが SSO プロバイダーによって保護されている場合、SSO はブラウザーでユーザーを認証するように設計されており、API 呼び出しを行うバックエンドサービスでは完了できないことが多いため、問題が発生する可能性があります。

この問題の解決方法は、SSO およびネットワーク設定によって異なります。Lucid のサーバー間トラフィックが SSO のインターセプトをバイパスするように、SSO またはネットワークインフラストラクチャを設定する必要があります。一般的なアプローチとしては、SSO レイヤーでのパスベースの除外や、Lucid のトラフィックが SSO を完全に迂回するようにルーティングすることなどが挙げられます。 

SSO での OAuth 1.0 の使用

OAuth 1.0 アプリケーションリンクについては、こちらのコミュニティ投稿に記載されている Atlassian の回避策をご覧ください。

ライブ同期用に Atlassian Government Cloud インスタンスを設定

以下の手順を完了するには、Jira と Lucidspark の両方の管理者権限が必要となります。 このインテグレーションを設定する管理者が Lucidspark ライセンスを保持している必要があります。 また、Jira 管理者アカウントを使用することをお勧めします。

Lucid とのライブ同期用に Atlassian Government Cloud インスタンスを設定するには、アカウント管理者は Lucid で次の手順を実行します。 

1. Lucid ホームページから、ナビゲーションメニュー左下の [管理者] をクリックします。
2. 左側のメニューの [アプリのインテグレーション] をクリックします。 
3. ドロップダウンから [Lucidspark] を選択します。
4. 新しい Atlassian Government Cloud インスタンスを追加をクリックします。
5. 権限の内容を確認し、[許可] をクリックします。

インテグレーションのライブ同期が設定されました。 

よくある質問 (FAQ)

必須ではないにもかかわらず、管理者が Jira Cloud または Atlassian Government Cloud のインテグレーションを有効にするのはなぜですか？
2023年1月より、Lucidspark は Jira からのデータ同期に Webhook を使用しています。この更新により、ホワイトボードは Jira からの更新をリアルタイムで受信できるようになります。Lucidspark は、この記事のインテグレーション設定手順を通じた1回限りの認証後にのみ、Webhook の作成と管理を行います。これらの手順を完了する前にユーザーが個別にインテグレーションをインストールした場合、インテグレーションは機能しますが、カードはリアルタイムではなく約2分ごとに Jira からの更新を同期します。

Jira Data Center で Lucid カードインテグレーションを設定しようとした際にエラーメッセージが表示される場合はどうすればよいですか？
Jira Data Center インテグレーションの設定中にアプリケーションエラーが発生した場合は、この Jira Data Center 用 Lucid カードの設定時によくあるエラーを解決するためのヒントに関するコミュニティ投稿を参照してください。

このインテグレーションはどのように機能し、どのような権限が必要ですか？
このインテグレーションの仕組みや、Jira のユーザーまたは管理者認証情報に基づく権限に関する詳しい説明については、Jira 用 Lucid カードの技術的なよくある質問 (FAQ) のリソースを参照してください。このリソースでは、管理者認証情報の使用方法、Webhook とそのメリット、Jira データの保護方法について詳しく解説しています。

Atlassian Government Cloud インスタンスで Jira 用 Lucid カードのインテグレーションを設定しようとすると、lucid.app にリダイレクトされるのはなぜですか?
lucid.app へのリダイレクトを防ぐには、Jira 用 Lucid カードインテグレーションを設定する前に、SSO を使用して Atlassian Government Cloud インスタンスにログインする必要があります。

リソース

このインテグレーションを正常に利用するための詳細なサポートについては、以下の追加リソースを参照してください。これらのリソースは英語でのみご利用いただけます。

コミュニティの投稿

Jira のトラブルシューティング : Lucid でフィールドを編集できない - エラーメッセージ「Edit not supported」
Jira のトラブルシューティング : ダイナミックテーブルに異なる言語が列として追加される

この記事へのフィードバックをお寄せください