Recommendation: Enabling Kerberos Authentication for MAPI Clients
Published Apr 15 2011 03:00 AM 145K Views
Microsoft

Update 4/26/11: This post has been updated to include additional steps to ensure Kerberos authentication can be used for OAB downloads by domain-connected Outlook clients.

With Exchange 2010, a major change was instituted in the way clients connect and access mailbox related data. Unlike previous versions, clients no longer connect directly to the Information Store on the Mailbox server role to access mailbox data. Instead, clients connect to a set of services on the Client Access server (CAS) role and services within the CAS role access mailbox data using MAPI/RPC from the Mailbox server on behalf of the connecting user.

This architectural change provides many benefits, including:

  • A common code path for different client types for message body content conversion.
  • Data validation logic. For example, calendar versioning which is used by the Mailbox Assistant, the Calendar Repair Assistant.
  • Compliance features like Single Item Recovery or Legal Hold.
  • Better client experience during switchovers/failovers by obfuscating the Mailbox server hosting the active mailbox database copy.
  • A unified interface for Address Book-related data.

To facilitate high availability and fault tolerance, customers must deploy multiple Client Access servers within the Active Directory sites that host Mailbox servers. To achieve high availability and fault tolerance, you must deploy one or more unified namespaces that are mapped to a virtual IP address of a load balancer. The load balancer must be configured to accept requests over specific TCP ports and provide persistence, where required, for the client protocol being used.

Kerberos Authentication Explained

Typically, domain-joined clients/applications either leverage NTLM or Kerberos for authentication. Other clients, like web browsers, can also use Basic authentication secured with SSL encryption, regardless of the client’s location (inside or outside of the corporate network). The actual authentication mechanism used depends on the configuration of both the client and the server and they negotiate the authentication to be used during the establishment of the connection. MAPI supports Kerberos authentication and the default setting in Outlook 2007 and later is to negotiate the strongest authentication available when not running in Outlook Anywhere mode.

In Exchange 2010, MAPI clients connect to load-balanced array of servers, and not an individual server with its own unique network identity. This change in the messaging architecture presents a challenge, however. In previous Exchange versions, clients connected directly to the Mailbox server which was a single identity on the network. This meant that the client, if capable, could utilize Kerberos authentication for establishing the session with the Mailbox server.

To understand the legacy behavior and how this is a challenge in Exchange 2010 let’s review Kerberos authentication, as documented in How the Kerberos Version 5 Authentication Protocol Works:

  1. The client contacts the Key Distribution Center's authentication service for a short-lived ticket (a message containing the client's identity and —for Windows clients –SIDs) called a ticket-granting ticket (TGT).
  2. The authentication service (AS) constructs the TGT and creates a session key the client can use to encrypt communication with the ticket-granting service (TGS). The TGT has a limited lifetime. At the point that the client has received the TGT, the client has not been granted access to any resources, even to resources on the local computer.
  3. The client wants access to local and network resources. To gain access, the client sends a request to the TGS for a ticket for the local computer or some network server or service. This ticket is referred to as the service ticket. To get the ticket, the client presents the TGT, an authenticator, and the name of the target server (the Service Principal Name or SPN).

    Important: SPNs are unique identifiers for services running on servers. Every service that uses Kerberos authentication needs to have a SPN set for it so that clients can identify the service on the network. If a SPN is not set for a service, then clients will have no way of locating that service. Without properly set SPNs, Kerberos authentication is not possible. Additionally, in Windows Server 2003, KDCs will not issue a service ticket for an account that does not have a SPN.

  4. The TGS examines the TGT and the authenticator. If these are acceptable, the TGS creates a service ticket. The client's identity is taken from the TGT and copied to the service ticket. Then the ticket is sent to the client.
  5. After the client has the service ticket, the client sends the ticket and a new authenticator to the target server, requesting access. The server will decrypt the ticket, validate the authenticator, and for Windows services, create an access token for the user based on the SIDs in the ticket.
  6. Optionally, the client might request that the target server verify its own identity. This is called mutual authentication. If mutual authentication is requested, the target server will take the client computer's timestamp from the authenticator, encrypt it with the session key the TGS provided for client-target server messages, and send it to the client.

