Skip Navigation

Enable the use of an alternate email address to authenticate to 
BEMS-Docs

You can configure 
BEMS
 to allow users to authenticate to 
Microsoft SharePoint Online
 with an email address that is different from the email address that was used to install and activate 
BlackBerry Work
. Complete this task only if your environment is configured to use one of the following:
  • If your environment is configured to use 
    Windows
     authentication, you can configure 
    BEMS
     to use the UserPrincipalName (UPN), email address or any other 
    Active Directory
     attribute to authenticate to 
    Microsoft SharePoint Online
    . By default, the UserPrincipalName attribute is used.
  • If your environment uses modern authentication, you can configure 
    BEMS
     to disable validating the email address when users authenticate to 
    Microsoft SharePoint Online
     or the environment uses 
    Azure
    -IP.
Install PuTTY on the computer that hosts the 
BEMS-Docs
 service. You can download it from .
  1. On the computer that is running the 
    BEMS-Docs
    , open PuTTY and type the following information: 
    • Port: 8101
    • Host Name: localhost 
  2. In the command, type one of the following commands: 
    Task
    Attribute
    Description
    Authenticate to 
    Microsoft SharePoint Online
     using mail
    docs:config SAMLUsernameAttribute mail
    Allows users to use their email address to authenticate to 
    Microsoft SharePoint Online
     instead of the user's userPrincipalName.
    To use the users' UPC again to authenticate, type 
    docs:config SAMLUsernameAttribute UserPrincipalName
    Disable user validation when authenticating to one of the following:
    • Microsoft SharePoint Online
       configured for modern authentication
    • Azure
      -IP  
    docs:config adal.uservalidation.skip 1
     
    Disables validation of the user's email address.
  3. Close the command window.
  4. Complete steps 2 and 3 on each tenant in the environment.