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

Jira Cloudインスタンスをライブ同期のために設定してください

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

Lucidとのライブ同期のためにJira Cloudインスタンスを設定するには、アカウント管理者がLucidで以下の手順を行えます:

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

これにより [Jira Cloud 設定] ページが開き、次の手順に従う必要があります。

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

インテグレーションは現在、ライブシンクが可能にセットアップされています。

Jira Data Center インスタンスの有効化

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

このセクションに示されている Jira メニューは、Jira Data Center のバージョンによって異なる場合がありますが、基本的な設定手順は同じです。

Jira インスタンスが Lucid のサーバーからアクセス可能であることを確認する

公開 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. アプリケーション名を設定してください。
   • 選択する名前は、Jira と Lucid カードの機能を表すものであるべきです。たとえば、「 Lucidspark 」などです。
   • リダイレクトURLを「https://lucid.app/jiradatacenter/oauth2/callback」に設定してください。
8. アプリケーションのアクセス許可に管理者権限を追加してください。
9. 生成されたクライアントIDとクライアントシークレットを保存してコピーしてください。

ステップ2：Lucidで接続を設定する

1. Lucidでは、ホームページ左下にあるメニューから「管理者」を選択してください。
2. 左側のメニューから[アプリ統合]を選択します。
3. ドロップダウンメニューから「Lucidspark」をクリックします。
4. 「Jira 用 Lucid カード 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データセンターの同意画面にリダイレクトされます。

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

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

この問題を解決するには、お客様のSSOおよびネットワーク構成の詳細を考慮する必要があります。Lucidのサーバー間トラフィックがSSOの傍受を回避するように、SSOまたはネットワークインフラストラクチャを設定する必要があります。一般的なアプローチには、SSO レイヤーでのパスベースの除外や、Lucid のトラフィックを完全に SSO 経由でルーティングすることが含まれます。

OAuth 1.0とSSOを使用する

OAuth 1.0 アプリケーションリンクについては、このコミュニティ投稿にある Atlassian の回避策を参照してください。

Atlassian Government Cloudのインスタンスをライブ同期のために設定してください

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

Atlassian Government CloudインスタンスをLucidとリアルタイム同期させるために設定するには、アカウント管理者がLucidで以下の手順を踏み込めます:

1. Lucid ホームページで、ナビゲーション メニューの左下にある[管理] をクリックします。
2. 左側メニューの 「App インテグレーション 」をクリックしてください。
3. ドロップダウンから Lucidsparkを選択します。
4. 「 新しいAtlassian Government Cloudインスタンスを追加」をクリックします。
5. 権限を読み、 「同意」をクリックしてください。

インテグレーションは現在、ライブシンクが可能にセットアップされています。

よくある質問 (FAQ)

必要でないのに、なぜJira CloudやAtlassian Government Cloudのインテグレーションを管理者として有効にする必要があるのでしょうか?
2023年1月現在、LucidsparkはJiraからのデータを同期するためにウェブフックを利用しています。このアップデートにより、ホワイトボードはJiraからのリアルタイムでアップデートを受け取ることができます。 Lucidspark ウェブフックの作成・管理は、この記事のインテグレーション設定手順による一度認証後にのみ行われます。 これらのステップが完了する前にユーザーが個別にインテグレーションをインストールするとインテグレーションは機能しますが、カードはJiraから約2分ごとに更新を同期し、リアルタイムではありません。

Jira Data CenterでLucid カード インテグレーションを設定しようとしたときにエラーメッセージが出たらどうすればいいですか?
Jira Data Center インテグレーションの設定時にアプリケーションエラーが発生した場合は、Jira 用 Lucid カード データセンターのコミュニティ投稿を参考にしてください。

このインテグレーションはどのように機能し、どんな権限が必要ですか?
このインテグレーションの仕組みや、ユーザーまたはアカウント管理者のJira認証情報に基づく権限について詳しく知りたい方は、Jira 用 Lucid カード Technical FAQsリソースをご参照ください。このリソースには、アカウント管理者の認証情報の使い方、ウェブフックとその利点、そしてJiraデータの保護方法についての詳細な解説が含まれています。

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

リソース

この統合を効果的に使用するためのさらなる支援が必要な場合は、以下の追加リソースを参照してください。 これらのリソースは英語でのみ利用可能です。

コミュニティの投稿

Jira トラブルシューティング: Lucid でフィールドを編集できません - エラー メッセージ「編集はサポートされていません」
Jira トラブルシューティング: 動的テーブルに列として追加されるさまざまな言語

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