Troubleshooting Pagelets Oracle Fusion Middleware Online Documentation Library

Managing External Applications 25-3 Figure 25–1 Edit External Application

25.2 Registering External Applications

You can register external applications for WebCenter applications through Fusion Middleware Control or using WLST commands. Before registering an external application, access the applications login page and examine the HTML source for the applications login form. All the registration details you require are located in the form tag. For example, the underlying code for the Yahoo Mail login form looks something like this: form method=post action=https:login.yahoo.comconfiglogin? autocomplete=off name=login_form ... tdinput name=login size=17td ... tdinput name=passwd size=17td ... In this example, to provide WebCenter users with a direct link to the Yahoo Mail application, the following sample registration information is required: Registration Information Sample Value HTML Source Login URL https:login.yahoo.comconfig login? action User Name User ID Field login name=login Password Field Name: passwd name=passwd Authentication Method post method 25-4 Oracle Fusion Middleware Administrators Guide for Oracle WebCenter For information about services that use external applications, see the section Secured Service Connections in Oracle Fusion Middleware Developers Guide for Oracle WebCenter. This section includes the steps for: ■ Section 25.2.1, Registering External Applications Using Fusion Middleware Control ■ Section 25.2.2, Registering External Applications Using WLST ■ Section 25.2.3, Registering External Applications in WebCenter Spaces ■ Section 25.2.4, Registering External Applications in WebCenter Portal Applications

25.2.1 Registering External Applications Using Fusion Middleware Control

To register an external application:

1. Login to Fusion Middleware Control and navigate to the home page for your

WebCenter application or WebCenter Spaces: ■ Section 6.3, Navigating to the Home Page for WebCenter Portal Applications . ■ Section 6.2, Navigating to the Home Page for WebCenter Spaces

2. Do one of the following:

■ For WebCenter Portal applications: from the Application Deployment menu, choose WebCenter Service Configuration. ■ For WebCenter Spaces: from the WebCenter menu, choose Settings Service Configuration .

3. From the list of services on the WebCenter Service Configuration page, choose

External Applications .

4. To register a new external application, click Add

Figure 25–2 . Figure 25–2 Configuring External Application Connections 5. Enter a unique name for the external application and a display name that WebCenter users working with this external application will see. Note: External application configuration is dynamic. New external applications and updates to existing applications are immediately available; there is no need to restart the WebCenter application. Managing External Applications 25-5 See also, Table 25–1 . 6. Enter login details for the external application. For details, see Table 25–2 . Table 25–1 External Application Connection - Name Field Description Application Name Enter a name for the application. The name must be unique across all connection types within the WebCenter application. For example: yahoo Note: Once registered, you cannot edit the Application Name. Display Name Enter a user friendly name for the application that WebCenter users will recognize. WebCenter end-users working with this external application will see the display name you specify here. For example: My Yahoo If you leave this field blank, the Application Name is used. Table 25–2 External Application Connection - Login Details Field Description Enable Automatic Login Select to allow automatically log users in to this application. Choosing this option requires you to complete the Login URL, HTML User ID Field Name, and HTML User Password Field Name fields With automated single sign-on, the user directly links to the application and is authenticated automatically, as their credentials are retrieved from the credential store. Selecting this option provides the end user with a seamless single sign-on experience. Note: Automated login is not supported for: ■ External applications using BASIC authentication. ■ External applications configured for SSO. ■ External applications with a customized login form built using ADF Faces that does not implement the J2EE security container login method j_security_check for authentication. ■ External sites that do not support UTF8 encoding. Login URL Enter the login URL for the external application. To determine the URL, navigate to the applications login page and record the URL. For example: http:login.yahoo.comconfiglogin Note: A login URL is not required if the sole purpose of this external application is to store and supply user credentials on behalf of another service. HTML User ID Field Name Enter the name that identifies the user name or user ID field on the login form. Tip: To find this name, look at the HTML source for the login page. This property does not specify user credentials. Mandatory if the Authentication Method is GET or POST. Leave this field blank if the application uses BASIC authentication see Authentication Method.