With Exchange 2003 and Exchange 2007, each Mailbox server would have the following SPNs created and assigned to the Mailbox server’s computer account in Active Directory:

  • exchangeMDB/<Mailbox server FQDN>
  • exchangeRFR/<Mailbox server FQDN>
  • exchangeAB/<Mailbox server FQDN>

These three SPNs enabled a client that was configured with either Negotiate or Kerberos authentication to successfully obtain a service ticket from the TGS. In turn, the Mailbox server could decrypt the service ticket and create an access token and provide access to the mailbox data.

Exchange 2010, however, leverages a load-balanced namespace for accessing mailbox data. The FQDN that a client uses to connect to Exchange resolves to a group of load-balanced Client Access servers. Given that an SPN can only be registered to one unique entity within the Active Directory environment, this means:

  1. During CAS install, Exchange Setup cannot create load-balanced namespace SPNs for the address book, referral and RPC Client Access SPN records.
  2. Administrators cannot manually register the same load-balanced namespace SPNs on each CAS computer account.

To understand this problem and why either of the above items would not work, let’s assume the Outlook profile is configured to use the load-balanced namespace outlook.contoso.com for its home server property and it is connecting to the CAS member cas1.contoso.com:

  1. Client contacts KDC and obtains a TGT.
  2. Client sends a request to the TGS based on the TGT, the authenticator, and the name of the target server. In this case, the name of the target server outlook.contoso.com, and not the FQDN of the Client Access server.
  3. Client retrieves service ticket and sends it to outlook.contoso.com, which happens to get directed by the load balancer to cas1.contoso.com.
  4. cas1.contoso.com fails to decrypt the service ticket because:
    1. Its name does not match outlook.contoso.com.
    2. The SPN is not associated with cas1.contoso.com or multiple objects within Active Directory have an SPN associated with the associated service and outlook.contoso.com.
  5. Client fails to obtain an access token using Kerberos authentication.

As a result, when a mailbox is moved to Exchange 2010, Outlook and other MAPI clients that are configured to use Negotiate will ultimately end up using NTLM authentication.

NTLM Authentication Concerns

Why is using NTLM authentication for Outlook and other MAPI clients a concern? Let’s take a look at the authentication process:

  1. The user launches Outlook.
  2. The user’s computer sends traffic to the server (load-balanced namespace) specified in the Outlook profile. This traffic includes the user’s integrated authentication information (in other words, NTLM authentication).
  3. The load balancer directs the traffic to a specific CAS member within the load-balanced array.
  4. The CAS member needs to verify the user’s credentials. It does this by sending traffic to a specific domain controller, the one which it has an associated secure channel binding, requesting a verification of the user's credentials.
  5. The domain controller responds to the CAS member with the information on the user’s credentials.
  6. The CAS member generates an access token and services the request.

The problem here is that each connection from the client must follow this same process. Therefore, as the number of connections increase, there is potential for a bottleneck in terms of handling the NTLM authentication. The bottleneck is a result of the following two issues:

  1. The CAS member only uses a single domain controller for all authentication requests. In addition, there is no load distribution mechanism across the CAS members in the load balanced array to ensure that each CAS is using a different domain controller for its secure channel binding.
  2. Windows limits the number of concurrent secure channel calls.  There are a specific number of threads that can handle NTLM authentication (controlled by MaxConcurrentAPI value, with default equaling 2).  

    Each MaxConcurrentAPI thread can only deal with one authentication request at a time.  However, attributes like network latency, the number of hops the authentication requests have to go through, and the volume of requests can introduce a bottleneck in the authentication process, resulting in some of these transactions waiting longer than a remote client can tolerate.  If you have a heavy load, you are more than likely going to hit that limit when these clients authenticate via NTLM.  You can monitor for NTLM failure events using the Netlogon performance counters (see KB 928576), as well as, the frequency of event ID 5783.

Windows Server does have a means to increase the number of concurrent secure channel calls up to 150 when you deploy KB 975363. However, increasing the number of concurrent secure channel calls up as far as 150 is also not recommended, as it can have adverse effects on domain controller performance.

The Recommendation

