Windows Server Installation Instructions

1. Ensure you have the .NET 2.0 framework installed.

2. Place the extracted ADAuthenticationWebService in whatever location is desired.  The root of the default web site is c:\inetpub\wwwroot, but it is not necessary for this web service to be put in that location.
NOTE: In step 3 all instructions related to application pools apply to windows server 2003 only, not windows server 2000.

3. In IIS Manager create a new virtual directory for the web service and point this virtual directory to the extracted ADAuthenticationWebService directory.  If there are other webs that use .NET 1.1 then a new application pool will need to be created for this web service.  To create an application pool right-click Application Pools (above Web Sites) in IIS Manager and select New->Application Pool.  Using the default settings is fine.  Configure this web to use .NET 2.0 (the ASP .NET tab in the Property pages) and to use the new application pool if necessary (the Virtual Directory tab in the Property pages).

A simple test program is included with this package.  To run it, execute ADAuthenticatorWebServiceTest.exe found in the extracted ADAuthenticationWebService folder.  Enter the virtual path to the web service on your server, then enter a user name, password, and the domain of the server and click Authenticate.  If the test is successful, a messagebox saying "Authenticated!" will pop up.  A failure will result in an "Incorrect username or password" message.

Define Web Service in Residency Partner™

1. Enter the URL to the web service under the menu, Institution/Residency Partner/Residency Partner Options.  

2. Select the Users tab and enter the text below into the ‘Ad Web Service’ field using your server name.

       ‘http://{server}/ADAuthenticationWebService/ADAuthenticate.asmx\’

3. Check the ‘Assume Active Directory for new users’ box

4. Enter your DOMAIN into the ‘User this domain…’ text box.

Configure Residency Partner™ User Account

Residency Partner uses the AD Web Service based on individual user’s login settings. All users must have a Residency Partner user account.  To create/edit user accounts select the menu File/User Access, select a user then click Edit. Their username must match their AD account. A password should not be entered. To use AD, select the radio button ‘Active Directory Authentication’. A ‘Domain’ is not required to be entered here. This ‘Domain’ will override the domain defined in Residency Partner Options.