OAuth2を使用してGmailまたはMicrosoft 365をNextcloudメールに接続する

OAuth2 を使用して Gmail または Microsoft 365 を Nextcloud Mail に接続するには、メールプロバイダで Web アプリケーションを登録し、Nextcloud Mail のリダイレクト URI をその登録情報にコピーして、クライアント ID とシークレットを Nextcloud のグループウェア管理設定に保存します。次に、Mail でメールボックスを接続し、プロバイダのサインインプロンプトを承認します。正常に動作する設定では、単に認証成功画面を表示するだけでなく、受信メッセージを読み込み、テストメッセージを送信する必要があります。

アカウントとNextcloudのインストールがこの方法に対応していることを確認してください。

Nextcloud Mailは、メッセージの読み取りにIMAP、送信にSMTPを使用します。OAuth2はIDプロバイダーから許可を取得する仕組みであり、XOAUTH2はメールクライアントがこれらのメールサービスにアクセストークンを提示するために使用するメカニズムです。これは、Nextcloudへのログインをすべてのメールサーバーで共通のシングルサインオンにするものではありません。

Nextcloudの現在の管理ドキュメントでは、専用のGmail OAuthおよびMicrosoft Outlook XOAUTH2統合について説明しています。MicrosoftのサポートはMail 3.0.0で追加されました。メニューの文言はMailおよびNextcloudのリリースによって異なる場合があります。このチュートリアルは、 2026年10月に確認されたNextcloud 35 Mail管理マニュアルに基づいています。

• メールアプリがインストールされ、有効になっているブラウザから確実に開くHTTPSのNextcloud URLを使用してください。
• Nextcloudの管理者権限を持ち、Google CloudまたはMicrosoft EntraにOAuthアプリケーションを登録する権限が必要です。
• アカウントがGmail/Google Workspace、Outlook.com、またはExchange OnlineでホストされているMicrosoft 365メールボックスのいずれであるかを確認してください。
• 組織のポリシーに基づき、プロバイダがIMAPアクセスおよび送信時の認証済みSMTPを許可していることを確認してください。

重要な制限事項： OAuth2を受け入れるカスタムIMAPプロバイダーは、Nextcloud MailのGmail/Microsoft設定画面では自動的にサポートされません。汎用OAuth2プロバイダーに関するNextcloud Mailの機能リクエストには、この点について記載されています。別のプロバイダーを使用する場合は、無関係なGoogleまたはMicrosoftの認証情報を入力するのではなく、ご使用のMailのバージョンとサポートされている認証方法を確認してください。

適切なリダイレクトURIを使用してOAuthクライアントを登録する

GmailまたはGoogle Workspace

1. Nextcloudで管理者としてサインインし、「管理設定」→「グループウェア」を開き、「Gmail連携」を探します。インスタンスに表示されているリダイレクトURIをコピーしてください。他のユーザーのインストールからコピーしたURLが正しいとは限りませんのでご注意ください。
2. Google Cloud Consoleを開き、プロジェクトを選択または作成します。ワークスペース組織または外部ユーザーに合わせて、Google 認証プラットフォームの同意/ブランディングおよびオーディエンス設定を適切に構成します。アプリケーションがテスト段階にある場合は、テストユーザーを追加します。
3. ウェブアプリケーションタイプのOAuthクライアントを作成します。Nextcloudの正確なURLを「承認済みリダイレクトURI」に入力し、クライアントIDとクライアントシークレットを安全な場所に保存します。Googleは、スキーム、パス、大文字小文字、末尾のスラッシュを含め、リダイレクトURIが完全に一致することを要求します。
4. 認証範囲と公開要件を確認してください。GmailのIMAPおよびSMTP OAuthアクセスはhttps://mail.google.com/、Googleのユーザーデータおよび検証ポリシーの対象となる、広範囲にわたる制限付きスコープを使用します。管理者は、提案された使用がこれらの要件を満たすかどうかを判断する必要があります。

Google は、OAuth2 ウェブアプリケーションの手順と、 Gmail の XOAUTH2 スコープおよびプロトコルに関するドキュメントで、ウェブサーバーの登録フローを説明しています。テスト構成は初期検証に役立ちますが、テスト環境のままにしておく外部 OAuth アプリケーションは、通常、Gmail メールへのアクセスを要求すると、7 日後に期限切れとなる更新トークンを受け取ります。Googleのトークン有効期限に関するガイダンスを参照してください。そのため、毎週繰り返される再認証は、IMAP パスワードの破損ではなく、公開状態の制限を示している可能性があります。

Microsoft 365 または Outlook.com

