Enabling exact or alternate UPN authentication for a Metasys Server - Metasys - LIT-12011279 - General System Information - Metasys System - 13.0

Network and IT Guidance Technical Bulletin

Product name
Metasys System
Document type
Technical Bulletin
Document number
Revision date
Product status

About this task

Follow the steps below to enable exact or alternate UPN authentication for a Metasys Server, including an ADS, ADX, ADS-Lite, or OAS. This procedure also enables exact or alternate UPN authentication for all Metasys software installed on the Metasys Server.


  1. On the Metasys Server, open Notepad by right-clicking and selecting Run as Administrator. Click Yes if the User Account Control prompt appears.
  2. In Notepad, click File > Open and browse to:

    C:\Program Files (x86)\Johnson Controls\MetasysIII\ws\

    Note: By default, the Metasys software and databases are installed to the C: drive. If you have customized the installation location, specify the location. For example, if you installed on drive E, use E:\.
  3. Right-click on the web.config file. Click Open.
  4. Modify the following key under the <configuration><appSettings> section from false to true:
    <add key="enableOffice365StyleActiveDirectoryAuthentication" value="true"/>
  5. Save and close the web.config file.
  6. Restart the Metasys Server.

    To enable alternate or exact UPN authentication for SCT Release 11.1, see Enabling exact or alternate UPN authentication for SCT.

    For more information on creating users in the Metasys system, refer to Security Administrator System Technical Bulletin (LIT-1201528).