Configuring OAUTH

NOTE: This will require a licensed mailbox with the SMTPClientAuthentication property enabled.

Step 1: Configure things in Microsoft Entra

1)Log in to the Microsoft Entra portal

2)On the left, select App Registrations

3)Click "New Registration"

4)Give the new app a name, we recommend PageGate

5)Select the "Single Tenant" option.

6)In the "Redirect URI" section, select Web and use the following URL: http://localhost:3017/

7)Click Register.

8)Make a copy of the Directory (tenant) ID and Application (client) ID

9)Click "Add a certificate or secret"

10) Click "New Client Secret"

11) Add the description: PageGate Secret

12) Click Add

13) Copy the Client Secret value (not the Secret ID)

Step 2: Run the PageGate OAUTH application and retrieve the necessary tokens

1)On the PageGate server, run PG Admin.

2)Go to Program - Tools - O365 OAuth.

3)Enter the email address being used for authentication in the 'Username' field and enter the password for that email address in the 'Password' field.

4)Provide the Tenant ID, Client ID and Client Secret Values.

5)Click 'Retrieve Tokens'

6)Log in with the email address being used for authentication.

7)Accept the permission request.

8)Back in the PageGate OAUTH application, a great deal of information should now appear in the 'Access Token' section.
If you're configuring OAUTH for an SMTP/Email carrier, click the 'Copy Carrier Settings to Clipboard' button.
If you're configuring OAUTH for PageGate's mail server and the GetMail interface, click the 'Copy GetMail Settings to Clipboard'

Step 3: Apply the OAUTH template values to the Carrier(s), GetMail or both

1)Open Notepad (or your preferred text editor)

2)Paste everything into Notepad.

3)Add the following lines:
From = The email address used for authentication
EnvelopeFrom = The email address used for authentication

4)Highlight and copy everything to the clipboard.

5)Open PG Admin.

6)To apply the template values to the carriiers, go to Carriers - Any/All Carriers that use SMTP - Template

7)Overwrite everything in the 'Settings' template with what you have copied to the clipboard.
Note: If you have references to any PageGate filters, do not remove those lines.

8)Click Apply.

9)To apply the template values to the GetMail Interface, go to Interfaces - GetMail - Template

10) Paste the new template values into the 'Settings' section of the template

11) Click Apply.