Kopano Z-PushをActiveSyncモバイル同期用に設定する方法

Z-Pushを使用すると、互換性のあるモバイルデバイスをMicrosoft Exchange ActiveSync経由でKopano Coreと同期できます。信頼性の高い設定には、Z-PushバックエンドをKopanoサーバーに一致させ、ActiveSyncエンドポイントをHTTPS経由で公開し、アップグレード中にZ-Pushの状態を維持することが必要です。最適な構成は、最もシンプルなシングルサーバー展開を希望するか、個別のサービスとマルチホスト機能が必要かによっても異なります。

環境に合った設定を選択してください

Z-PushはオープンソースのActiveSync同期サーバーです。互換性のあるデバイスとグループウェアバックエンド間のプロトコルレイヤーとして機能し、デバイスは通常、Kopanoに直接接続するのではなく、ExchangeまたはActiveSyncアカウントを追加します。Z-Pushは、選択したバックエンドとモバイルクライアントがこれらのデータタイプをサポートしている場合、メール、連絡先、カレンダーアイテム、タスクを同期できます。Kopanoはこの関係について、Kopano Core管理者向けドキュメントで説明しています。

既存のKopano Coreサーバーの場合、Kopanoバックエンドが自然な出発点となります。IMAPとCalDAV/CardDAVを選択するのは、これらのシステムに実際に関連データが格納されている場合、または意図的にソースを分離したい場合に限ります。バックエンドの変更は機能的に中立ではありません。同期動作、アドレス帳、タスク、パブリックフォルダ、互換性などが異なる場合があります。

インストールまたは構成変更を行う前に

• Kopano Core、Z-Push、PHP、Webサーバー、およびオペレーティングシステムのバージョンを記録してください。使用予定のパッケージでサポートされている組み合わせを確認してください。Z-Pushが受け入れるPHPバージョンだけでは、Kopano MAPI拡張機能が利用可能であるとは限りません。
• クライアントが使用する公開ホスト名（例：）を選択し、sync.example.comその名前に対応する信頼できるTLS証明書を準備します。
• Z-PushをKopanoホスト上で実行するか、別のWebサーバー上で実行するかを決定してください。別のホストを使用すれば、Webに公開するサービスを分離できますが、Kopanoへのネットワークアクセスと、正しく設定されたMAPIサーバーアドレスが必要です。
• アップグレード前に、Z-Pushの設定ディレクトリと状態ディレクトリをバックアップしてください。Z-Pushの状態はデバイスの同期状況を追跡します。Kopanoのアップグレードに関するドキュメントには、既存のモバイルプロファイルの状態を保持するように記載されています。
• 個人用または社用携帯電話を登録する前に、各ユーザーが同期するデータタイプを選択し、デバイスポリシーの要件を確認してください。

サーバー側を設定する

1. 対応するZプッシュパッケージセットを取り付けます。

ディストリビューションとKopanoリリース用にビルドされたパッケージが利用可能な場合は、それらを使用してください。一般的なパッケージベースのセットアップでは、Z-Pushコア、Kopanoバックエンド、およびWebサーバー統合が分離されます。Kopanoの管理者マニュアルには、などのパッケージz-push-backend-kopanoとWebサーバー構成パッケージが記載されていますが、正確なパッケージ名とリポジトリの可用性はディストリビューションによって異なり、マニュアルは古いKopano Coreドキュメント世代を対象としています。過去のコマンドを適用する前に、現在のパッケージサポートを確認してください。

ソースコードからのインストールやコンテナを使用すると、バージョン管理やファイルシステムレイアウトをより細かく制御できます。ただし、これらの方法では、責任がオペレーターに移ります。つまり、Webサーバーで使用されるPHPランタイムと同じPHP拡張機能を利用できるようにし、状態やログを永続化し、再デプロイ後もActiveSyncルートにアクセスできるようにする必要があります。

2. Kopanoのバックエンドとサーバーアドレスを選択します。

