外部ディレクトリからのデータの同期

特定のディレクトリ タイプの場合、Confluence はディレクトリ情報(ユーザーとグループ)のキャッシュをアプリケーション データベースに保存して、ユーザーおよびグループのデータに繰り返し高速アクセスできるようにします。同期タスクは、内部キャッシュを更新して外部ディレクトリの変更を反映するために定期的に実行されます。

このページの内容

関連ページ

影響を受けるディレクトリ タイプ

データのキャッシングと同期は以下のユーザー ディレクトリ タイプに適用されます。

  • 権限が読み取り専用に設定されているLDAP (Microsoft Active Directory と LDAP ディレクトリをサポートするすべて)
  • 権限がローカル グループでの読み取り専用に設定されているLDAP (Microsoft Active Directory と LDAP ディレクトリをサポートするすべて)
  • 権限が読み取り/書き込みに設定されているLDAP (Microsoft Active Directory と LDAP ディレクトリをサポートするすべて)
  • Atlassian Crowd
  • Atlassian JIRA

データのキャッシングと同期は以下のユーザー ディレクトリ タイプに対しては発生しません。

  • LDAP 認証を使用した内部ディレクトリ
  • 内部ディレクトリ

動作の仕組

以下はキャッシュ機能のサマリーです。

  • キャッシュはアプリケーション データベースに保持されます。
  • 新しい外部ユーザー ディレクトリをアプリケーションに接続する場合、同期タスクはバックグラウンドで実行され、すべての目的のユーザー、グループ、およびメンバーシップ情報を、外部ディレクトリからアプリケーション データベースにコピーします。ユーザー ベースのサイズと複雑さに応じて、このタスクは完了までに時間がかかる場合があります。
  • 同期タスクがユーザーの詳細情報をキャッシュにコピーしている間、ユーザーはログインすることができないので注意してください。
  • 定期的な同期タスクは、外部ディレクトリで実施された変更でデータベースを更新します。デフォルトの同期間隔、またはポーリング間隔は1時間(60分)です。ディレクトリ設定画面で同期間隔を変更できます。
    • Note for Confluence Data Center: The sync will take place on a single node of the cluster to update the database. This may make it seem like automatic synchronization will not be happening, but the task is assigned to one of the nodes.
  • 必要に応じて、手動でキャッシュを同期することができます。
  • 外部ディレクトリの権限が読み取り/書き込みに設定されている場合、アプリケーションを介してユーザー、グループ、メンバーシップ情報が更新される度、キャッシュと外部ディレクトリにも更新が即座に適用されます。
  • すべての認証は、外部ディレクトリへのコールを介して発生します。外部ディレクトリからの情報をキャッシュする場合、ユーザー パスワードはアプリケーション データベースに格納されません。
  • 内部キャッシュに対して他のすべてのクエリを実行します。

同期にかかる時間を調べる

ユーザー ディレクトリ」画面には、かかった時間を含む前回の同期操作の情報が表示されます。

キャッシュを手動で同期する

ユーザー ディレクトリ画面で同期をクリックして、キャッシュを手動で同期することができます。同期操作がすでに進行中の場合、最初の同期が終了するまで、別の同期を開始することはできません。

スクリーン スニペット:同期の情報が表示されるユーザー ディレクトリ

同期間隔の設定

注: Crowd および Jira ディレクトリの同期間隔を設定するオプションは、Confluence 3.5.3 以降で利用可能です。以前のバージョンの Confluence では、LDAP ディレクトリの間隔しか設定できません。

ディレクトリ設定画面では「同期間隔」を設定できます。同期間隔とは、ディレクトリサーバーからの更新のリクエストを待機する時間です。

同期間隔に設定した長さは、以下に応じて異なります。

  • 古いデータを許容できる時間の長さ。
  • アプリケーションとディレクトリ サーバーに配置する負荷の量。
  • ユーザー ベースのサイズ。

同期を頻繁に行う場合、データはより最新になります。頻繁に同期を行うことの欠点は、リクエストによってサーバーの負荷が増加する可能性があるということです。

どうすればいいかよくわからない場合、間隔を60分(デフォルト設定)から初めて、徐々に値を減らしていくことをお勧めします。ご利用のセットアップで実験する必要があります。

最終更新日 2018 年 5 月 8 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.