--- schema_version: "1" id: d1d3ec987ad2560edfd274964e4e47e4a01ecbec1eac3045b55ec65cd55bf569 title: Mail Session (Outlook with OAuth) collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/rpa-builder/6.5/toolbox-mail-operations-mail-session-outlook-with-oauth.md canonical_url: https://docs.mulesoft.com/jp/rpa-builder/6.5/toolbox-mail-operations-mail-session-outlook-with-oauth source_site: docs.mulesoft.com content_type: documentation content_hash: 8f9e5627113fadab9eb5365ce62c17222076e9fa0f5fa0ea4828255574d8be19 description: MuleSoft Documentation Site release: "6.5" latest: false --- # Mail Session (Outlook with OAuth) _Mail Session (Outlook with OAuth)_​ アクションステップは、MS Outlook を使用してメールサーバーへの接続を確立し、対応するアクションステップを使用して ​**Read Mail**​、​**Send Mail**​、(メールを変更するための) ​**Set Mail**​ などのメール操作を実行できるようにするメール操作の包括的な要素です。 ## [](#始める前に)始める前に Outlook 用のアプリケーションを作成するには、Azure アカウントが必要です。 ## [](#properties)プロパティ - **\[OAuth Authentication (OAuth 認証)\]**​ 設定 - **Pin OAuth Settings (OAuth 設定を固定)** [Credentials for OAuth](https://docs.mulesoft.com/jp/rpa-builder/6.5/toolbox-variable-handling-credentials-for-oauth)​ アクションステップで作成された OAuth ログイン情報を指定するには、このオプションを選択します。 - **Use custom settings (カスタム設定を使用)** このアクションステップのカスタム OAuth ログイン情報を指定するには、このオプションを選択します。 - **OAuth Host (OAuth ホスト)** ログイン情報の取得に使用されるホストアドレス。Outlook サービスのデフォルトのアドレスは、​`https://login.microsoftonline.com/common/oauth2/v2.0/`​ です。自己ホストサービスを使用する場合、このアドレスは変わる可能性があります。 - **Client ID (クライアント ID)** OAuth ホストで認証するには、各自の空間で Azure アプリケーションを定義する必要があります。この Azure アプリケーションには、OAuth ホスト空間全体で一意の ID があるため、ユーザーはこの Azure アプリケーションから各自のアカウントへのアクセス権を明示的に付与したり取り消したりできます。この Outlook 用の Azure アプリケーションを作成する方法についての詳細は、 [「クイック スタート: Microsoft ID プラットフォームにアプリケーションを登録する」](https://learn.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app)​を参照してください。 - **Client Secret (クライアントシークレット)** RPA Builder が登録された Azure アプリケーションの代わりにユーザーアカウントにアクセスする許可を得ていることを OAuth ホストに証明できます。この許可がないと、認証は使用できません。 - **Redirect URI (リダイレクト URI)** ユーザーが認証試行を完了した後に OAuth ホストがリダイレクトされる URI。このリダイレクト URI は Azure アプリケーションに登録されている必要があります。入力したリダイレクト URI と登録された URI が一致すると、OAuth ホストによって認証が許可されます。 - **Scopes (スコープ)** ユーザーが Azure アプリケーションに付与する権限を定義します。RPA Builder では、デフォルトで次の権限が要求されます。 - **offline\_access** (​**必須**​) 更新トークンを介してアクセスできます。これにより、その都度ユーザー操作を必要とせずに繰り返しメールサービスにログインできます。 - **https://outlook.office.com/IMAP.AccessAsUser.All** (IMAP を使用する場合は​**必須**​) Outlook IMAP サーバーからメールを読み取ったり、移動したりできます。 - **https://outlook.office.com/POP.AccessAsUser.All** (POP3 を使用する場合は​**必須**​) Outlook POP3 サーバーからメールを読み取ることができます。 - **https://outlook.office.com/SMTP.Send** (SMTP を使用する場合は​**必須**​) Outlook SMTP サーバーからメールを送信できます。 - **openid email** Azure アプリケーションにログインするために使用されるメールアカウントを RPA Builder で自動的に検出できます。このスコープを省略した場合は、ウィザードでメールを指定する必要があります。 - **Save data to generate Tokens via the Tools menu (\[Tools (ツール)\] メニューでトークンを生成するためのデータを保存)** 後で ​[で OAuth 更新トークンを生成](#generate-oauth-token)​するときに使用するために現在のデータを保存します。 - **Email address (メールアドレス)** RPA Builder によって認証試行でメールアドレスが検出されると、自動的に入力されます。​**openid email**​ スコープを省略した場合は、手動でメールアドレスを指定する必要があります。 - **\[Incoming Mail Operation (受信メール操作)\]**​ 設定 - **Protocol used (使用されたプロトコル)** (メールプロトコル) IMAP、Exchange、POP3 を使用する通信プロトコル。 - ​**Encryption used (使用された暗号化)** (暗号化) 使用する暗号化プロトコル (None (なし)、SSL/TLS、STARTTLS)。 - **Server address (サーバーアドレス)** (String (文字列)) ウィザードで入力されたサーバーアドレス。 - **Server Port (サーバーポート)** (Integer (整数)、デフォルト: `143`​) 選択されたポート。 - **\[Outgoing Mail Operation (送信メール操作)\]**​ 設定 - ​**Encryption used (使用された暗号化)** (暗号化) 使用する暗号化プロトコル (None (なし)、SSL/TLS、STARTTLS)。 - **SMTP Server address (SMTP サーバーアドレス)** (String (文字列)) 選択された SMTP メールサーバーの URL。 - **SMTP Server Port (SMTP サーバーポート)** (Integer (整数)) 選択されたポート。 - **Send test mail to (テストメールの送信先)** (String (文字列)) テストメールの送信先のメールアドレス。 ## [](#インバウンド変数)インバウンド変数 - **Incoming Mail (受信メール)** - **Server address (サーバーアドレス)** (String (文字列)) ウィザードで入力されたサーバーアドレス。 - **Server port (サーバーポート)** (Integer (整数)) 選択されたポート。 - **User account (ユーザーアカウント)** サーバーへのログインに必要なログインデータ。 - **Outgoing Mail (送信メール)** - **SMTP Server address (SMTP サーバーアドレス)** (String (文字列)) 選択された SMTP メールサーバーの URL。 - **SMTP User account (SMTP ユーザーアカウント)** SMTP サーバーへのログインに必要なログインデータ。 ## [](#アウトバウンド変数)アウトバウンド変数 _Mail Session_​ アクションステップには、アウトバウンド変数はありません。 ## [](#ウィザード)ウィザード ![Mail Session (Outlook with OAuth) アクションステップウィザード](/mulesoft/current/ja-jp/rpa-builder/6.5/_images/mail-session-outlook-oauth-wizard.png) ウィザードには、次のセクションがあります。 - **Operation Mode (操作モード)** - **OAuth Authentication (OAuth 認証)** - **Incoming Mail (受信メール)** - **Outgoing Mail (送信メール)** ### [](#operation-mode-操作モード)Operation Mode (操作モード) **\[Operation Mode (操作モード)\]**​ では、Mail Session で何を実行するのかと、どの領域をアクティブ化するのかを決定します。次のモードを使用できます。 - **Read and send mails (メールの読み取りおよび送信)** \[Incoming Mail (受信メール)\] 領域と \[Outgoing Mail (送信メール)\] 領域を設定できるようにします。 これにより、メールの読み取りと送信ができるようになります。 - **Read mails from inbox (受信ボックスからメールを読み取り)** \[Incoming Mail (受信メール)\] セクションを編集できるようにします。これにより、メールの読み取りのみができるようになります。 _\[Read mails from inbox (受信ボックスからメールを読み取り)\]_​ モードを選択した場合、Send Mail アクションステップは使用できません。 - **Send mails via SMTP (SMTP を介してメールを送信)** \[Outgoing Mail (送信メール)\] セクションを編集できるようにします。これにより、メールの送信のみができるようになります。 _\[Send mails via SMTP (SMTP を介してメールを送信)\]_​ モードを選択した場合、Mail Session で Read Mail アクションステップは使用できません。 ### [](#oauth-認証)OAuth 認証 **\[OAuth Authentication (OAuth 認証)\]**​ セクションでは、メールサーバーの認証にユーザーパスワードを使用しない一連のトークンを作成できます。更新トークンを作成したら、その更新トークンを使用して、ユーザーのパスワードを再度要求せずにサービスに繰り返しログインできます。 ログイン情報で認証する手順は、次のとおりです。 1. 必要なプロパティを指定して、​**\[OAuth Authentication (OAuth 認証)\]**​ 設定を完了します。 各プロパティについての詳細は、「​[\[OAuth Authentication (OAuth 認証)\] 設定](#properties)​」を参照してください。 2. **\[Authenticate (認証)\]**​ をクリックします。 このステップにより、OAuth ホストで認証プロセスが開始され、デフォルトのブラウザーでログインページが開きます。 異なるアカウントを使用してログインできるようにするため、メールセッション (OAuth を使用する Outlook) で ​**\[Authenticate (認証)\]**​をクリックすると、ブラウザーのCookie に保存されているログイン情報がクリアされます。 3. OAuth ホストのログインページで、ログインプロセスを完了します。 4. ブラウザーを閉じます。 最後のステップを完了すると、認証されたことがウィザードに表示されます。 ![認証設定ウィンドウの 「Logged in (ログイン済み)」 確認メッセージ](/mulesoft/current/ja-jp/rpa-builder/6.5/_images/email-outlook-authentication.png) #### [](#generate-oauth-token)OAuth 更新トークンの生成 **Mail Session (Outlook with OAuth) ウィザード**​で認証する代わりに、更新トークンを固定できます (外部で取得する場合)。この場合でも、残りの項目を入力または固定する必要があります。 更新トークンを生成および設定する手順は、次のとおりです。 1. **\[Tools (ツール)\]**​ メニューで、​**\[Generate OAuth Refresh Token (OAuth 更新トークンを生成)\]**​ を選択します。 ![「Tools (ツール)」 メニューの 「Generate OAuth Refresh Token (OAuth 更新トークンを生成)」 オプション](/mulesoft/current/ja-jp/rpa-builder/6.5/_images/generate-oauth-token.png) 2. 表示される ​**\[OAuth Token Creator (OAuth トークンクリエイター)\]**​ を完了します。 ![「OAuth Token Creator (OAuth トークンクリエイター)」 フォーム](/mulesoft/current/ja-jp/rpa-builder/6.5/_images/generate-token-form.png) すでに Mail Session (Outlook with OAuth) を設定していて、​**\[Save data to generate Tokens via the Tools menu (\[Tools (ツール)\] メニューでトークンを生成するためのデータを保存)\]**​ ボタンをクリックしている場合、ウィザードで最後に入力したデータが自動的に入力されます。 3. **\[Authenticate (認証)\]**​ をクリックします。 4. **\[Copy Token to Clipboard (トークンをクリップボードにコピー)\]**​ をクリックします。 5. 英数字のサーバーベースの変数にトークンを貼り付けます。 6. **Mail Session (Outlook with OAuth)**​ ウィザードで ​**\[Refresh Token (更新トークン)\]**​ 項目に変数を固定します。 **\[OAuth Token Creator (OAuth トークンクリエイター)\]**​ から他の値を固定することもできます。 サーバーベースの変数を使用すると、トークンが期限切れになった場合や、ユーザーが Microsoft からログアウトした場合でも、新しいバージョンのワークフローを RPA Manager にアップロードする必要がなくなります。その場合、​**\[OAuth Token Creator (OAuth トークンクリエイター)\]**​ を使用して同じユーザーの更新トークンを再生成し、RPA Manager で割り当てられたサーバーベースの変数を更新します。 ### [](#incoming-mail-受信メール)Incoming Mail (受信メール) **\[Incoming Mail (受信メール)\]**​ 領域では、メールサーバーからメールをインポートするために必要なすべての設定を行うことができます。​**\[Test Connection (接続をテスト)\]**​ ボタンを使用して、メールサーバーへの接続を確立できるかどうかをテストできます。 ### [](#outgoing-mail-送信メール)Outgoing Mail (送信メール) **\[Send mails (メールを送信)\]**​ チェックボックスをオンにした場合、​**\[Outgoing Mail (送信メール)\]**​ 領域が開きます。メールを送信するには、ここで SMTP メールサーバー設定を入力します。 **\[Send test mail (テストメールを送信)\]**​ ボタンを使用して、SMTP サーバーへの接続を確認し、​**\[Sendtest mail to (テストメールの送信先)\]**​ 項目で指定したメールアドレスにテストメールを送信できます。 ## [](#関連情報)関連情報 - [Read Mail](https://docs.mulesoft.com/jp/rpa-builder/6.5/toolbox-mail-operations-read-mail) - [Send Mail](https://docs.mulesoft.com/jp/rpa-builder/6.5/toolbox-mail-operations-send-mail) - [Set Mail](https://docs.mulesoft.com/jp/rpa-builder/6.5/toolbox-mail-operations-set-mail) - [Azure](https://azure.microsoft.com/en-us/) - [OAuth を使用して EWS アプリケーションを認証する](https://learn.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth) - [OAuth を使用して IMAP、POP、SMTP 接続を認証する](https://learn.microsoft.com/en-us/exchange/client-developer/legacy-protocols/how-to-authenticate-an-imap-pop-smtp-application-by-using-oauth)