Azure OAuthを使用してMicrosoft Outlook 365をOdooに接続する¶

OdooはMicrosoftのAzure OAuth for Microsoft 365と互換性があります。AzureプラットフォームとOdooデータベースのバックエンドでいくつかの設定を行うだけで、カスタムドメインからセキュアなメールを送受信できます。この設定は、個人メールアドレスまたはカスタムドメインで作成されたアドレスのどちらでも動作します。

Microsoft Azureポータルでのセットアップ¶

新規アプリケーションを作成¶

開始するには、Microsoft's Azure Portal にアクセスします。もし Microsoft Outlook Office 365 アカウントがあればそれでログインし、なければ個人の Microsoftアカウント でログインします。Azure設定の管理者権限を持つユーザが接続し、以下の設定を実行する必要があります。次に、Microsoft Entra ID管理 (正式には Azure Active Directory) というセクションに移動します。

次に、トップメニューの 追加 (+) をクリックし、アプリ登録 を選択します。アプリケーションの登録`画面で、 :guilabel:`名前 を Odoo などのわかりやすい名前に変更します。:guilabel:`サポートされるアカウントの種類`セクションで、:guilabel:`組織ディレクトリ(Microsoft Entra IDディレクトリ - マルチテナント)内のアカウント`とMicrosoft個人アカウント(例：Skype、Xbox)`を選択します。

Under the Redirect URL section, select Web as the platform, and then input https://<web base url>/microsoft_outlook/confirm in the URL field. The web.base.url is subject to change depending on the URL used to log in to the database.

After the URL has been added to the field, Register the application, so it is created.

API許可¶

次に API許可 を設定します。Microsoft 365のセットアップでEメールの読み込み(IMAP)と送信(SMTP)を行うには、Odooに特定のAPI許可が必要です。まず、左のメニューバーにある API許可 リンクをクリックします。次に、(+)許可を追加 ボタンをクリックし、よく使われるMicrosoft API`の下にある :guilabel:`Microsoft Graph を選択します。その後、 委任アクセス許可 オプションを選択します。

検索バーで以下の 委任アクセス許可 を検索し、それぞれ 許可を追加 をクリックします:

• SMTP.Send

• IMAP.AccessAsUser.All

ユーザとグループの割当¶

API許可を追加した後、左サイドバーメニューの一番上にある アプリケーション の 概要 に戻って下さい。

このアプリケーションにユーザを追加します。:guilabel:`エッセンシャル`の概要テーブルの下にある、:guilabel:`ローカルディレクトリの管理アプリケーション`と書かれたリンク、またはテーブルの右下にある最後のオプションをクリックします。

左サイドバーのメニューから ユーザとグループ を選択します。次に (+) ユーザ/グループを追加 をクリックします。アカウントによって、グループ`と:guilabel:`ユーザ`を追加することも、:guilabel:`ユーザ`だけを追加することもできます。個人アカウントでは :guilabel:`ユーザ しか追加できません。

Under Users or Groups, click on None Selected and add the users or group of users that will be sending emails from the Microsoft account in Odoo. Add the users/groups, click Select, and then Assign them to the application.

認証情報の作成¶

Microsoft Azureアプリが設定されたので、Odooの設定用に認証情報を作成する必要があります。これには クライアントID と クライアントシークレット が含まれます。まず、アプリの 概要 ページから クライアントID をコピーします。クライアントID または アプリケーションID は、アプリの エッセンシャル 概要の 表示名 の下にあります。

次に クライアントシークレット値 を取得する必要があります。この値を取得するには、左サイドバーメニューの 認証 & シークレット をクリックして下さい。次に クライアントシークレット を作成する必要があります。そのためには (+) 新規クライアントシークレット ボタンをクリックします。

右側のウィンドウに クライアントシークレットを追加 というボタンが表示されます。guilabel:`説明`の下に`Odooフェッチメール`または何かわかるものを入力し、:guilabel:`有効期限日`を設定します。

次に、これら2つの値が入力されたら 追加 をクリックします。guilabel:クライアントシークレット値`と:guilabel:`シークレットID`が作成されます。:guilabel:`値 または クライアントシークレット値 は、このページを離れると暗号化されるので、メモ帳にコピーしておくことが重要です。:guilabel:`シークレットID`は必要ありません。

これらのステップの後、以下の項目がOdooで設定できる状態になります:

• クライアントID (クライアントID または アプリケーションID)

• クライアントシークレット (値 または クライアントシークレット値)

これで Microsoft Azure Portal 側の設定は完了です。

Odooでのセットアップ¶

Microsoft Outlook認証情報を入力する¶

まずOdooデータベースを開き、 アプリ`モジュールに移動します。次に、検索バーから :guilabel:`アプリ フィルタを削除し、Outlook と入力して下さい。その後、:guilabel:`Microsoft Outlook`というモジュールをインストールします。

次に 設定 ‣ 一般設定 に移動し、 ディスカス セクションの下にある カスタムEメールサーバ のチェックボックスにチェックが入っていることを確認します。これにより Outlook 認証情報 の新しいオプションが入力されます。

進捗を:guilabel:`保存`します。

次に、 クライアントID (アプリケーションID) と クライアントシークレット (クライアントシークレット値) をそれぞれのフィールドにコピー＆ペーストし、 保存 して下さい。

送信メールサーバの設定¶

:guilabel:`一般設定`ページの :guilabel:`カスタムEメールサーバ`設定の下にある :guilabel:`送信Eメールサーバ`リンクをクリックして、Microsoftアカウントを設定します。

次に、新しいEメールサーバを作成し、:guilabel:`Outlook`にチェックを入れます。次に、:guilabel:`名前`(何でもかまいません)とMicrosoft OutlookのEメールの:guilabel:`ユーザ名`を入力します。

If the From Filter field is empty, enter either a domain or email address.

次に、:guilabel:`Outlookアカウントに接続`をクリックします。

Microsoftの新しいウィンドウが開き、:guilabel:`認証プロセス`が完了します。Odooで設定されている適切なEメールアドレスを選択して下さい。

次に、はい`をクリックしてOdooがMicrosoftアカウントにアクセスすることを許可します。この後、ページはOdooで新しく設定された :guilabel:`送信メールサーバ に戻ります。設定は自動的にOdooに トークン をロードし、 Outlookトークン有効 というタグが緑色で表示されます。

最後に 接続テスト をクリックします。確認メッセージが表示されます。これでOdooデータベースはOAuth認証を使ってMicrosoft Outlookから安全でセキュアなEメールを送信できるようになりました。

単一の送信メールサーバでの設定¶

単一の送信サーバを設定することは、Microsoft Azureで利用可能な最も単純な設定であり、データベース内のユーザ用に広範なアクセス権を必要としません。

一般的なEメールアドレスはデータベース内の全てのユーザにEメールを送信するために使用されます。例えば、通知 エイリアス (notifications@example.com) や 問い合わせ エイリアス (contact@example.com) で構成することができます。このアドレスはサーバ上で :guilabel:フィルタリングから` として設定する必要があります。また、このアドレスはシステムパラメータの {mail.default.from}@{mail.catchall.domain} キーの組み合わせと一致している必要があります。