If increasing the number of concurrent secure channel calls is not the answer, then what is? Prior to Exchange 2010 SP1, unfortunately there was no answer. Thankfully in Exchange 2010 SP1, we introduced a solution. The solution involves leveraging an alternate service account (ASA) credential mechanism to enable Kerberos authentication for MAPI clients.

The Microsoft Exchange Service Host service that runs on CAS has been extended to use a shared credential for Kerberos authentication. This service host extension monitors the local machine. When credentials are added or removed, the Kerberos authentication package on the local system and the network service context is updated. As soon as a credential is added to the authentication package, all client access services can use it for Kerberos authentication. The Client Access server will also be able to authenticate service requests addressed directly in addition to being able to use the ASA credential. This extension, known as a servicelet, runs by default and requires no configuration or action to run.

The steps to deploy the ASA credential are as follows:

  1. Create an account to be used as the ASA credential.
  2. Deploy the ASA credential to the CAS members.
  3. Convert the OAB virtual directory to an application.
  4. Assign the SPNs to the ASA credential computer account.

Create an account to be used as the ASA credential

All computers within the Client Access server array must share the same service account. In addition, any Client Access servers that may be activated as part of a datacenter switchover must also share the same service account. In general, it's sufficient to have a single service account per forest.

You can create a computer account or a user account for the alternate service account. Because a computer account doesn’t allow interactive logon, it may have simpler security policies than a user account and is therefore the preferred solution for the ASA credential. If you create a computer account, the password doesn't actually expire, but we still recommend that you update the password periodically. The local group policy can specify a maximum account age for computer accounts and scripts may be scheduled to periodically delete computer accounts that don’t meet current policies. To ensure that your computer accounts aren't deleted for not meeting local policy, update the password for computer accounts periodically. Your local security policy will determine when the password must be changed.

Deploy the ASA credential to the CAS members

To enable deployment of the ASA credential, a script has been created and is shipped with Exchange 2010 SP1. The script is named RollAlternateServiceAccountPassword.ps1 and is located in the Scripts directory. For more information on how to use the script, please see Using the RollAlternateserviceAccountPassword.ps1 Script in the Shell.

Conve rt the OAB virtual directory to an application

Out of the box, the OAB virtual directory is not a web application and, therefore, is not under the control of the Microsoft Exchange Service Host service.  As a result, Kerberos authentication requests to the OAB virtual directory cannot be decrypted by the ASA credential. 

To convert the OAB virtual directory to a web application, execute the ConvertOABVDir.ps1 script on each CAS member.  The script will also create a new application pool for the OAB virtual directory.  You can download the script here.

Assign the SPNs to the ASA credential computer account

After you create the alternate service account, you must determine the Exchange service principal names (SPNs) that will be associated with the ASA credentials. The list of Exchange SPNs may vary with your configuration, but should include at least the following.

  • http Use this SPN for Exchange Web Services, Offline Address Book downloads, and the Autodiscover service.
  • exchangeMDB Use this SPN for RPC Client Access service.
  • exchangeRFR Use this SPN for the Address Book service.
  • exchangeAB Use this SPN for the Address Book service.

The SPN values must be configured to match the service name being used on the load balancer, rather than on individual servers.

For example, if you have a single Active Directory site, your environment may resemble the one in the following illustration.

KerbAuthSingleSiteCAS

Based on the fully qualified domain names that are used by internal Outlook clients in the previous illustration, the following SPNs would need to be deployed on the ASA credential:

  • http/mail.corp.contoso.com
  • http/autod.corp.contoso.com
  • exchangeMDB/outlook.corp.contoso.com
  • exchangeRFR/outlook.corp.contoso.com
  • exchangeAB/outlook.corp.contoso.com

External or Internet-based clients that use Outlook Anywhere won’t use Kerberos authentication as they cannot directly contact a KDC. Therefore, the fully qualified domain names that are used by these clients don’t have to be added as SPNs to the ASA credential.

After you have identified the required SPNs, you can assign them using the SETSPN command line tool.

For more information, including information on how to plan what SPNs you should deploy with your ASA credential, see Configuring Kerberos Authentication for Load-Balanced Client Access Servers.

Conclusion

Due to scalability limits when using NTLM authentication, Microsoft recommends deploying the ASA credential solution so that domain-joined and domain-connected Outlook clients, as well as other MAPI clients, can leverage Kerberos authentication.

