How do you start using the new OAuth 2.0 authentication - OnSite?

How do you start using the new OAuth 2.0 authentication in SuperOffice - OnSite?

Requirements

Onsite customers who use:

  • SuperOffice G9 9.2 R10 - OnSite
    and
  • SuperOffice Service
    and / or
  • SuperOffice Inbox (the integrated email client)
    and
  • Microsoft 365 (Microsoft® Exchange Online)

How to add the feature?

You can add the feature via adding:

  • a) a new sectionGroup 'FeatureToggles' with state
  • b) a FeatureToggles section, with state

- in the web.config file (ask your technical installation partner for assistance if needed):

a)

<configuration>
<configSections>
<sectionGroup name="SuperOffice">
<sectionGroup name="FeatureToggles">
<section name="State" type="System.Configuration.NameValueSectionHandler, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
</sectionGroup>
<sectionGroup name="Security">
...

b)

<FeatureToggles>
  <State>
    <add key="NewAuthentication" value="True" />
  </State>
</FeatureToggles>
 

How to use the feature in SuperOffice Service? 

Once you have added the FeatureToggle in Web.config for your Onsite installation - next time you create a mailbox in SuperOffice Service - you will be redirected to Microsoft for authentication.

To create a new mailbox:

  1. Select  System settings > E-mail. This takes you straight to the Mailboxes tab.
  2. Click New mailbox. The Mailbox properties screen appears, with the Properties tab open.
  3. In the Address field, enter the e-mail address you want to use for the mailbox.

    If we recognize the UPN as an Microsoft 365 email account, we redirect you to Microsoft for authentication.

  4. Click OK. The mailbox is created.

 

'Create mailboxes in Service' help file

 

How to use the feature in SuperOffice Inbox 

Once you have added the FeatureToggle in Web.config for your Onsite installation - next time you log in to your email account in SuperOffice Inbox - you will be redirected to Microsoft for authentication.

 

Log out of your email account in SuperOffice Inbox

  1. To access the e-mail options, click the 'Personal settings' button 
  2. Click 'E-mail options' to edit the settings for e-mail.
  3. Click on 'E-mail account' tab
  4. Click [Edit/remove] button to remove your account

How to remove email account

 

Log back in to your Microsoft email account in SuperOffice Inbox

  1. Fill inn your Microsoft365 'User Princpal Name' (UPN) in the field "Email account".
  2. Click "[Next].
    If we recognize the UPN as an Microsoft 365 email account, we redirect you to Microsoft for authentication. 
  3. Authenticate towards Microsoft and complete the login

You will then be taken to the SuperOffice Inbox. Your email account is now set up to use OAuth 2.0 authentication.

  • What is UPN (User Principal Name)?
      • In Windows Active Directory, a User Principal Name (UPN) is the name of a system user in an email address format. A UPN (for example: john.doe@domain.com) consists of the user name (logon name), separator (the @ symbol), and domain name (UPN suffix).
        A UPN is not the same as an email address. Sometimes, a UPN can match a user's email address, but this is not a general rule. 

        How to check or modify the UPN of a user

        Use the links below to learn how to check and change UPNs in various environments.

 

'The inbox in SuperOffice CRM' help file

No replies yet!