What You Should Know About External Applications

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. 25-6 Oracle Fusion Middleware Administrators Guide for Oracle WebCenter 7. Select the authentication method used by the external application. For details, see Table 25–3 . 8. Specify additional login fields and details, if required. For details, see Table 25–4, External Application Connection - Additional Login Fields . HTML User Password Field Name Enter the name that identifies the password field on the login form. Tip: To find this name, look at the HTML source for the login page. Mandatory if the Authentication Method is GET or POST. Leave this field blank if the application uses BASIC authentication see Authentication Method. Table 25–3 External Application Connection - Authentication Details Field Description Authentication Method Select the form submission method used by the external application. Choose from one of the following: ■ GET : Presents a page request to a server, submitting the login credentials as part of the login URL. This authentication method may pose a security risk because the user name and password are exposed in the URL. ■ POST : Submits login credentials within the body of the form. This is the default. ■ BASIC : Submits login credentials to the server as an authentication header in the request. This authentication method may pose a security risk because the credentials can be intercepted easily and this scheme also provides no protection for the information passed back from the server. The assumption is that the connection between the client and server computers is secure and can be trusted. The Authentication Method specifies how message data is sent by the browser. You can find this value by viewing the HTML source for the external applications login form, for example, form method=POST action=https:login.yahoo.comconfiglogin? AutoComplete=off Table 25–2 Cont. External Application Connection - Login Details Field Description Managing External Applications 25-7 9. Specify shared and public user credentials, if required. For details, see Table 25–5 .

10. Click OK to register the application.

Table 25–4 External Application Connection - Additional Login Fields Field Description Additional Login Fields If your application requires additional login criteria, expand Additional Login Fields . For example, in addition to user name and password, the Lotus Notes application requires two additional fields - Host and MailFilename. Click Add to specify an additional field for the login form. For each new field, do the following: ■ Name - Enter the name that identifies the field on the HTML login form that may require user input to log in. This field is not applicable if the application uses basic authentication. ■ Value - Enter a default value for the field or leave blank for a user to specify. This field is not applicable if the application uses basic authentication. ■ Display to User - Select to display the field on the external application login screen. If the field is not displayed unchecked, then a default Value must be specified. Click Delete to remove a login field. Table 25–5 External Application Connection - Shared User and Public User Credentials Field Description Enable Shared Credentials Indicate whether this external application enables shared user credentials, and specify the credentials. Select Enable Shared Credentials , and then enter User Name and Password credentials for the shared user. When shared credentials are specified, every user accessing this external application, through the WebCenter application, is authenticated using the user name and password defined here. WebCenter users are not presented with a login form. Because WebCenter users do not need to define personal credentials of their own, external applications with shared credentials are not listed in the external applications change password task flows such as My Accounts. See alsoProviding Login Information for External Applications in Oracle Fusion Middleware Users Guide for Oracle WebCenter. Enable Public Credentials Indicate whether unauthenticated users public users may access this external application. Select Enable Public Credentials , and then enter User Name and Password credentials for the public user. When public credentials are specified, public users accessing this external application through the WebCenter applications public pages are logged in using the username and password defined here. If public credentials are not specified, public users will see an authorization error indicating this external application is not accessible to public users.