Customizing the Login Page

[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

You can customize the Communicator Web Access login page header and footer with your organization’s name or branding.

Note

The files containing any content used by a customized login page, tab, or menu, must be in a trusted location on the network.

To customize the login page

  1. Create the content that you want to display on the Communicator Web Access login page in the form of an HTML document, and then save that content to a location on your network that will be accessible to Communicator Web Access.

  2. Ensure that customized content complies with legal requirements, including copyright and trademark restrictions.

  3. On the computer running the Communicator Web Access server, use a text editor to open the CustomConfig.xml file in the <drive>:\Program Files\Microsoft Office Communications Server 2007 R2\Communicator Web Access\Server\CWA\Client folder.

  4. In the CustomConfig.xml file, the <logon> element uses the following schema:

    <logon active = “false”>
    <header>https://contoso.com/header.html</header>
    <footer>https://contoso.com/footer.html</footer>
    <headerframeheight>100</headerframeheight>
    <footerframeheight>100</footerframeheight>
    </logon>
    
  5. Configure the following elements to customize the header and footer on the login page:

    Element Attribute Description Allowable Values

    logon

    Refers to the customizable header and footer on the login page.

    active

    Whether the login page will display a customized header or footer.

    TRUE, FALSE

    If TRUE, the login page will display a customized header or footer as configured.

    If FALSE, the login page will display the default login page.

    header

    The URL of the file that should be loaded into the header iFrame on the login page if the active attribute of the <logon> element is set to TRUE.

    A URL that is accessible to users. Preferably, an HTTPS URL that is accessible to external users if you are supporting external user access.

    footer

    The URL of the file that should be loaded into the footer iFrame in the login page if the active attribute of the <logon> element is set to TRUE.

    A URL that is accessible to users. Preferably, an HTTPS URL that is accessible to external users if you are supporting external user access.

    headerframeheight

    The height, in pixels, of the header iFrame.

    A numeric string.

    footerframeheight

    The height, in pixels, of the footer iFrame.

    A numeric string.

  6. When you are finished, save and then close the CustomConfig.xml file.

  7. Click Start, and then click Run. In the Open box, type cmd, and then click OK.

  8. At the command prompt, type iisreset /restart to begin displaying the new content.