# １．メール基本設定を行う

ConMas Managerの上部メニュー「システム管理」 ＞ 「メール設定通知」をクリックし、「メール基本設定」画面を表示します。\
こちらの画面で、メール通知で使用する認証タイプ（「SMTP認証」 OR 「OAuth」）、メールサーバー、メールサービスなどの設定を行います。&#x20;

設定を行うには、画面右上の 「編集」ボタン をクリックします。

<div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FRifRsNPTpo481wlW4zac%2Fimage.png?alt=media&#x26;token=aaf14570-7553-49ed-97f1-e4f23789268b" alt=""><figcaption></figcaption></figure></div>

## **認証タイプの決定**

「SMTP認証」、「OAuth」どちらかを選択します。

{% hint style="success" %}
8.0.22090より従来のSMTP認証だけではなく、OAuth認証もご利用いただけます。
{% endhint %}

「OAuth」に対応しているプロバイターは以下の２つです。

* Google（Gmail）
* Microsoft（Microsoft365）

**SMTP認証設定**

<div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2F3A8bRzNhz4amPG59bd2W%2Fimage.png?alt=media&#x26;token=88a465b5-69e5-46dd-be50-439478ac0665" alt=""><figcaption></figcaption></figure></div>

**OAuth設定**

<div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FHxwIjEl2acBQH2VriTAG%2Fimage.png?alt=media&#x26;token=9296ee28-7502-43bf-96ee-4ce2c25b16bb" alt=""><figcaption></figcaption></figure></div>

## **SMTP認証設定**

「メール基本設定編集」画面で「SMTP認証」を選択し、以下項目を設定します。

* **サーバー：**\
  SMTPサーバー（メールサーバードメイン　または IPアドレス）を設定します。<br>

* **ポート番号：**\
  ポート番号を設定します。&#x20;

  <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>ポート番号を設定する際の注意点について、詳細は 「<a href="#ptoniokeru">ポート設定における注意事項</a>」 をご参照ください。</p></div>

* **ユーザー：**\
  送信元のメールアドレスを設定します。\
  ※RFC2821に準拠していないメールアドレス形式は設定時エラーとなりご利用いただけません。<br>

* **パスワード：**\
  ユーザーに対応したパスワードを設定します。 <br>

* **SSL：**\
  TLS(SSL)暗号化する場合は、チェックします。

{% hint style="warning" %}
Microsoft、Googleのメールサービスをご利用のお客様

2022/9月現在、SMTP認証は非推奨となっています。\
「OAuth」へ設定変更することをご検討ください。
{% endhint %}

### **ポート設定における注意事項**

i-Reporterメール通知の制限は下記の通りです。

* **SMTP認証のみ対応**\
  POP Before SMTPはご利用いただけません。<br>
* **ポート465は非対応**\
  非暗号ポートである25, 暗号化代替ポート587をご利用ください。

　　587：暗号化代替ポート　→　SSLを使用する\
　　25  ：非暗号ポート　→　SSLを使用しない\
　　465：一般的な暗号化ポート　→　i-Reporterシステム非対応

## **OAuth（Microsoft）設定**

Microsoftで「OAuth」によるメール通知を行うには、Azureポータルで以下設定が必要です。

【設定の流れ】

* アプリの登録
* クライアントシークレット作成
* APIのアクセス許可
* ConMas Manager メール基本設定

### **アプリの登録**

【手順】

1. WebブラウザーでAzureポータルを開き、「アプリの登録（App registrations）」 ＞ 「新規登録」 をクリックします。