Ross Smith IV

16 Comments
Not applicable

Hi,

Is there a HTTP/ SPN required on Exchange 2007 CAS servers? It's not listed in

technet.microsoft.com/.../aa996905%28EXCHG.80%29.aspx.

My understanding from this article is that when Outlook connects to the CAS 2007 Virtual Directories (Oab, EWS, Autodiscover) which have Integrated Authentication set, it will negotiate the authentication picking Kerberos if it can and falling back to NTLM

if Kerberos fails. Not the best, but the user doesn't get pestered looking for credentials, which is my first concern.

In a scenario where Exchange 2007 CAS servers share the same namespace behind a Hardware load Balancers Kerberos cannot be used but Outlook will always fail back to NTLM, which is transparent to the user. However, I believe that Office Communicator connects

to the EWS virtual directory using Kerberos if the "Enable Windows Integrated Authentication" is set in Internet Explorer. In this scenario Communicator will fail on Kerberos like Outlook but will not fall back to NTLM and therefore will not be able to access

Out-of-Office and Missed calls etc.

To get around this I can add the HTTP/ SPN to each CAS server object in AD, although you are saying this will cause it to fail. I have tried this and while I do get errors in the Event logs it seems to work. I am currently looking into using Kerberos Constrained

Delegation (KCD) on the 2007 CAS servers, which seems identical to the ASA in Exchange 2010 that you are describing.

In a migration scenario, when I swap over my

https://mail.constoso.com name space from Exchange 2007 to Exchange 2010 and replace it with

https://legacy.contoso.com will I also have to worry about Kerberos on the legacy namespace? Will Outlook or a Communicator client connecting to the Exchange 2010 using Kerberos have to authenticate

again with Kerberos when it gets redirected to the Legacy namespace? I’ve read some migration examples where the HTTP/legacy SPN is added to the Exchange 2007 CAS.

I am looking to migrate Exchange 2007 to Exchange 2010 with both https://mail and https://legacy names spaces behind hardware load balancers. My aim is to ensure that users never see a credentials dialog box during the co-existence and migration period.

My current thinking now is to use KCD on the Exchange 2007 CAS servers, implement the ASA as described in this article and swap the SPNs when we swap the namespaces.

Any thoughts are appreciated.

Conor

Not applicable

Great article, Ross.

Wouldn't we be able to use Windows Server 2008 R2's Managed Service Accounts (technet.microsoft.com/.../dd560633(WS.10).aspx) for the ASA account?

 That way we don't need to change the password on a regular basis - we can let Windows do it for us.

Jeff

Not applicable

Jeff,

One of the disadvatanges of managed service accounts is that they can only be used on one computer (server). So a typical load balanced web farm can't benefit this concept...

It's in the MSA FAQ:

technet.microsoft.com/.../ff641729(WS.10).aspx

Regards,

Thomas

<a href="http://setspn.blogspot.com">http://setspn.blogspot.com</a>

Not applicable

Conor - we don't have a service in Exchange 2007 that can manage an ASA credential so that you can "share" a SPN across members of a CAS array using a load-balanced FQDN.  For those clients, they will have to leverage Basic or NTLM authentication.

Not applicable

Jeff - you should leverage a computer account as that is the easiest to manage and decreases the attack surface area (since there is no interactive logon).

Not applicable

Hi,

Thanks for taking the time to reply. I appreciate that Exchange 2007 has no intrinsic provision for this, but the Microsoft Exchange Service Host in Exchange 2007 would only manage Outlook Anywhere, which wouldn’t be using Kerberos anyway. Thus, considering Exchange 2007 clients only use the CAS for Web Services I would have thought that as long as the service account that an Application Pool such as MSExchangeAutodiscoverAppPool held the SPN, the client could authenticate against IIS using Kerberos with Kerberos Constrained Delegation.

KCD would allow for a scenario whereby those application pools on each CAS server could run under a service computer account that has the SPN of the VIP namespace registered. This service computer account would also be added to all relevant security groups that an Exchange server must be in. This would mean that each CAS would be able to authenticate Kerberos for the same namespace, but no longer for the hostname or FQDN of the server itself.

