Outlook OAuth Authentication

Outlook OAuth Authentication

Introduction

OAuth is a standard for authorisation in the field of technology, which allows users to authorise an app or service to sign in to another without revealing sensitive information such as usernames or passwords. This article will detail the process of Outlook OAuth authentication.

How do you use Outlook OAuth?

1. Sign in or create an account on Microsoft Azure

2. Click "View"

3. You will be redirected to this page

4. Click "Add"

5. Click "App registration"

6. Fill in the name field

7. Choose a “Supported Account Type”

8. Switch to Invent ERP’s website

9. Click “Configuration”

10. Click "Settings"

11. Click "Technical"

12. Click "Mail Server"

13. Click "Mail Servers"

14. Click "Add"

15. Fill the "Mail Server Description" field

16. Choose “Outlook OAuth Authentication” in the “Authenticate Using” drop-down menu

17. Fill in the "Username" field with the email address you used on Microsoft Azure

18. Copy the “OAuth2 Redirect Url”

19. Switch to Microsoft Azure

20. Click on “Select a platform” and select the “Web” option

21. Paste the “OAuth2 Redirect Url”

22. Click “Register”

23. You will be redirected to a different page. Click “API Permissions”

24. Click "Add a permission"

25. Click “Microsoft Graph”

26. Click “Delegated Permissions”

27. Under “Select Permissions” search for and select “SMTP.Send” and “IMAP.AccessAsUser.All”

28. After selecting both permissions, click "Add permissions"

29. All permission can be seen under “Configured Permissions”. Note: “User.Read” was added automatically.

30. Click "Overview"

31. Click “ Managed Application in Local Directory”

32. Click "User and groups"

33. Click "Add user/group"

34. Click “None Selected”

35. Search for and select users/groups (These are the users that will be sending the emails)

36. Click “Select”

37. Click “Assign”

38. Click "Overview"

39. Click “Copy to clipboard” under “Application ID”

40. Switch to Invent ERP’s website

41. Paste in the “Client ID” field

42. Switch to Microsoft Azure

43. Click here

44. Click on the app registration

45. Click "Manage"

46. Click "Certificates & secrets"

47. Click "New client secret"

48. Enter a description (Something recognisable)

49. Set the expiration date

Note: If this client secret expires, a new one will have to be created and configured. The expiration could lead to a service interruption highlighting the importance of the expiration date.

50. Click "Add"

51. Click “Copy to Clipboard” under “Value”

52. Switch to Invent ERP’s website

53. Paste under “Client Secret”

54. Scroll up and click “Create”

55. This message will popup

56. Scroll down and click "Connect your Outlook account"

57. You may receive a “Permissions Request”.If so, click “Accept”

58. Ensure that it reads “Token Valid” next to “Connect your Outlook account”