2. 以下を入力し、「登録」をクリックします。

   * 名前：\
     任意の名前
   * サポートされているアカウントの種類：\
     「この組織ディレクトリのみに含まれるアカウント」&#x20;
   * リダイレクトURI：\
     「Web」 を選択\
     http(s)://(ホスト名 OR IPアドレス)/ConMasManager\[識別子]/System/MailOAuthMicrosoft

     <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>[識別子]は弊社クラウド版(お試し環境を含む)のお客様のみ設定する必要があります。<br>[識別子]は、お客様がご利用中のConMas Manager URLから確認することができます。</p><p>■ConMas ManagerのURLが下記の場合</p><p>https://conmas-i-reporter.com/ConMasManager<mark style="background-color:yellow;">0001</mark><br>　→識別子は <mark style="background-color:yellow;">0001</mark> の部分です。</p><p>https://conmas-i-reporter.com/ConMasManager<mark style="background-color:yellow;">0002</mark><br>　→識別子は <mark style="background-color:yellow;">0002</mark> の部分です。</p></div>

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FwNRneKB2bDdD9x7zbMQn%2Fimage.png?alt=media&#x26;token=013bcc27-40ca-4491-a6ae-89455f6b915a" alt=""><figcaption></figcaption></figure></div>

3. 作成したアプリの「概要」から、「アプリケーション(クライアント)ID」と「ディレクトリ(テナント)ID」をコピーして保持します。

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FcwCSmDqLyXsr1vkFDOVq%2Fimage.png?alt=media&#x26;token=a9e1c880-cad6-488b-aea8-aa285a8ecdf3" alt=""><figcaption></figcaption></figure></div>

### **クライアントシークレット作成**

【手順】

1. 「証明書とシークレット」から「新しいクライアントシークレット」をクリックします。

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FEUNnOlJmGzez9I7kMYAZ%2Fimage.png?alt=media&#x26;token=82f13649-cf39-4ccf-819c-bf234ebb4a2e" alt=""><figcaption></figcaption></figure></div>

2. 「クライアント シークレットの追加」ダイアログで、説明と有効期限を入力してクライアントシークレットを作成します。

   * 説明：任意の文字列&#x20;
   * 有効期限：任意の期限&#x20;

     <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>期限が切れると、メール通知はできなくなります。<br>期限切れの場合は、再度クライアントシークレットを作成してください。</p></div>

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FJcu9xNbrkWVstTcAc9j4%2Fimage.png?alt=media&#x26;token=f8daf7f5-12db-4534-8fc6-89e1dd98a120" alt="" width="563"><figcaption></figcaption></figure></div>

3. 作成されたクライアントシークレットをコピーし、保持します。

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>クライアントシークレットの値は作成直後しか表示されません。<br>保持できなかった場合は再度作成してください。</p></div>

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FIlceiHo2tsq1IyMwKUyP%2Fimage.png?alt=media&#x26;token=d6febc75-bf13-4b6a-9dea-5079f60869ff" alt=""><figcaption></figcaption></figure></div>

### **APIのアクセス許可**

【手順】

1. 「APIのアクセス許可」から「アクセス許可の追加」をクリックします。

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FjntMxqmon6kkDNIiPuVk%2Fimage.png?alt=media&#x26;token=b25669e4-e097-4fe8-89ae-6e8c6ecf3780" alt=""><figcaption></figcaption></figure></div>

2. 「APIのアクセス許可の要求」ダイアログで「Microsoft Graph」をクリックします。

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FaCGIkfqGC1rQaaWoMVh1%2Fimage.png?alt=media&#x26;token=009e1fb2-440a-4828-ad04-45632912b512" alt=""><figcaption></figcaption></figure></div>

3. 「委任されたアクセス許可」をクリックします。

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FqDTP3muaBaTkUPooTgJK%2Fimage.png?alt=media&#x26;token=4a7569e9-e712-4ca7-b6af-612e45fd9cd1" alt=""><figcaption></figcaption></figure></div>

4. 以下のアクセス許可を選択して、「アクセス許可」をクリックします。

   * email
   * offline\_access
   * openid
   * Mail.Send
   * User.Read

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FYBe2YjpTOXkOKzbrHDDU%2Fimage.png?alt=media&#x26;token=ecb28115-6c1a-4070-8e2f-aae95e642479" alt=""><figcaption></figcaption></figure></div>

以上で、Azureポータルでの設定は完了です。\
ConMasMangerの「メール基本設定」へ戻ります。

