11.5. IM-LogicDesigner のメール受信タスクで OAuth2.0 アクセストークン を使用する¶

11.5.1.1. サービスの設定¶

11.5.1.2. プロバイダ情報を設定する¶

1. IM-Juggling プロジェクトの「追加機能」 - 「外部システム連携機能」 - 「 OAuth クライアント 」モジュールを選択します。

   

2. 「設定ファイル」タブを開き、「 OAuth クライアント 」 - 「メールサーバOAuth2認証設定」を選択して「出力」ボタンをクリックします。

   

3. 「メールサーバOAuth2認証設定」を利用するサービスにあわせて設定します。

   • Gmail API を利用する場合

     Gmail API を利用する場合は設定ファイルの以下の部分のコメントアウトを外し、各項目の設定を行って保存します。

       <oauth-provider id="Please_input_your_ID">
         <provider-type>extra</provider-type>
         <name message-cd="CAP.Z.IWP.OAUTHCLIENT.GMAIL.XOAUTH.NAME">Gmail API</name>
         <description message-cd="CAP.Z.IWP.OAUTHCLIENT.GMAIL.XOAUTH.DESCRIPTION">It is allow the use of the Gmail API.</description>
         <icon-path>im_oauth_client/images/gmail.png</icon-path>
         <oauth-config>
           <authz-end-point>https://accounts.google.com/o/oauth2/auth</authz-end-point>
           <token-end-point>https://oauth2.googleapis.com/token</token-end-point>
           <client-id>[Please input your application's Client ID]</client-id>
           <client-secret>[Please input your application's Client Secret]</client-secret>
           <scope>https://mail.google.com/</scope>
         </oauth-config>
         <extra-config>
           <parameter name="access_type">offline</parameter>
         </extra-config>
       </oauth-provider>
     

     oauth-provider@id	任意のIDを設定します。
     client-id	Google Cloud Platform で作成したプロジェクトの認証情報のクライアントIDを設定します。
     client-secret	Google Cloud Platform で作成したプロジェクトの認証情報のクライアントシークレットを設定します。
     scope	利用用途にあわせて必要に応じて変更します。 詳しくは Gmail scopes を参照してください。

• Exchange Online を利用する場合

  Exchange Online を利用する場合は設定ファイルの以下の部分のコメントアウトを外し、各項目の設定を行って保存します。

    <oauth-provider id="Please_input_your_ID">
      <provider-type>standard</provider-type>
      <name message-cd="CAP.Z.IWP.OAUTHCLIENT.EXCHANGE.NAME">Exchange Online Provider</name>
      <description message-cd="CAP.Z.IWP.OAUTHCLIENT.EXCHANGE.DESCRIPTION">It is allow the use of Exchange Online.</description>
      <icon-path>im_oauth_client/images/microsoft_exchange_48.png</icon-path>
      <oauth-config>
        <authz-end-point>https://login.microsoftonline.com/[Please input your tenant]/oauth2/v2.0/authorize</authz-end-point>
        <token-end-point>https://login.microsoftonline.com/[Please input your tenant]/oauth2/v2.0/token</token-end-point>
        <client-id>[Please input your application's Client ID]</client-id>
        <client-secret>[Please input your application's Client Secret]</client-secret>
        <scope>offline_access [Please input your application's scope. See : https://docs.microsoft.com/ja-jp/exchange/client-developer/legacy-protocols/how-to-authenticate-an-imap-pop-smtp-application-by-using-oauth#get-an-access-token]</scope>
      </oauth-config>
    </oauth-provider>
  

  oauth-provider@id	任意のIDを設定します。
  authz-end-point	Microsoft Azure で作成したアプリケーションのディレクトリIDを設定します。
  token-end-point	Microsoft Azure で作成したアプリケーションのディレクトリIDを設定します。
  client-id	Microsoft Azure で作成したアプリケーションのアプリケーションIDを設定します。
  client-secret	Microsoft Azure で作成したアプリケーションの認証情報のクライアントシークレット値を設定します。
  scope	利用用途にあわせて設定します。 詳しくは アクセス許可のスコープの文字列 を参照してください。

セットアップ時の設定は以上です。

11.5.1.3. 連携許可を行う¶

1. メール操作の対象ユーザで intra-mart Accel Platform にログインしてください。

2. ユーティリティメニューより、「個人設定」-「外部連携アプリケーション」を選択します。

   

3. 「プロバイダ情報を設定する」で作成したプロバイダ情報の「許可」をクリックします。

   

4. アプリケーションの認証画面に遷移します。サインイン、および許可を行ってください。

   

5. 以下の画面が表示されれば連携が完了です。

   

   コラム

   アクセストークンの期限切れなどで再発行を行う場合は、「解除」で一度連携を解除すると、「許可」がクリックできます。

11.5.1.4. IM-LogicDesigner メール操作タスク（IMAPメッセージの取得）の設定例¶

1. 連携許可を行ったユーザで 「サイトマップ」→「LogicDesigner」→「フロー定義一覧」に遷移します。

   「LogicDesigner」の操作には「LogicDesigner管理者」のロールが必要です。
2. 「ロジックフロー新規作成」をクリックし、以下のタスクを使用したフローを作成します。

   取得したメッセージを格納する変数も用意します。

   • アクセストークンの取得タスク
   • IMAPメッセージの取得タスク

   

   • アクセストークンの取得タスクと、IMAPメッセージの取得タスクに渡す値を入出力設定で定義しています。

   

   • IMAPメッセージの取得タスクの返却値を格納する変数を変数設定で定義しています。

   

   • アクセストークンの取得タスクのマッピングで入力値を渡しています。

   

   • IMAPメッセージの取得タスクのマッピングで、アクセストークンの取得タスクの返却値と、入力値を渡しています。

   

   • IMAPメッセージの取得タスクからの返却値を、変数操作で変数「temp」にセットしています。

   

   • 変数「temp」を、変数操作で変数「result」にプッシュしています。

   

3. 「デバッグ」をクリックしてデバッグ画面を呼び出します。

4. 「実行」をクリックして、入力値を設定画面を呼び出し、「実行」します。

   

   providerId	「プロバイダ情報を設定する」で設定した id を設定します。
   providerType	「プロバイダ情報を設定する」で設定した provider-type を設定します。
   authentification	true を設定します。
   user	「連携許可を行う」でサインインしたユーザを設定します 。
   folder	IMAPメッセージの取得タスク の folder から目的に合った値を設定します。
   seen	IMAPメッセージの取得タスク の seen から目的に合った値を設定します。
   host	サービスのIMAP設定に合わせて設定します。 Gmail Check Gmail through other email platforms を参照してください。 Exchange Online POP3 と IMAP4 を参照してください。
   port	サービスのIMAP設定に合わせて設定します。 Gmail Check Gmail through other email platforms を参照してください。 Exchange Online POP3 と IMAP4 を参照してください。
   ssl	サービスのIMAP設定に合わせて設定します。 Gmail Check Gmail through other email platforms を参照してください。 Exchange Online POP3 と IMAP4 を参照してください。
   starttls	サービスのIMAP設定に合わせて設定します。 Gmail Check Gmail through other email platforms を参照してください。 Exchange Online POP3 と IMAP4 を参照してください。

5. 終了後、変数「result」にメッセージが格納できれば成功です。