Getting started with the web application bridge

The portal administrator collects information about the content provider and its applications and then follows basic configuration steps to enable the web application bridge.

1. Set the context root for the wp.vwat.servlet.ear application:
   1. Log on to the WebSphere® Integrated Solutions Console.
   2. Go to Applications > Application Types > WebSphere enterprise applications.
   3. Find and click the wp.vwat.servlet.ear application link.
   4. Under the Web Module Properties heading, click Context Root For Web Modules.
   5. Change the context root to /. This step can create name conflicts. Add a rewrite rule to avoid these conflicts. For more information read Apache Module mod_rewrite and Providing short vanity URLs.
   6. Click OK.
   7. Click Save to save your changes to the master configuration.
   8. Stop and restart the wp.vwat.servlet.ear application.
2. The system administrator logs in to IBM® WebSphere Portal.
3. The system administrator goes to Administration > Portlet Management > Virtual Web Application Manager.
   Warning: Do not enter < or > into any of the text boxes. There is a known security issue. A user can write a JavaScript to hijack the Virtual Web Application Manager and Web Dock portlets.
4. The system administrator clicks Content Provider Profiles and then selects Create Content Provider Profiles.
5. The system administrator creates the content provider profiles.
6. The system administrator goes to the profile that was created and clicks Add policy to create a policy.
   Tip: The system administrator must create at least one policy for the content provider profile.
7. The system administrator clicks Web Dock Applications and then selects Create Web Dock Applications.
8. The system administrator creates the web dock applications.
9. The system administrator goes to the application that was created.
10. The system administrator selects one of the following tabs and then click Edit to configure the web dock settings:
    • Web Dock Display Settings
    • Client Side IPC for Web Dock
    • Server Side IPC for Web Dock
    • Plugins
11. The content author logs in to WebSphere Portal.
12. The content author accesses the site toolbar and takes one of the following actions:
    • Creates a page and adds the web dock application portlet to the page.
    • Edits an existing page and adds the web dock application portlet to the page.
    Tip: To get the web dock application to render on a page, the page must use the Web Dock profile. If necessary, edit the page properties and change the profile.
13. If a content author experiences issues with viewing the web dock applications, complete the following steps to update the user role:
    1. Log on to WebSphere Portal as the administrator.
    2. Go to Administration > Access > Resource Permissions.
    3. Search for the page that contains the web dock application.
    4. Give the content author the correct permissions to the page.
    5. If the content provider policy is set to use basic or form-based authentication, complete the following steps:
       • Go to the web dock application and give the content user the correct permissions.
       • Go to the credential vault used for the authentication. Give the content user the correct permissions to the credential vault.