C
Adding and Editing SDK-Enabled Applications

The Administer Partner Applications page, accessible as a link on the SSO Server Administration page, is used to register and edit applications integrated with the single sign-on SDK. This page is also useful for viewing mod_osso configuration information. Starting with release 9.0.2, mod_osso is registered automatically by the installer.

If you use the UI to manually register an SDK-enabled partner application, bear in mind that you are registering the application only with the single sign-on server. To register the application in the partner application database, you must manually copy the registration information from the single sign-on UI.

This appendix contains the following topics:

• Add Partner Application Page

• Edit Partner Application Page

Add Partner Application Page

Selecting the Add Partner Applications link on the administration pages takes you to the Create Partner Applications page. Use the fields on this page, described in the tables immediately following, to register an application with the single sign-on server. Once you add the application, it appears with existing applications in a list sorted by date.

Table C-1 Partner Application Login

Field	Description
Name	Enter a unique name for the partner application.
Home URL	Enter the URL of the home page for the application.
Success URL	Enter the URL to the routine responsible for establishing the partner application's session and session cookies. This routine should redirect the browser to the URL that the user originally requested. The URL must point to a procedure that processes the user identification information from the single sign-on server. Include the http:// prefix in the URL. The following example shows a success URL for OracleAS Portal: http://server.domain.com:5000/pls/DAD/portal.wwsec_app_priv.process_signon
Logout URL	Enter the URL for the logout routine of the application. The single sign-off page invokes this URL in parallel with others, enabling users to simultaneously log out of the server and active partner applications.

Table C-2 Valid Login Timeframes

Field	Description
Start Date	Enter the date when users are first able to access the partner application through the single sign-on server. Use the format shown next to the field label.
End Date	Enter the date when users are last able to access the partner application through the single sign-on server. Use the format shown next to the field label. Note: If you leave this field blank, this partner application is valid for an indefinite period.

Table C-3 Application Administrator

Field	Description
Administrator E-mail	Enter the e-mail address of the administrator of the partner application.
Administrator Information	Enter any additional information that you want to include about the administrator of the partner application.

Edit Partner Application Page

The Edit Partner Application page contains all of the fields that are on the Create Partner Application page, plus five additional fields in the Partner Application Login section. Table C-4 describes the additional fields.

Table C-4 Fields on the Edit Partner Application Page

Field	Description
ID	The ID value is automatically set when a partner application is added. It is used by the single sign-on server to identify the partner application.
Token	The token is automatically set when a partner application is added. It is used by the single sign-on server to identify the partner application. The partner application must use the application token to identify itself to the single sign-on server when requesting authentication.
Encryption Key	The encryption key for the partner application.
Login URL	This is the same as the success URL, which sets the application session and cookies.
Single Sign-Off URL	This is the same as the URL for application logout.

Use the following steps to edit a partner application:

1. From the Administer Partner Applications page, choose an application from the list that appears under the Edit/Delete Partner Application heading.

2. Click the Edit link for that application. This link appears as a pencil icon.

3. On the Edit Partner Application page, edit the field values in Table C-1. These are the only values that can be edited.

4. Click Apply to store changes for the current screen and to display the updated screen. Click OK to store all changes and to return to the previous screen.