Versions Compared

Key

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

...

  1. Anchor
    hostname
    hostname
    Prepare the redirect uniform resource identifier (URI) which will handle the callback from the authorization server after the user grants permission. You must configure the redirect URI correctly to receive the authorization code or access token securely.  
    An example of a redirect URI is 
         https://yourapp.com/oauth/callback
    where yourapp.com is the hostname.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.

    2. Click Addv and select OAuth2

    3. When the Add window opens, go to the Redirect URI field and copy the given URL. 

       
  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
      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. Enter a Name for your application. 

      2. Select Account in this organizational directory only from the options for Supported account types.   

      3. Enter the redirect URI from Step 1.

      4. Click Register
        register an app

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

    5. Next, go to Certificates & secrets in the sidebar menu then click +New client secret on the right. 
      new client secret

    6. Anchor
      idandsecret
      idandsecret
      On the Add a client secret window: 

      1. Add a description. 

      2. Select an expiry date from the Expires dropdown menu.
        add client secret

        Note

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

      3. Click the copy icon to copy the generated Value and Secret ID. You will use these values later when configuring OAuth 2.0 in the mail settings. 
        copy secret

    7. Next, go back to the Overview and click the Endpoints tab.

    8. Anchor
      authandtokenurl
      authandtokenurl
      Copy the OAuth 2.0 authorization endpoint (v2) and the OAuth 2.0 token endpoint (v2) to your local desktop. You will also use these values for creating the OAuth 2.0 credential in the mail settings. 
      authorize endpoints

    9. Set API Permissions:

      1. Navigate to API permissions on the sidebar menu and click the Add a permission button on the API Permissions page of your application. 

      2. Select the Microsoft APIs you need access to. Example: Microsoft Graph

      3. Next, select Delegated permissions and enter SMTP.Send in the Select permissions field. 

      4. Click the Add permissions button. 

...