exch0710

10
CHAPTER 3-1 Integration Guide for Configuring Cisco Unified Presence Release 8.5 and 8.6 with Microsoft Exchange 3 Configuring Microsoft Exchange Server 2007 and 2010 for Integration with Cisco Unified Presence (over EWS) Revised: August 9, 2011 Note This module describes the integration of Cisco Unified Presence with Microsoft Exchange Server 2007 and 2010 over Exchange Web Services (EWS). If you are integrating with the Exchange server 2003 or 2007 over WebDAV, see Chapter 2, “Configuring Microsoft Exchange Server 2003 and 2007 for Integration with Cisco Unified Presence (over WebDAV).”For an overview of each type of Exchange integration, we recommend that you review Chapter 1, “Planning for Cisco Unified Presence Integration with Microsoft Exchange”. Microsoft Exchange 2007 Configuration Checklist (EWS), page 3-1 Verifying Permissions on the Exchange 2007 Account, page 3-4 Microsoft Exchange 2010 Configuration Checklist (EWS), page 3-5 Verifying Permissions on the Exchange 2010 Account, page 3-8 How to Enable Authentication on the Exchange 2007/2010 Virtual Directories, page 3-9 Microsoft Exchange 2007 Configuration Checklist (EWS) Before You Begin Note that the steps required to configure Exchange 2007 server will differ depending on whether you use Windows Server 2003 or Windows Server 2008. Table 3-1 provides a summary checklist to follow when configuring access to mailboxes on the Microsoft Exchange 2007 server on Windows Server 2003 and Window Server 2008. For detailed instructions, see the Microsoft Server 2007 documentation at the following URL: http://technet.microsoft.com/en-us/library/bb124558(EXCHG.80).aspx

Transcript of exch0710

Page 1: exch0710

Integration Guide for Configuring Cisco Unified Pre

C H A P T E R 3

Configuring Microsoft Exchange Server 2007 and 2010 for Integration with Cisco Unified Presence (over EWS)

Revised: August 9, 2011

Note This module describes the integration of Cisco Unified Presence with Microsoft Exchange Server 2007 and 2010 over Exchange Web Services (EWS). If you are integrating with the Exchange server 2003 or 2007 over WebDAV, see Chapter 2, “Configuring Microsoft Exchange Server 2003 and 2007 for Integration with Cisco Unified Presence (over WebDAV).”For an overview of each type of Exchange integration, we recommend that you review Chapter 1, “Planning for Cisco Unified Presence Integration with Microsoft Exchange”.

• Microsoft Exchange 2007 Configuration Checklist (EWS), page 3-1

• Verifying Permissions on the Exchange 2007 Account, page 3-4

• Microsoft Exchange 2010 Configuration Checklist (EWS), page 3-5

• Verifying Permissions on the Exchange 2010 Account, page 3-8

• How to Enable Authentication on the Exchange 2007/2010 Virtual Directories, page 3-9

Microsoft Exchange 2007 Configuration Checklist (EWS)Before You Begin

Note that the steps required to configure Exchange 2007 server will differ depending on whether you use Windows Server 2003 or Windows Server 2008.

Table 3-1 provides a summary checklist to follow when configuring access to mailboxes on the Microsoft Exchange 2007 server on Windows Server 2003 and Window Server 2008. For detailed instructions, see the Microsoft Server 2007 documentation at the following URL: http://technet.microsoft.com/en-us/library/bb124558(EXCHG.80).aspx

3-1sence Release 8.5 and 8.6 with Microsoft Exchange

Page 2: exch0710

