Google カレンダー
Mitra は、他のカレンダーサーバーと同様に CalDAV 経由で Google カレンダーに接続します。異なるのはサインインです。Google はパスワードを受け付けず、独自のページでアクセスを許可させます。そのために Google があなたの Mitra サーバーを知っている必要があるので、サーバーを運営する人が一度だけ Google に登録し、発行されたクライアント ID とシークレットを Mitra に渡します。
その後は、Mitra を使う人それぞれがアプリから自分の Google アカウントを、個別の許可で接続します。セットアップは3つの手順です。
最初の2つは Mitra サーバーごとに一度だけ行います。
Mitra を Google に登録する
Section titled “Mitra を Google に登録する”-
Google Cloud コンソールでプロジェクトを作成し、API とサービスで CalDAV API を有効にします。
-
OAuth 同意画面を設定します。アカウントを接続する自分と全員をテストユーザーとして追加するか、アプリを公開します。
-
タイプウェブアプリケーションの OAuth クライアントを作成します。承認済みのリダイレクト URI には、あなたの Mitra サーバーのアドレスに
/api/integrations/google/callbackを続けたものを入力します。https://mitra.example.com/api/integrations/google/callback -
Google が表示するクライアント ID とクライアント シークレットをコピーします。
CAUTION
同意画面がテスト中の間、Google は各許可を7日で終了させるため、全員が毎週アカウントを接続し直す必要があります。アプリを公開すれば、許可はずっと有効です。
Mitra にクライアント ID とシークレットを渡す
Section titled “Mitra にクライアント ID とシークレットを渡す”これらを環境変数として、サーバーのアドレスである MITRA_URL と一緒に設定します。
services: mitra: image: ghcr.io/a11delavar/mitra:latest environment: MITRA_URL: 'https://mitra.example.com' MITRA_GOOGLE_CLIENT_ID: '….apps.googleusercontent.com' MITRA_GOOGLE_CLIENT_SECRET: '…' # …その後 Mitra を再起動します。
docker compose up -d変数は両方設定するか、両方設定しないかのどちらかです。クライアント ID だけでシークレットがない状態では Mitra は起動を拒否するので、中途半端な設定が見逃されることはありません。
MITRA_URL はリダイレクト URI のアドレスと一致している必要があります。これがなければ、Mitra は開かれたアドレスを使います。localhost で試す分にはそれで十分です。localhost 以外では Google が https:// のリダイレクトアドレスしか受け付けないため、実運用のサーバーには HTTPS と MITRA_URL が必要です。すべての変数は設定に一覧されています。
アカウントを接続する
Section titled “アカウントを接続する”- サイドバー下部の連携を追加を選び、Google カレンダーを選びます。
- Google で続行を押します。Google がアカウントの選択と、Mitra へのカレンダーの閲覧・変更の許可を求めます。
- Mitra に戻ると、アカウントのカレンダーがすべてオンの状態で一覧されます。不要なものをオフにして保存を押します。
同じ Google アカウントを再度接続しても二重には追加されず、許可が更新されます。
Google はアプリが呼び出せる頻度を制限しているため、Mitra は Google アカウントを約1分ごとに同期します(同期の仕組みを参照)。
共有されたカレンダー
Section titled “共有されたカレンダー”自分のカレンダーは接続と同時に現れます。チームや同僚のカレンダーなど、他の人が共有したカレンダーは、Google の設定で許可して初めて他のアプリに届きます。
- Google にサインインした状態で calendar.google.com/calendar/syncselect を開きます。
- 共有カレンダーで Mitra に取り込みたいカレンダーにチェックを付け、保存を押します。
- Mitra でサイドバーのアカウントの ⋯ メニューを開き、編集を選んで更新を押します。
- 現れたカレンダーをオンにして保存を押します。
すべての予定の詳細を表示で共有されたカレンダーは、Mitra では読み取り専用です。中身はすべて見えますが、予定の追加・変更・削除はできません。あとでオーナーが予定を変更の権限を与えれば、次の同期で編集できるようになります。読み取り専用カレンダーを参照してください。
同期されるもの
Section titled “同期されるもの”項目間の関連付けを除き、CalDAVと同じように同期されます。Google は予定のコピーから関連付けを取り除くため、Mitra は Google カレンダーでは関連付けを提供しません。
Google カレンダーの添付ファイルは、Google カレンダーで添付する Google ドライブのファイルです。Mitra はそれらを表示し、それぞれドライブで開けますが、追加も削除もできません。Google はドライブのファイルのみを保持し、他のアプリが追加した添付は破棄します。
Google カレンダーで予定ありにした対応可能時間は、そのカレンダーに予定ありの予定として追加され、他の人にもその時間が埋まっているように見えます。動作は CalDAV と同じです。
Google トークンについて
Section titled “Google トークンについて”Google が発行するトークンがサーバーの外に出ることはありません。ブラウザーが通るのはアクセスを許可する Google のページだけです。Mitra はトークンをアカウントと一緒に保持し、同期のたびに短期間のアクセスを得るために使います。
アカウントを切断する
Section titled “アカウントを切断する”アカウントとそのトークンを Mitra から取り除くには、アカウントの ⋯ メニューで削除を選びます。Google 側でも Mitra のアクセスを取り消すには、Google アカウントのサードパーティ接続から Mitra を削除します。それだけを行っても同期は止まります。アカウントは Mitra に残りますが、再接続するまで同期はすべて失敗します。
トラブルシューティング
Section titled “トラブルシューティング”- Google カレンダーを選んだときに Google で続行ボタンではなく「このサーバーでは設定されていません」という表示が出る場合は、
MITRA_GOOGLE_CLIENT_IDとMITRA_GOOGLE_CLIENT_SECRETが設定されていないか、設定後に Mitra が再起動されていません。 - Google が
redirect_uri_mismatchを返す場合は、Google Cloud コンソールのリダイレクト URI がMITRA_URLに/api/integrations/google/callbackを続けたものと一致していません。https://を含め、末尾のスラッシュも付けずに完全一致させる必要があります。 - 7日後にアカウントの同期が止まる場合は、同意画面がまだテスト中です。アプリを公開してから、アカウントを接続し直してください。