Configure a service to identify the relying party

This service identifies the relying party for authentication. For our purposes we want to identify AD FS as the relying party.

  1. In a text editor, create an XML file similar to the example.
    Note: In the example below, in the <USERNAMEFIELD> tag, the letter "l" (lowercase L, not a numeral) is used in the "ctl00..." portion of the string.
    <?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
    <BATCH_LOAD FORMAT="" OVERRIDE="false">
        <SERVICE>
            <HasCredential>true</HasCredential>
            <LoginProcedure>Form based</LoginProcedure>
            <ID>RELYING_PARTY_SERVICE_NAME</ID>
            <SvcEntryAttrList>password,USER</SvcEntryAttrList>
            <LOGINSCHEME NAME="Form">
    		        	<PROTOASSERT>Use HTTPS always</PROTOASSERT>
               <HTTPURL>http://YourADFSServer.YourDomain.com/adfs/ls/</HTTPURL>
               <HTTPSURL>https://YourADFSServer.YourDomain.com/adfs/ls/</HTTPSURL> 
               <PRIMARYTARGETLOOKUP>Use Claim Based</PRIMARYTARGETLOOKUP>
    	          <USERNAMEFIELD>ctl00$ContentPlaceHolder1$UsernameTextBox</USERNAMEFIELD>	
               <PASSWDFIELD>ctl00$ContentPlaceHolder1$PasswordTextBox</PASSWDFIELD>	
               <LOGIN_SUBMIT_METHOD>POST</LOGIN_SUBMIT_METHOD>	
               <LOGINSCHEMENAME>DEFAULT</LOGINSCHEMENAME>	
               <SERVICEURL>https://YourADFSServer.YourDomain.com/adfs/ls/</SERVICEURL>
           </LOGINSCHEME>
            <IdentityAttrList>USER</IdentityAttrList>
            <CredentialAttrList>PASSWORD</CredentialAttrList>
        </SERVICE>
    </BATCH_LOAD>
    
    1. For <ID>: Provide an ID for the AD FS server. These instructions assume the service is named "ADFS."
      <ID>ADFS</ID>
    2. For <LOGINSCHEME>, update the following parameters:
      • <HTTPURL>: Provide the fully qualified URL for the name of the AD FS installation. For example:

        <HTTPURL>http://YourAFDSServer.YourDomain.com:port/adfs/ls</HTTPURL>
      • <HTTPSURL>: Use the same URL that you used for <HTTPURL>

        <HTTPSURL>https://YourAFDSServer.YourDomain.com:port/adfs/ls</HTTPSURL>
      • <SERVICEURL>: Provide the fully qualified URL for the name of the AD FS installation. For example:

        <SERVICEURL>https://YourADFSServer.YourDomain.com:port/adfs/ls</SERVICEURL>
        Note: You can omit ":port#" from the string if you use the default HTTPS port (443).
  2. Save the XML definition file. It is a good idea to use a name that helps identify it, for example, ADFS_service.xml
    Note: If you need to reload the service after it was already loaded once (because for example you received an error message that led you to determine that your XML file needed updating), you will have to change the "OVERRIDE" parameter at the beginning of the file to "true".