### **Managerメール基本設定（OAuth設定）**

「メール基本設定編集」画面で「OAuth」を選択し、以下項目を設定します。

* プロバイター：「Microsoft」
* クライアントID：保持したクライアントID
* クライアントシークレット：保持したクライアントシークレット
* テナントID：保持したテナントID

<div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2F2lbPMXIlHUP4xhnZX77C%2Fimage.png?alt=media&#x26;token=50c294a7-dae9-4411-9ebe-f89ce9a1baee" alt=""><figcaption></figcaption></figure></div>

## **OAuth（Google）設定手順**

Googleで「OAuth」によるメール通知を行うには、Google側で以下設定が必要です。

【設定の流れ】

* プロジェクトの作成
* Gmail APIの有効化
* OAuth認証情報作成
* ConMas Manager メール基本設定

### **Google プロジェクトの作成**

【手順】

1. Webブラウザーで、Google Cloud Consoleの「APIとサービス」へアクセスします。

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>このときログインするユーザーが、メール通知の送信者となります。</p></div>

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>▼Google Cloud＞「APIとサービス」</p><p><a href="https://console.cloud.google.com/apis">https://console.cloud.google.com/</a></p><p>※Googleの設定画面、URLは変更されることがあります。</p></div>

   <br>
2. 既存のプロジェクトを選択するか、新しいプロジェクトを作成します。

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2F5f0rV8uIBmIwjU4TX6jO%2Fimage.png?alt=media&#x26;token=4a2e1935-c762-462a-a865-07ce655fa2e2" alt=""><figcaption></figcaption></figure></div>

### **Google Gmail APIの有効化**

【手順】

1. Google Cloud Consoleの「APIとサービス」へアクセスします。

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FeA1XeDF6PFK91kfHVg5I%2Fimage.png?alt=media&#x26;token=f45127ba-4d92-4c8a-9db7-93a1f2828c21" alt=""><figcaption></figcaption></figure></div>

2. 「Gmail API」を開き「有効にする」をクリックします。

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2F0x3ybUC8bOron6T0ECmU%2Fimage.png?alt=media&#x26;token=ab354260-7505-452f-ae83-ee22cd7d3c1b" alt=""><figcaption></figcaption></figure></div>

### **Google 認証情報の作成**

【手順】

1. 「認証情報」から「認証情報を作成」をクリックして「OAuthクライアントID」を選択します。

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FOxYhlT1qR57VSZVzN01X%2Fimage.png?alt=media&#x26;token=faa03ee1-b34a-43a1-8717-59084081bcbd" alt=""><figcaption></figcaption></figure></div>

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>【注意】</p><p>「OAuthクライアントID」作成時に同意画面での設定を求められた場合は、画面の案内に従って、「プロジェクト構成」画面で下記のように設定を行います。</p><ul><li><strong>①アプリ情報</strong><br>アプリ名：任意<br>ユーザーサポートメール：プルダウンメニューより選択</li><li><strong>②対象</strong><br>「内部」を選択</li><li><strong>③連絡先情報</strong><br>任意のメールアドレスを設定</li><li><strong>④同意の確認</strong><br>「同意します」にチェック</li></ul></div>

   \ <br>

2. 以下情報を入力して「作成」をクリックします。

   * アプリケーションの種類:：\
     ウェブアプリケーション
   * 名前：\
     &#x20;任意の名前&#x20;
   * 承認済みのリダイレクト URI： \
     http(s)://(ホスト名)/ConMasManager\[識別子]/System/MailOAuthGoogle

     <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>[識別子]は弊社クラウド版(お試し環境を含む)のお客様のみ設定する必要があります。<br>[識別子]は、お客様がご利用中のConMas Manager URLから確認することができます。</p><p>■ConMas ManagerのURLが下記の場合</p><p>https://conmas-i-reporter.com/ConMasManager<mark style="background-color:yellow;">0001</mark><br>　→識別子は <mark style="background-color:yellow;">0001</mark> の部分です。</p><p>https://conmas-i-reporter.com/ConMasManager<mark style="background-color:yellow;">0002</mark><br>　→識別子は <mark style="background-color:yellow;">0002</mark> の部分です。</p></div>

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FvoP8Wrr9hEM2edjmQ5rR%2Fimage.png?alt=media&#x26;token=d1ee8db7-ebdd-47c7-afee-2d84ff0a604f" alt=""><figcaption></figcaption></figure></div>

