Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Now that basic authentication will be disabled and OAutho OAuth 2.0 is the new de facto industry standard for online authorization, MSPbots offers an option to add an extra authentication step in setting up the SMTP configuration for modifying the the From field address for outgoing emails and sending reports. Users now have the option to use OAuth 2.0 in the Outgoing Mail settings.

...

Follow these steps to generate the required information:

...

  1. hostnamePrepare the redirect uniform resource identifier (URI) which is https://app.mspbots.ai/web/um/smtp/redirect. Once the authorization is successful, Microsoft will use this URI to notify MSPbots about the authentication result. 

    You can find this information with the following steps:

    1. Go to Settings > System > Outgoing Mail in MSPbots.
      Image Added

    2.  Click v icon beside the +Add button Click Addv and select OAuth2. 
      Image Added

    3. Anchor
      Redirect URI
      Redirect URI
      When the Add window opens, go to the Redirect URI field and , copy the given URL to Notepad, and save it on your Desktop. You will need this later when adding a New registration
      redirect URI MSPbotsImage Added
       

  2. Sign in to the Microsoft Azure portal and secure the credentials needed for the OAuth 2.0 authorization. 
  3. Create a new app registration. 

    1. On the Microsoft Azure homepage, click App registrations. If you can't find App registrations on the Microsoft Azure homepagepage, please search for it in the search bar.
      register in Azure

    2. When the App registrations page opens, click the +New registration tab. 
      register new app

    3. In the Register an application form:

      1. Name - Enter a unique namefor your application. 

      2. Supported account types -Select Account in this organizational directory only (MSPbots.ai only - Single tenant) from the options.   

      3. Redirect URI (optional) - In the first box, select Web, and in the the second box, enter the Redirect URI copied from Step 1.c.

      4. Click Register
        register an app

    4. The Application (client) ID will be shown after your registration is done. Take note of this ID. 

  4. Next, go to Certificates & secrets

    in

    on the sidebar menu,

    then在Client secrets tab下

    then click +New client secret on the right under the Client secrets tab.

     


    new client secretImage Modified

    1. Anchor
      idandsecret
      idandsecret
      On In the Add a client secret window: 

      1. Description - Add a description. 

      2. Expires - Select an expiry date from the dropdown menu. 
        client secret expiryImage Modified

        Note

        Before the secret expires you must create a new secret and apply it to the MSPbots Outgoing Mail settings. 

      3. Click Add located at the bottom of the Add a client secret window.
        Once the 
    2. The addition is successful once the Update application credentials

       popup appears in the top right corner of the page, the addition is successful.、

      pop-up window appears. 
      update application successImage Added

    3. Anchor
      Value
      Value
      Click the copy copy iconImage Addedicon in the Value column to copy the value to Notepad and save it on your Desktop.  You will need this value Click the copy icon below the Value. You will need these values later when configuring OAuth 2.0 in the mail settings.
      copy valueImage Added
  5. Next, go to API Permissions

    in

    on the sidebar menu.

    1. Click the +Add permissions a permission button. 
      add a permissionImage Added
    2. In requesting API permissions window, go to Under the Microsoft APIs tab , and select Microsoft Graph.
      request API permissions - select Microsoft GraphsImage Added
    3. Next, select Delegated permissions.
      required API permissions - delegated permissionsImage Added
    4. Enter SMTP in the search bar under Select permissions, then click SMTP and check select SMTP.Send.
      select SMPT.SendImage Added
    5. Enter IMAP in the search bar under Select permissions, then click IMAP and check IMAPput a checkmark IMAP.AccessAsUser.All.
      check IMAP.AccessAsUser.All.Image Added
    6. Click the Add permissions button.
    7. The permissions you added will appear in the Configured permissions list.
      configured permissions listImage Added
  6. Next, go back go to the Overview.
    1. Anchor
      Application (client) ID
      Application (client) ID
      Click the copycopy iconImage Addedicon next to the Application (client) ID to copy the value to Notepad and save it on your Desktop. You will also use this value for creating the OAuth 2.0 credential in the mail settings. 
      copy client IDImage Added
    2. Click and click the Endpoints tab.
      endpoints tabImage Added
    3. Anchor
      authandtokenurl
      authandtokenurl
      Copy the OAuth 2.0 authorization endpoint (v2) and the OAuth 2.0 token endpoint (v2) to your local desktopNotepad and save it on your Desktop, such as Notepad. You will also use these values for creating the OAuth 2.0 credential in the mail settings. 
      authorize endpointsImage Removed
      endpointsImage Added

Anchor
Setting up OAuth 2.0 in MSPbots
Setting up OAuth 2.0 in MSPbots
Setting up OAuth 2.0 in MSPbots 

...

  1. Open the MSPbots app and go .
  2. Go to Settings > SystemClick , and click Outgoing Mail in the upper right corner of the Settings tabSystem page.
    Image Added

  3. Click Add and v icon on the right side of the +Add button and select OAuth2. 
    add oauth 2.0 authorizationImage RemovedImage Added

  4. Fill in the following fields :in the Add window. 
    1. Host Name - Cannot be modified - This value is pre-filled.
    2. Authorization URL and Token URL - Use the values from Step 36.h of c of the previous section. 
    3. Redirect URI - This value is pre-filled. 
    4. Client ID - Use the values from Step 6.a of the previous section. 
    5. and Client Secret - et Use the values generated in in Step 34.fc of the previous section. 
    6. Username - Enter your username. 
    7. Reply to -  Enter your preferred email.
    8. Signature - Input your signature. 
      add oauth 2.0
  5. Click Authorize
  6. When the confirmation pop-up window opens, click Continue
  7. On the Microsoft login screen, enter the user password you provided in the OAuth 2.0 credential and click Sign Inin. 
  8. Click Accept in the Microsoft pop-up window with the requested requesting permissions for MSPbots
    permission requestedImage Added
  9. The message Authentication successful oauth redirect success appears. 
    oauth 2.0 redirect successImage Added

Verifying if the authentication is successful 

...

To Go back to MSPbots and refresh the Outgoing Mail page to verify if the configuration works, refresh the mailbox list page. The mailbox status should show show Verified for a successful authentication. If the status is Not Verified, repeat Step 4 onwards repeat Setting up OAuth 2.0 in MSPbots until the authorization is successful. 

verify successful authorizationImage Added

Related Topics 

...