1. Nextcloudの管理設定→グループウェアで、Microsoft統合を見つけて、表示されているリダイレクトURIをコピーします。
2. Microsoft Entra 管理センターで、 [アプリの登録]に移動し、登録を作成します。Nextcloud の標準ガイドに記載されているアカウントの種類については、組織用と個人用の両方の Microsoft アカウントを選択し、Webリダイレクト プラットフォームを使用して Nextcloud の URI を正確に入力します。
3. アプリケーション（クライアント）IDをコピーします。「証明書とシークレット」でクライアントシークレットを作成し、シークレット識別子ではなく、その値をすぐにコピーします。運用カレンダーに有効期限を記録しておきます。
4. プロバイダの IMAP および SMTP OAuth フローに必要なメール関連の委任アクセス許可を、必要に応じて組織の同意を得た上で使用してください。Microsoft は、更新トークンのスコープとスコープについてドキュメント化していますIMAP.AccessAsUser.All。SMTP.Sendこれらoffline_accessのプロトコルアクセス許可を、Microsoft Graph の Mail.Read/Mail.Send アクセス許可と混同しないでください。

登録の詳細については、Microsoft のアプリ登録に関するドキュメントとExchange Online の IMAP/SMTP OAuth の手順を参照してください。Nextcloud の一般的な設定に関するドキュメントでは、テナントフィールドは空のままになっていますcommon。テナント固有の値またはサポート対象のユーザー範囲を狭く設定する場合は、管理者が関連するアカウントの種類とポリシーの変更を確認した場合にのみ使用してください。

Nextcloudに認証情報を保存し、メールボックスを接続します。

1. 管理設定 → グループウェアに戻ります。プロバイダーのクライアントIDとクライアントシークレットを、対応するGmail連携またはMicrosoft連携セクションに貼り付けて保存します。シークレットをリダイレクトURIフィールドに入力したり、スクリーンショット、チケット、バージョン管理システムに公開したりしないでください。
2. 目的のメールボックスユーザーとしてサインインし、「メール」を開いて、メールアカウントの追加を選択します。メールアドレスを入力し、最初に自動アカウント構成を選択して接続を開始します。Nextcloudのドキュメントに記載されているMicrosoftフローでは、パスワード入力欄が表示される場合があります。入力されたプレースホルダーは、プロバイダーのOAuthが構成されると破棄されます。実際のアカウントパスワードを不必要に入力しないでください。
3. プロバイダーのポップアップウィンドウで、適切なGoogleまたはMicrosoftのIDを選択し、要求されたアクセス権限を確認して、組織で承認されている場合は同意してください。ブラウザのポップアップを許可し、プロバイダーがリダイレクトした後、元のNextcloudタブに戻ってください。
4. 自動設定で誤ったサーバーが選択された場合は、そのプロバイダのIMAPおよびSMTPホスト名と暗号化オプションを手動で確認してください。OAuthボタンは、認識済みのGmail/Microsoftエンドポイントに関連付けられています。手動で入力した無関係なホスト名では、期待どおりのサインインフローが開始されない場合があります。

Nextcloudメールアカウントフォームでは、OAuthが設定されたGoogleエンドポイントが認識されている場合は「Googleでサインイン」と表示され、Microsoftエンドポイントが認識されている場合は「Microsoftでサインイン」と表示されます。これらの条件付きラベルについては、Nextcloudメールアカウントフォームの実際のソースコードで確認できます。プロバイダ固有のボタンが表示されることは、Nextcloudが意図した統合を認識したことを示す便利な初期兆候ですが、認証やメールボックスへのアクセスが完了したことを証明するものではありません。

発生した段階に応じて障害を解決する

Microsoft は、Exchange Online の SMTP 認証に関するドキュメントで、メールボックスごとのオーバーライドを含む SMTP 認証制御について説明しています。特定のメールボックスを機能させるためだけにメールのセキュリティを全体的に弱めることは避けてください。ポリシーでプロトコルが禁止されている場合は、承認済みのメール クライアントまたは組織がサポートするワークフローを使用してください。

メールの流れの双方向を確認してください

1. Nextcloud Mailの受信トレイを開き、ページを更新して、最近受信したメッセージが、送信者、件名、内容が期待どおりに表示されていることを確認してください。
2. 管理している別のメールボックスに短いテストメールを送信してください。そこで配信を確認した後、Nextcloud Mailの送信済みフォルダを確認してください。これにより、SMTPの権限の問題とIMAPの同期の問題を区別できます。
3. 一度ログアウトしてから再度ログインし、メールアプリを再度開いてください。運用環境においては、アクセストークンが通常更新されるはずの期間が経過した後に再度確認してください。すぐに成功したとしても、トークンが長期的に更新されたとは限りません。

受信トレイの同期がそれでも失敗する場合は、Nextcloud のドキュメントをocc mail:account:export参照してメール アカウント ID を確認し、occ mail:account:sync -vvv ACCOUNT_ID的を絞ったトラブルシューティングを行ってください。グループウェアのトラブルシューティング マニュアルには、アカウントごとの IMAP/SMTP デバッグ ログについても説明されており、ログには機密情報が含まれている可能性があると警告しています。必要な情報のみをキャプチャし、共有する前にトークンとアドレスを編集し、その後詳細なデバッグをオフにしてください。

プロバイダーの同意が完了し、メールが現在のメッセージを取得でき、送信メールが宛先に届き、接続が繰り返し認証プロンプトなしで使用可能な状態を維持できれば、セットアップは使用準備完了です。これらのチェックのいずれかが失敗した場合は、OAuthアプリケーション全体をすぐに再作成するのではなく、その特定の段階のトラブルシューティングを行ってください。