3. 作成されたクライアントIDとクライアントシークレットをコピーして保持します。

   <div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FpCAp7Ygstwty2eS3cOsj%2Fimage.png?alt=media&#x26;token=80a76706-cc1a-4802-be81-a5c3f6eb9905" alt="" width="375"><figcaption></figcaption></figure></div>

Google側での設定は完了です。\
ConMasMangerのメール基本設定へ戻ります。

### **Managerメール基本設定　(OAuth設定)**

「メール基本設定編集」画面で「OAuth」を選択し、以下項目を設定します。

* プロバイター：「Google」&#x20;
* クライアントID：前のページで保持したクライアントID&#x20;
* クライアントシークレット：前のページで保持したクライアントシークレット

<div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2Fw3xTIgVn4uUwIJt07BzT%2Fimage.png?alt=media&#x26;token=aee614c9-2d90-42f5-bdc6-23f9f3ca2ab7" alt=""><figcaption></figcaption></figure></div>

## **ManagerRootの設定**

{% hint style="success" %}
SMTP認証、OAuth（Microsoft・Google）すべてに共通する操作です。
{% endhint %}

「メール基本設定編集」画面にて、「ManagerRoot」にManager接続先URLを設定してください。

デフォルトでは”http\://{0}/ConMasManager”となっています。\
※{0}はサーバーのIPアドレスが自動でセットされます。

<div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FDZAa1NEbqS5VqGpsHyjE%2Fimage.png?alt=media&#x26;token=318d7052-3ed3-4309-beed-b16231cb2b2c" alt=""><figcaption></figcaption></figure></div>

**Cimtopsクラウド版（お試し環境含む）をご利用中の場合**

ManagerRootは下記となります。

`http(s)://[ホスト名 OR IPアドレス]/ConMasManager[識別子]`

{% hint style="success" %}
\[識別子]は弊社クラウド版(お試し環境を含む)のお客様のみ設定する必要があります。\
\[識別子]は、お客様がご利用中のConMas Manager URLから確認することができます。

■ConMas ManagerのURLが下記の場合

<https://conmas-i-reporter.com/ConMasManager><mark style="background-color:yellow;">0001</mark>\
　→識別子は <mark style="background-color:yellow;">0001</mark> の部分です。

<https://conmas-i-reporter.com/ConMasManager><mark style="background-color:yellow;">0002</mark>\
　→識別子は <mark style="background-color:yellow;">0002</mark> の部分です。
{% endhint %}

<br>

**オンプレミス環境をご利用中の場合**

ManagerRootは下記となります。

`http(s)://{HostName or IP Address}/ConMasManager`

{% hint style="warning" %}
通知テンプレートで使用できる「データ置き換え一覧」中のコード「rep\_url」を利用する際などに、 ManagerRootに{0}を指定しても意図したIPアドレスへ置き換わらない場合があります。その際はIPアドレスを手動設定してください。
{% endhint %}

## **通知可否と署名**

{% hint style="success" %}
SMTP認証、OAuth（Microsoft・Google）すべてに共通する操作です。
{% endhint %}

<div align="left"><figure><img src="https://4160910761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrPRHAuKx4VJ6H3E84OZ%2Fuploads%2FQ4CHtMSXrUwliA4uDDFy%2Fimage.png?alt=media&#x26;token=a8eda143-3621-4f60-b543-d87f61d91d7b" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
認証タイプがOAuthの場合、それぞれのメールプロバイダの認証画面へ遷移しますので、許可（承諾）してください。
{% endhint %}
