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

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

Data caching and synchronisation apply to the following user directory types:

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

Data caching and synchronisation do not occur for the following user directory types:

• LDAP (Microsoft Active Directory and all supported LDAP directories) where permissions are set to authentication only, with local groups.
• LDAP 認証を使用した内部ディレクトリ。
• 内部ディレクトリ。

動作の仕組

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

• キャッシュはアプリケーション データベースに保持されます。
• When you connect a new external user directory to the application, a synchronisation task will start running in the background to copy all the required users, groups and membership information from the external directory to the application database. This task may take a while to complete, depending on the size and complexity of your user base.
• Note that a user will not be able to log in until the synchronisation task has copied that user's details into the cache.
• A periodic synchronisation task will run to update the database with any changes made to the external directory. The default synchronisation interval, or polling interval, is one hour (60 minutes). You can change the synchronisation interval on the directory configuration screen.
• You can manually synchronise the cache if necessary.
• 外部ディレクトリの権限が読み取り/書き込みに設定されている場合、アプリケーションを介してユーザー、グループ、メンバーシップ情報が更新される度、キャッシュと外部ディレクトリにも更新が即座に適用されます。
• すべての認証は、外部ディレクトリへのコールを介して発生します。外部ディレクトリからの情報をキャッシュする場合、ユーザー パスワードはアプリケーション データベースに格納されません。
• 内部キャッシュに対して他のすべてのクエリを実行します。

Finding the Time Taken to Synchronise

The 'User Directories' screen shows information about the last synchronisation operation, including the length of time it took.

Manually Synchronising the Cache

You can manually synchronise the cache by clicking 'Synchronise' on the 'User Directories' screen. If a synchronisation operation is already in progress, you cannot start another until the first has finished.

Screen snippet: User directories, showing information about synchronisation

UserDirectoriesSync.png

The length you choose for your synchronisation interval depends on:

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

If you synchronise more frequently, then your data will be more up to date. The downside of synchronising more frequently is that you may overload your server with requests.

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