The ISA and TMG documentation mention KCD in relation to Exchange 2003 technet.microsoft.com/.../cc995228.aspx. I haven’t come across any Exchange 2007 articles yet, but I’ve only begun to look into this, but perhaps it would just be easier to set Windows Authentication on IIS to use only NTLM rather than Negotiate during the co-existence period.

Conor

Not applicable

Hi.

There is one caveat with http/ SPNs. Documentation says "For Exchange Web Services and the Autodiscover service", but there are more things with integrated auth, which are usualy accesed with same hostname - OAB, Exchange, Exchweb and Public virtual directories.

Since those virtual directories runs in ApplicationPoolIdentity context (in DefaultAppPool), kerberos authentication will fail if http/ SPN is set for service account. So typicaly Outlook 2007 and higher will throw authentication window during OAB download unless your OAB url uses different hostname than EWS/Autodiscover url. Solution could be to change DefaultAppPool context to the service account, but then password generation feature of the ASA script cannot be used.

d.

Not applicable

Hi,

Just wondering if making this change to an existing environment will have any impact to non-microsoft MAPI applications such as my backup and BES servers. What type of impact, if any?

Not applicable

Hi Ross.

We have a situation where a Exchange 2010 sp1 was setup in a resource forest mode and it uses linked-mailbox to another user domain. Due to some reasons, we can only create an external trust to the user domain, not forest trust.

Will Kerberos work in this senario?

TIA

Cheers

Not applicable

@CY - When you use external trust, only NTLM authentication is available.

@Gabriel - Other MAPI applications will leverage an authentication mechanism that is defined in the MAPI profile.  Kerberos could be leveraged if they are leveraging an FQDN that maps to a deployed SPN on the ASA credential.

@David - Outlook (and MAPI apps) do not use the /exchweb, /exchange, /public vdirs (some of which don't exist in E2010).  I have added the guidance for OAB vdir.

Ross

Not applicable

If we need to fall back the changes, How do you convert back the OAB application back to a virtual folder

Not applicable

@Joe - You simply delete the OAB vdir (Remove-OABVirtualDirectory) and recreate it (New-OABVirtualDirectory).

Ross

Not applicable

Ross: how do you reverse the work done by the RollAlternateserviceAccountPassword.ps1 script?

Not applicable

You mention "External or Internet-based clients that use Outlook Anywhere won’t use Kerberos authentication as they cannot directly contact a KDC."  Why is this true for Internal OA clients?  Is this true both the HTTP level auth as well as the RPC level auth when doing RPC Encryption?

I'm trying to figure out if Outlook Anywhere can do Kerberos for the RPC auth, regardless of the HTTP auth.  I posted this question to the forums, but haven't found a diffinitive answer:

social.technet.microsoft.com/.../7e5005e7-323d-48aa-b2a9-7a81dbfe84c6

Most everything seems concerned with the HTTP auth (I see only Basic, NTLM supported), but nothing is really addressing the RPC level auth with OA.  In practice, even with Outlook set to "Kerberos Only" RPC auth, I still see NTLM being used.

Thanks,

-Lee

Not applicable

Ross,

What is the entire exit strategy for this process?  Is it just:

1)  Removing and recreating the OAB directory.

2)  Deleting the ASA Credential account.

Or are there more steps involved to completely reverse the changes made?

Not applicable

Hi,

I set the spn's for my new exchange 2010 environment, and its now prompting users for authentication within OCS, and possibly Outlook. I checked to make sure I didn't have any duplicate spn's, but something has obviously gone wrong. I apparently need to delete, or re-add a SPN to fix this, but am not sure if I am supposed to run 'setspn -A exchangeAB/' with my GC server, CAS, or Mailbox servers?

All I ran was these commands-

Setspn -S http/mail.mycompany.com mycompanycasarray$

Setspn -S http/autodiscover.mycompany.com mycompanycasarray$

Setspn -S http/autodiscover.myothercompany.com mycompanycasarray$

Setspn -S exchangeMDB/cas.mycompany.com mycompanycasarray$

Setspn -S exchangeRFR/cas.mycompany.com mycompanycasarray$

Setspn -S exchangeAB/cas.mycompany.com mycompanycasarray$

Please help!!

Version history
Last update:
‎Jul 01 2019 03:58 PM
Updated by: