Redirecting to default login.. Graph API ResMail 2.2 Install Guide (Existing ResMail 1.5 Installation)
  1. Home
  2. Technical Information
  3. Email Services
  4. Graph API ResMail 2.2 Install Guide (Existing ResMail 1.5 Installation)
Searching...

Graph API ResMail 2.2 Install Guide (Existing ResMail 1.5 Installation)

Contents

Prerequisites

  • .NET Framework 4.8 will be needed
  • The user’s IT will need to create a domain user account with local admin permissions to run the new Resware Email Attachment service as. This is due to Microsoft’s implementation of the OAuth protocol in regards to incoming email as it is tied to a particular user. Why?
  • Obtain the existing credentials from C:\ReswareEmail\Configuration\EmailClientInstaller.exe
    • Double-click and acquire the mailbox username and password
    • This will be used to setup the new 2.2 installation

After all prerequisites are completed, proceed to Microsoft Registration.

Microsoft Registration

  1. Go to: https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
  2. Choose New registration in the top left:
  3. After clicking New registration, the user will be taken to the Register an application screen
  4. Name: Can be anything (i.e. Resware Incoming Email)
  5. Supported account types: Choose Accounts in this organizational directory only unless you know that you have a multitenanted installation
  6. Redirect URI (optional): Choose Public client/native
  7. Input the URL: https://login.microsoftonline.com/common/oauth2/nativeclient 
  8. Click Register
  9. After registration, the user will be taken to the App registrations overview screen
  10. Copy the values and send them to Resware
    1. Application (client) ID 
    2. Directory (tenant) ID 
  11. Click on API permissions
  12. Click on Add a permission
  13. Click on Microsoft Graph
  14. After clicking Microsoft Graph, you will be taken to the Request API permissions screen
  15. Choose Delegated permissions 
  16. Type mail in the search box
  17. Click the arrow next to Mail to expand the mail options
  18. Check Mail.ReadWrite 
  19. Click Add permissions

Service Installation on Server

  1. Log in with the account created for Graph ResMail Service from 
    Prerequisites: Step 2, log into the server (typically App Server) on which ResMail 2.2 will be running
  2. Use the link to pull down the ResMail 2.2 program: https://drive.google.com/drive/folders/1WiNsex64g-XRw1EyKcdCD-ZLHj-6PXCa?usp=sharing 
  3. Unpack the entire GraphResMail folder into a working directory: C:\GraphResMail
  4. Copy the entire existing proxy folder located at C:\ResWareEmail\Proxy
  5. Paste the proxy folder into C:\GraphResMail
  6. Navigate to C:\GraphResMail, right-click, and edit the emailConfig.xml file
  7. Copy and Paste the client ID and tenant ID from the Microsoft Registration Steps into the emailConfig.xml (pictured below):
    1. Make sure that the <clientId></clientId> are on the same line (no returns)
    2. Make sure that the <tenantId></tenantId> are on the same line (no returns) – will result in an ‘authority’ URI error
  8. Input the location of the newly created proxy folder C:\GraphResMail\Proxy, for the ProxyFolder value by editing the emailConfig.xml file
  9. Save the emailConfig.xml file
  10. Open Command Prompt and Run as Administrator
    1. Type cd C:\GraphResMail and click enter
    2. Type Exchange365.exe install and click enter
  11. To open the Services menu, select Start > type Services
    1. Right-click the newly created Resware (Adeptive) Email Attachment service
    2. Select the Properties option
      1. Select Log On tab 
      2. Toggle This account: to On
      3. Input the credentials for the Windows Profile with Local Admin Permissions from Prerequisites: Step 2
      4. Click Apply

    3. Select the Recovery tab
      1. Use the dropdown menu and select Restart the Service for each failure
      2. This will alleviate the need for a manual service restart
  12. Close pre-existing 1.5 process and proxy process
    1. Navigate to C:\ReswareEmail\Configuration
    2. Right – Click EmailClientInstaller.exe and Run as Administrator
    3. Click Stop from Step 1 first, then click Kill Proxy Processes (Step 2)
    4. Close Configuration Panel
  13. Open Command Prompt and Run as Administrator
    1. Type cd C:\GraphResMail and click enter
    2. Type Exchange365.exe and click enter
      1. OAuth Login will be prompted
      2. Input the credentials for the ResMail Service account from
        Prerequisites: Step 3
      3. Credential tokens will be held in a generated
        msalTokenCache.bin file in C:\GraphResMail
    3. Exit Command Prompt
  14. To open the Services menu, select Start > type Services
    1. Start the Resware (Adeptive) Email Attachment Service
Updated on September 14, 2022

Need Support?

Can’t find the answer you’re looking for? Don’t worry we’re here to help!
Contact Support

Submit a Support Request