この設定を使用すると、データベースから送信されるEメールには、設定された`通知`メールボックスのアドレスが使用されます。ただし、送信者の名前は表示されますが、Eメールのアドレスは変更されることに注意して下さい。

ユーザ別(複数ユーザ)設定¶

一般的なEメールサーバに加えて、データベース内のユーザに対して個別のEメールサーバを設定することができます。この設定が機能するためには、個々のサーバに フィルタリングから としてこれらのEメールを設定する必要があります。

この設定は、メールサーバへの接続を確立するために、メールサーバで構成された全てのユーザが設定へのアクセス権を持つ必要があるという点で、Microsoft Azureの2つの設定のうち、より難易度の高い設定です。

セットアップ¶

Each user should have a separate email server set up. The FROM Filtering should be set so that only the user's email is sent from that server. In other words, only a user with an email address that matches the set FROM Filtering is able to use this server.

フォールバックサーバ が 通知 の送信を許可するように設定されている必要があります。このサーバの フィルタリングから は {mail.default.from}@{mail.catchall.domain} の値でなければなりません。

受信メールサーバの設定¶

受信アカウントは送信Eメールアカウントと同様の方法で設定する必要があります。技術メニュー`の :guilabel:`受信メールサーバ に移動し、新しい設定を作成します。guilabel:Outlook Oauth認証`の横にあるボタンをチェックするか選択し、 :guilabel:`Microsoft Outlookのユーザー名`を入力します。 guilabel:`Outlookアカウントに接続`をクリックします。Odooが :guilabel:`Outlookトークン有効 と表示しますので、 テスト・確認 をクリックします。アカウントはOdooデータベースにメールを受信する準備ができているはずです。