Chapter 3 Configuring Microsoft Exchange Server 2007 and 2010 for Integration with Cisco Unified Presence (over Microsoft Exchange 2007 Configuration Checklist (EWS)

Table 3-1 Configuration tasks for Microsoft Exchange 2007 Components

Task Procedure Important Notes

Grant Users the Permission to Sign in to the Service Account Locally

Exchange 2007 Configuration on Windows Server 2003

1. Sign into the Exchange 2007 server using a service account that has been delegated the Exchange View Only Administrator role.

2. Open the Domain Controller Security Settings window on the Exchange server.

3. Under Sccurity Settings in the left frame, navigate to Local Policies > User Rights Assignments.

4. Double-click Allow Log On Locally in the right frame of the console.

5. Select Add User or Group and navigate to the service account that you previously created and select it.

6. Select Check Names, and verify that the specified user is correct. Then select OK.

Exchange 2007 Configuration on Windows Server 2008

1. Sign into the Exchange 2007 server using a service account that has been delegated the Exchange View Only Administrator role.

2. Select Start.

3. Type gpmc.msc

4. Select Enter.

5. Open the Domain Controller Security Settings window on the Exchange server.

6. Under Sccurity Settings in the left frame, navigate to Local Policies > User Rights Assignments.

7. Double-click Allow Log On Locally in the right frame of the console.

8. Ensure that the Define these policy settings check box is selected.

9. Select Add User or Group and navigate to the service account that you previously created and select it. Then select OK.

10. Select Check Names, and verify that the specified user is correct. Then select OK.

11. Select Apply and OK in the Allow Log On Locally Properties dialog box.

12. Determine if your users SMTP address is alias @ FQDN. If it is not, you must impersonate using the user principal name (UPN). This is defined as alias@FQDN.

• For Exchange impersonation to work, all Exchange servers must be members of the Windows Authorization Access Group.

• The service account should not be a member of any of the Exchange Administrative Groups. Microsoft Exchange explicitly denies Impersonation for all accounts in those groups.

3-2Integration Guide for Configuring Cisco Unified Presence Release 8.5 and 8.6 with Microsoft Exchange

Page 3: exch0710

Chapter 3 Configuring Microsoft Exchange Server 2007 and 2010 for Integration with Cisco Unified Presence (over Microsoft Exchange 2007 Configuration Checklist (EWS)

Task Procedure Important Notes

Set Impersonation Permissions at the Server level

Via the Exchange Management Shell (EMS)

1. Open the EMS for command line entry.

2. Run this Add-ADPermission command to add the impersonation permissions on the server.

SyntaxAdd-ADPermission -Identity (get-exchangeserver).DistinguishedName -User (Get-User -Identity User | select-object).identity -AccessRights GenericAll -InheritanceType Descendents

ExampleAdd-ADPermission -Identity (get-exchangeserver).DistinguishedName -User (Get-User -Identity Ex2007 ¦ select-object).identity -AccessRights GenericAll -InheritanceType Descendents

• These cmdlets grant impersonation permissions at the server level. You can also grant permissions at the database, user, and contact levels.

• If you have multiple servers, you must grant Impersonation to each server (or database). Exchange 2007 does not have system-wide Impersonation permission capability.

• Verify that the SMTP address of your users is defined as alias@FQDN. If it is not, you must impersonate the user account using the User Principal Name (UPN).

Set Active Directory Service Extended Permissions for the Service Account:

Via the Exchange Management Shell (EMS)

1. Run this Add-ADPermission command in the EMS to add the impersonation permissions on the server for the identified service acccount (for example, Exch2007).

SyntaxAdd-ADPermission -Identity (get-exchangeserver).DistinguishedName -User (Get-User -Identity User | select-object).identity -ExtendedRight ms-Exch-EPI-Impersonation

ExampleAdd-ADPermission -Identity (get-exchangeserver).DistinguishedName -User (Get-User -Identity Ex2007 ¦ select-object).identity -ExtendedRight ms-Exch-EPI-Impersonation

2. Run this Add-ADPermission command in the EMS to add the impersonation permissions to the service account on each mailbox that it impersonates:

SyntaxAdd-ADPermission -Identity (get-exchangeserver).DistinguishedName -User (Get-User -Identity User | select-object).identity -ExtendedRight ms-Exch-EPI-May-Impersonate

ExampleAdd-ADPermission -Identity (get-exchangeserver).DistinguishedName -User (Get-User -Identity Ex2007 ¦ select-object).identity -ExtendedRight ms-Exch-EPI-May-Impersonate

• You must set these permissions (on the Client Access Server (CAS)) for the service account that performs the impersonation.

• If the CAS is located behind a load-balancer, grant the ms-Exch-EPI-Impersonation rights to the Ex2007 account for all CAS servers behind the load-balancer.

• If your mailbox servers are located on a different machine to the CAS servers, grant ms-Exch-EPI-Impersonation rights for the Ex2007 account for all mailbox servers.

• You can also set these permissions by using Active Directory Sites and Services or the Active Directory Users and Computers user interfaces.

3-3Integration Guide for Configuring Cisco Unified Presence Release 8.5 and 8.6 with Microsoft Exchange

Page 4: exch0710

Chapter 3 Configuring Microsoft Exchange Server 2007 and 2010 for Integration with Cisco Unified Presence (over Verifying Permissions on the Exchange 2007 Account

Troubleshooting Tips

Cisco Unified Presence only requires Receive As permissions on the account to enable it to sign in to that account when it connects to the Exchange server. Note that this account does not typically receive mail so you do not need to be concerned about allocating space for it.

What To Do Next

Verifying Permissions on the Exchange 2007 Account, page 3-4

Verifying Permissions on the Exchange 2007 Account After you have assigned the permissions to the Exchange 2007 account, you must verify that the permissions propagate to mailbox level and that a selected user can access the mailbox and impersonate the account of another user. On Exchange 2007, it takes some time for the permissions to propagate to mailboxes.

Before You Begin

Delegate the appropriate permissions to the Exchange account. See the Microsoft Exchange 2007 Configuration Checklist (EWS) topic.

Grant Send As Permissions to the Service Account and User Mailboxes

Via the Exchange Management Shell (EMS)

Run this Add-ADPermission command in the EMS to grant Send As permisisons to the service account and all associated mailbox stores:

SyntaxAdd-ADPermission -Identity (get-exchangeserver).DistinguishedName -User (Get-User -Identity User | select-object).identity -ExtendedRights Send-As

ExampleAdd-ADPermission -Identity (get-exchangeserver).DistinguishedName -User (Get-User -Identity Ex2007 ¦ select-object).identity -ExtendedRights Send-As

You cannot use the Exchange Management Console (EMC) to complete this step.

Grant Receive As Permissions to the Service Account and User Mailboxes

Via the Exchange Management Shell (EMS)

Run this Add-ADPermission command in the EMS to grant Receive As permisisons on the service account and all associated mailbox stores:

SyntaxAdd-ADPermission -Identity (get-exchangeserver).DistinguishedName -User (Get-User -Identity User | select-object).identity -ExtendedRights Receive-As

ExampleAdd-ADPermission -Identity (get-exchangeserver).DistinguishedName -User (Get-User -Identity Ex2007 ¦ select-object).identity -ExtendedRights Receive-As

You cannot use the Exchange Management Console (EMC) to complete this step.

Task Procedure Important Notes

3-4Integration Guide for Configuring Cisco Unified Presence Release 8.5 and 8.6 with Microsoft Exchange

Page 5: exch0710

Chapter 3 Configuring Microsoft Exchange Server 2007 and 2010 for Integration with Cisco Unified Presence (over Microsoft Exchange 2010 Configuration Checklist (EWS)

Procedure

Step 1 In the EMC on the Exchange 2007 server, right-click Active Directory Sites and Services in the console tree.

Step 2 Point to View, and then select Show Services Node.

Step 3 Expand the service node, for example, Services/MS Exchange/First Organization/Admin Group/Exchange Admin Group/Servers.

Step 4 Verify that the CAS is listed for th e service node that you selected.

Step 5 View the “Properties” of each CAS server, and under the Security tab, verify that:

a. Your service account is listed.

b. The permissions granted on the services account indicate (with a checked box) that the Exchange Web Services Impersonation permission is allowed on the account.

Step 6 Verify that the service account (for example, Ex2007) has been granted Allow impersonationpermission on the storage group and the mailbox store to enable it to exchange personal information and to send as and receive as another user account.

Troubleshooting Tips

• If the account or the impersonation permissions do not display as advised in Step 5, you may need to recreate the service account and ensure that the required impersonation permissions are granted to the account.

• You may be required to restart the Exchange server for the changes to take effect. This has been observed during testing.

What To Do Next

How to Enable Authentication on the Exchange 2007/2010 Virtual Directories, page 3-9.

Microsoft Exchange 2010 Configuration Checklist (EWS)Table 3-3 provides a summary checklist to follow when configuring access to mailboxes on the Microsoft Exchange 2010 server. For detailed instructions, see the Microsoft Server 2010 documentation at the following URL: http://technet.microsoft.com/en-us/library/bb124558.aspx

Before You Begin

Before you integrate Microsoft Exchange 2010 server with Cisco Unified Presence over EWS, ensure that you configure the following throttle policy parameter values on the Exchange server. These are the values that are required for the EWS calendaring integration with Cisco Unified Presence to work.

3-5Integration Guide for Configuring Cisco Unified Presence Release 8.5 and 8.6 with Microsoft Exchange

Page 6: exch0710

Chapter 3 Configuring Microsoft Exchange Server 2007 and 2010 for Integration with Cisco Unified Presence (over Microsoft Exchange 2010 Configuration Checklist (EWS)

Table 3-2 Recommended Throttle Policy Parameter Values on Microsoft Exchange

Parameter Recommended Configuration Value

EWSMaxConcurrency It has been observed during Cisco tests that the default throttling policy value is sufficient to support 50% calendaring-enabled users. If you have a higher load of EWS requests to the CAS, however, we recommend that you increase this parameter to 100.

EWSPercentTimeInAD 50

EWSPercentTimeInCAS 90

EWSPercentTimeInMailboxRPC 60

EWSMaxSubscriptions 5000

EWSFastSearchTimeoutInSeconds 60

EWSFindCountLimit 1000

3-6Integration Guide for Configuring Cisco Unified Presence Release 8.5 and 8.6 with Microsoft Exchange

Page 7: exch0710

Chapter 3 Configuring Microsoft Exchange Server 2007 and 2010 for Integration with Cisco Unified Presence (over Microsoft Exchange 2010 Configuration Checklist (EWS)

Table 3-3 Configuration tasks for Microsoft Exchange 2010 Components

Task Procedure Important Notes

Set Exchange Impersonation Permissions for Specific Users or Groups of Users

Via the Exchange Management Shell (EMS)

1. Open the EMS for command line entry.

2. Run the New-ManagementRoleAssignment command in the EMS to grant a specified service account (for example, Ex2010) the permission to impersonate other user accounts:

Syntaxnew-ManagementRoleAssignment -Name:_suImpersonateRoleAsg -Role:ApplicationImpersonation -User:user@domain

Examplenew-ManagementRoleAssignment -Name:_suImpersonateRoleAsg -Role:ApplicationImpersonation -User:Ex2010@domain

3. Run this New-ManagementRoleAssignment command to define the scope to which the impersonation permisisons apply. In this example, the Exch2010 account is granted the permission to impersonate all accounts on a specified Exchange Server.

Syntaxnew-ManagementScope -Name:_suImpersonateScope -ServerList:<server name>

Examplenew-ManagementScope -Name:_suImpersonateScope -ServerList:nw066b-227

4. Run the New-ThrottlingPolicy command to create a new Throttling Policy with the recommended values defined in Table 3-2.

SyntaxNew-ThrottlingPolicy -Name:”<Policy Name>” -EWSMaxConcurrency:100 -EWSPercentTimeInAD:50 -EWSPercentTimeInCAS:90 -EWSPercentTimeInMailboxRPC:60 -EWSMaxSubscriptions:5000-EWSFastSearchTimeoutInSeconds:60-EWSFindCountLimit:1000

ExampleNew-ThrottlingPolicy -Name:”Cisco Unified Presence ThrottlingPolicy” -EWSMaxConcurrency:100 -EWSPercentTimeInAD:50 -EWSPercentTimeInCAS:90 -EWSPercentTimeInMailboxRPC:60 -EWSMaxSubscriptions:5000 -EWSFastSearchTimeoutInSeconds:60 -EWSFindCountLimit:1000

5. Run the Set-ThrottlingPolicyAssociation command to associate the new Throttling Policy with the service account used in Step 2 above.

SyntaxSet-ThrottlingPolicyAssociation -Identity “<Username>” -ThrottlingPolicy “<Policy Name>”

ExampleSet-ThrottlingPolicyAssociation -Identity “Ex2010” -ThrottlingPolicy “Cisco Unified Presence ThrottlingPolicy”

To use the EWS autodiscover service, the impersonation user must have a mailid set explicitly in LDAP so that it synchronizes to Cisco Unified Presence from Cisco Unified Communications Manager.

3-7Integration Guide for Configuring Cisco Unified Presence Release 8.5 and 8.6 with Microsoft Exchange

Page 8: exch0710

Chapter 3 Configuring Microsoft Exchange Server 2007 and 2010 for Integration with Cisco Unified Presence (over Verifying Permissions on the Exchange 2010 Account

What To Do Next

Verifying Permissions on the Exchange 2010 Account, page 3-8

Related Topics

For a complete description of the Microsoft Exchange server parameters, see here: http://technet.microsoft.com/en-us/library/dd351045.aspx

Verifying Permissions on the Exchange 2010 AccountAfter you have assigned the permissions to the Exchange 2010 account, you must verify that the permissions propagate to mailbox level and that a selected user can access the mailbox and impersonate the account of another user. On Exchange 2010, it takes some time for the permissions to propagate to mailboxes.

Before You Begin

• Delegate the appropriate permissions to the Exchange account. See the Microsoft Exchange 2010 Configuration Checklist (EWS) topic.

Procedure

Step 1 Open the Exchange Management Shell (EMS) for command line entry.

Step 2 Verify that the service account has been granted the required Impersonation permissions:

a. Run this command in the EMS:

Get-ManagementRoleAssignment -Role ApplicationImpersonation

b. Ensure that the command output indicates role assignments with the Role "ApplicationImpersonation” for the specified account as follows:

Example: Command Output

Step 3 Verify that the management scope that applies to the service account is correct:

a. Run this command in the EMS:

Get-ManagementScope _suImpersonateScope

b. Ensure that the command output returns the impersonation account name as follows:

Example: Command Output

Name

- - - - - - Role

- - - -RoleAssigneeName

- - - - - - - - - - - - -RoleAssigneeType

- - - - - -

AssignmentMethod

- - - - -

EffectiveUserName- - - - - - - - -

_suImpersonateRoleAsg

ApplicationImpersonation

ex 2010 User Direct ex 2010

Name

- - - - - - ScopeRestrictionType

- - - -Exclusive

- - - - - - - - RecipientRoot

- - - - - - RecipientFilter

- - - - -

ServerFilter

- - - - - - - - -

_suImpersonateScope

ServerScope False DistinguishedName

3-8Integration Guide for Configuring Cisco Unified Presence Release 8.5 and 8.6 with Microsoft Exchange

Page 9: exch0710

Chapter 3 Configuring Microsoft Exchange Server 2007 and 2010 for Integration with Cisco Unified Presence (over How to Enable Authentication on the Exchange 2007/2010 Virtual Directories

Step 4 Verify that the ThrottlingPolicy parameters match what is defined in Table 3-2.

a. Run this command in the EMS:

Get-ThrottlingPolicy -Identity “<Policy Name>” | findstr ^EWS

b. Ensure that the command output has the same values defined in Table 3-2:

What To Do Next

How to Enable Authentication on the Exchange 2007/2010 Virtual Directories, page 3-9

How to Enable Authentication on the Exchange 2007/2010 Virtual Directories

You must enable basic authentication on the Exchange virtual directories (/exchange or /exchweb) for Microsoft Office Outlook Web Access to work properly. The /exchange directory handles mailbox access requests for OWA and WebDAV. The /exchweb directory contains resource files used by OWA and WebDAV.

• Enabling Authentication on Exchange 2007 Running Windows Server 2003, page 3-9

• Enabling Authentication on Exchange 2010 Running Windows Server 2008, page 3-10

Enabling Authentication on Exchange 2007 Running Windows Server 2003

Procedure

Step 1 From Administrative Tools, open Internet Information Services. and select the server.

Step 2 Select Web Sites.

Step 3 Select Default Web Site.

Step 4 Right click either the Exchange or Exchweb directory folders, and select Properties.

Step 5 Select the Directory Security tab.

Step 6 Under Authentication and access control, select Edit.

Step 7 Under Authentication, verify that these check boxes are checked:

– Basic Authentication (password is sent in clear text)

– Integrated Windows authentication

What To Do Next

Configuring the Presence Gateway on Cisco Unified Presence for Microsoft Exchange Integration, page 4-1

3-9Integration Guide for Configuring Cisco Unified Presence Release 8.5 and 8.6 with Microsoft Exchange

Page 10: exch0710

Chapter 3 Configuring Microsoft Exchange Server 2007 and 2010 for Integration with Cisco Unified Presence (over How to Enable Authentication on the Exchange 2007/2010 Virtual Directories

Enabling Authentication on Exchange 2010 Running Windows Server 2008

Procedure

Step 1 In the Exchange Management console, locate the virtual directory that you want to configure to use Integrated Windows authentication.

Step 2 Select Server Configuration.

Step 3 Select Client Access.

Step 4 Select the server hosting the Outlook Web App virtual directory.

Step 5 Select the Outlook Web App tab.

Step 6 In the work pane, select the virtual directory that you want to configure to use Integrated Windows authentication and right-click it.

Step 7 Select Properties.

Step 8 Select the Authentication tab.

Step 9 Under Authentication, verify that these check boxes are checked:

– Basic Authentication (password is sent in clear text)

– Integrated Windows authentication

Step 10 Check Basic Authentication (password is sent in clear text).

Step 11 Select OK.

Step 12 Select the Exchange Control Panel directory.

Step 13 In the work pane, right-click the directory that you want to configure to use Integrated Windows authentication and select select Use one or more standard authentication methods.

Step 14 Select Basic authentication (password is sent in clear text).

Step 15 Select OK.

Step 16 Enter the following command in the CLI to restart IIS for the changes to take effect:iisreset /noforce

Step 17 In the Control Panel, verify IIS Admin Service and World Wide Publishing Service are in a started state.

What To Do Next

Configuring the Presence Gateway on Cisco Unified Presence for Microsoft Exchange Integration, page 4-1

Related Topics

• http://technet.microsoft.com/en-us/library/aa998849.aspx

• http://technet.microsoft.com/en-us/library/ee633481.aspx

3-10Integration Guide for Configuring Cisco Unified Presence Release 8.5 and 8.6 with Microsoft Exchange