メインの Z-Push 設定では、インストール済みのリリースでドキュメントに記載されている設定とクラス名を使用してBackendKopano、バックエンド プロバイダを Kopano バックエンドに設定します。パッケージ化されたデプロイメントでよく使用される設定は次のとおりです。パッケージに同梱されているサンプルを確認せずに、異なる構造の設定ファイルにこの設定を貼り付けないでください。Kopano サービスが同じホスト上にない場合、またはデフォルトのローカル接続でアクセスできない場合は、Kopano バックエンド設定で MAPI サーバー アドレスを設定します。

// Example only: confirm the setting and file path in your installed package.
define('BACKEND_PROVIDER', 'BackendKopano');

パッケージ化されたリリースによってファイル名や定数が異なる場合があります。機密情報は公開設定例から除外し、設定ファイルのアクセス権限を制限し、ApacheまたはPHP-FPMで使用されるPHPランタイムが必要なKopano MAPI拡張機能をロードできることを確認してください。コマンドラインPHP環境が正常に動作しているからといって、Web PHPランタイムで同じ拡張機能が有効になっているとは限りません。

3. ActiveSyncエンドポイントをHTTPS経由で公開する

クライアントは、ActiveSync ハンドラー用の安定した HTTPS URL を必要とします。これは通常、ホスト名の後に/Microsoft-Server-ActiveSync. が続く形式です。Apache、Nginx、または選択したリバースプロキシを設定して、そのパスを Z-Push のエントリポイントにルーティングします。正規エンドポイントは同じホスト名に維持し、リクエストメソッドを変更したり、モバイルクライアントを別のパスにリダイレクトしたりするようなリダイレクトは避けてください。Kopano ガイドでは、リダイレクトによってデバイスの同期が壊れる可能性があるため、エンドポイントを作成するために Z-Push ディレクトリの名前を変更することは特に避けるよう警告しています。

エンドポイントホスト名と一致する有効な証明書を使用してください。HTTPSは転送中の認証情報と同期データを保護し、多くの最新のモバイルクライアントは信頼できない証明書や不一致の証明書を拒否します。本番環境のアカウントでTLSを無効にすることで証明書の警告を回避しないでください。TLSがリバースプロキシで終了する場合は、プロキシが意図どおりにリクエストと認証関連のヘッダーを転送していること、およびプロキシからZ-Pushへの接続が社内セキュリティポリシーに従っていることを確認してください。

4. 書き込み可能状態とログの場所を設定する

Z-Push は、状態とログの場所に書き込み権限を持つ必要があります。www-data多くの Debian や Ubuntu のインストール環境のように、特定の Web サーバー アカウントにアクセス権を付与してください。サービス アカウントはディストリビューションによって異なります。これらのディレクトリをすべてのユーザーが書き込み可能にすることは避けてください。マルチホスト環境では、あるノード上のファイルが他のノードから見えることを前提とするのではなく、共有アクセスを前提とした状態管理メカニズムを選択してください。Kopano 管理者ガイドでは、状態ディレクトリのアクセス許可について説明し、Z-Push のアップグレード時に状態を保持する必要があることを指摘しています。

モバイルアカウントを設定する

電話機で、職場または Exchange アカウントを追加し、Exchange ActiveSync、Microsoft Exchange、またはクライアントが提供する同等のオプションを選択します。正確なラベルと画面は、オペレーティングシステムとメール アプリによって異なります。ユーザーのメールアドレスと認証情報を入力します。自動検出でサーバーが見つからない場合は、Z-Push ホスト名を入力し、必要に応じて ActiveSync エンドポイントを入力します。Kopano 認証設定で想定されているユーザー名形式を使用してください。メールアドレス全体と Kopano ログイン名が常に同じであるとは限りません。

SSL/TLS は有効のままにしておき、パスコードの要求や組織が管理するデバイス制御の適用など、デバイスポリシーで許可される内容を確認してからポリシーを受け入れてください。同期するカテゴリ（メール、連絡先、カレンダー、タスクなど）を選択してください（利用可能な場合）。旧バージョンのKopano モバイルデバイスガイドにはExchange アカウントの一般的なワークフローが記載されていますが、スクリーンショットやオペレーティングシステムのラベルは古くなっています。古いメニューパスをそのままコピーするのではなく、現在のスマートフォンのプロンプトに従ってください。

メールアプリに同期スケジュール機能がある場合、プッシュ通知または頻繁な更新は配信速度を向上させますが、バッテリー消費量とネットワーク負荷が増加する可能性があります。ポーリング間隔を長くするとバックグラウンドチェックは減りますが、新着メッセージの配信が遅れる場合があります。メールの受信タイミングが重要な業務アカウントの場合は、まずクライアントのプッシュ通知設定が有効になっていることを確認し、バッテリー消費量や組織の方針に基づいて調整してください。

デバイスを追加する前に、各レイヤーを確認してください。

1. エンドポイント：ブラウザで公開ホスト名を開き、TLS証明書が有効であることを確認してください。アカウントを追加する前に、ブラウザのエラーや証明書の警告を修正する必要があります。
2. ウェブルーティング： ActiveSyncのパスがリダイレクトループや一般的なウェブサーバーの404ページを経由することなく、Z-Pushハンドラーに到達することを確認してください。エンドポイントは通常のウェブサイトではなく、プロトコルハンドラーです。
3. バックエンド認証：テストアカウントを使用して、パスワードやトークンを公開することなく、Z-Pushのログにバックエンドへの接続が成功したことが表示されることを確認してください。
4. 初期同期：テスト用の電話機を1台追加し、選択したメールフォルダ、連絡先、カレンダー、タスクを確認してください。ログインが成功したからといって、すべてのデータタイプが正しく同期されているとは限りません。
5. 双方向の変更：スマートフォンでテスト用のカレンダーイベントを作成し、それがKopanoに表示されることを確認します。次に、Kopanoでテスト用の変更を行い、それがスマートフォンに反映されることを確認します。
6. 再起動と復元：計画されたテスト期間中にWebサービスを再起動し、同期が回復することを確認し、状態ディレクトリが破損していないことを確認します。

症状別にトラブルシューティングを行う

Z-Push独自のログとWebサーバー/PHPログを、同じタイムスタンプで照合して使用してください。新しいデバイスプロファイルをテストする必要がある場合は、まずサーバー側の状態リセットがご使用のリリースに適していることを確認し、完全な再同期がトリガーされるかどうかを理解してください。トラブルシューティングの最初のステップとして、状態ディレクトリ全体を削除しないでください。

どの構成を選択すべきでしょうか？

小規模な既存の Kopano Core インストールの場合、ディストリビューションでサポートされている Z-Push パッケージ セット、Kopano バックエンド、 1 つの HTTPS エンドポイント、および慎重に権限が設定されたローカル状態により、通常は可動部品を最小限に抑えることができます。分離または運用上の境界によって追加のネットワークおよび PHP-MAPI 互換性作業が正当化される場合は、別のホストを使用してください。共有状態アプローチを選択してテストした後でのみ、マルチホスト設計を使用してください。メール、カレンダー、または連絡先が Kopano の外部にある場合は、展開前に関連する Z-Push バックエンドを比較し、ユーザーが実際に使用するモバイル クライアントで各データ タイプをテストしてください。

Z-PushとKopanoのパッケージング、PHPサポート、およびデバイスの動作は、リリースごとに変更されます。インストール済みのパッケージのサンプル設定と、それに対応するリリースドキュメントを正式な情報源として扱ってください。古いKopanoマニュアルは概念を理解する上で役立ちますが、新しいシステムにそのままコピーしないでください。Z -Pushプロジェクトのリポジトリは、最新のプロジェクトコードとリリース情報の情報源です。