作为External Application集成Jive Forum的单点登录

在OracleAS的单点登录（SSO）体系中，包括了两种应用整合方式，其一称为External Application模式，该模式采用虚拟二次登录的方式实现单点登录，应用程序的认证部分不作任何修改；其二称为Pattern Application模式，显而易见在该模式下就需要对应用系统作出一定的改造，首先应用系统需要支持LDAP的认证方式，需要在其应用服务器端安装SSO模块用于与SSO服务器通讯，并将用户信息传递到应用中，原有的认证方式将被屏蔽。本文主要研究了Jive Forum应用系统采用External Application模式进行SSO集成的实例，关于其它内容将在后续文章中详述。

Introduction

This document describes how you should register the Jive Forums application as an external application with OracleAS Portal.  It also describes how you can register the OracleAS Provider for Jive Forums with your OracleAS Portal and how to add the provider's portlets to your portal page.  You should use these instructions if:

• You have have deployed the Professional Edition of Jive Forums
  and/or,
• Your Jive Forum Application is deployed on a stand alone OC4J instance.

Creating the External Application

• Login to OracleAS Portal as an OracleAS Portal Administrator.  Go to the Administer tab of the OracleAS Portal Builder page.  In the SSO Server Administration portlet, click Administer External Applications.
• Click on Add External Application.  In the External Application Login and Authentication Method sections, enter the following:
  • Application Name: JiveExternalApp
  • Login URL: http://<Server>:<Port>/<jiveContext>/extAppLogin

example: if your Jive Forums' url looks like, http://my.company.com/jive3 , then your Login URL will be http://my.company.com/jive3/extAppLogin

• • User Name/ID Field Name: username
  • Password Field Name: password
  • Type of Authentication Used: Select POST
  • In the additional field section, leave it empty.
  • Click OK. 
  • Now click on the link for your new JiveExternalApp application and enter the Username and Password.  
  • Remember My Login Information... checkbox must be checked.
  • If successful, you should get the message "Success:    Successfully authenticated the user".
  • If unsuccessful, you will get an "Failed to authenticate the user with the credentials supplied." message. Go back to the External Application and pass the correct credentials.

Registering the Provider

1. Login to OracleAS Portal as an OracleAS Portal Administrator.  Go to the Administer tab of the OracleAS Portal Builder page.
2. Under the Portlets tab, click on Register a Provider within the Remote Providers portlet.
3. Fill out provider information for the  Provider:
   • Name: OracleAS_Provider_for_Jive_Forums
   • Display Name: OracleAS Provider for Jive Forums
   • Timeout: 30
   • Timeout Message: OracleAS Provider for Jive Forums Timed Out
   • Implementation Style: Web
4. Click on the Next button to enter the Web Provider specific information
5. Enter the Web Provider location
   • URL: http://<server>:<port>/<jiveContext>/providers/forum

example: if your jive url looks like, http://my.company.com/jive3, then your web provider location is http://my.company.com/jive3/providers/forum

6. Check the check-box stating "Web provider in same cookie domain as portal"
   
7. Select the radio button labeled The user's identity needs to be mapped to a different name....  In the External Application ID field, select the ID corresponding to JiveExternalApp application you created in the previous section.
8. Scroll down to the User/Session Information section and specify the login frequency as Once Per Session.
9. Click on the Finish button to complete the registration

Note: When registering a new provider with OracleAS Portal, only the user who registered the provider has privileges to see the provider/portlets. If necessary, go to the Folder with the name of the provider within the Portlet Repository content area and update the provider privileges as required.

Adding the OracleAS Provider for Jive Forums' Portlets to a Portal Page

You are now ready to add the OracleAS Provider for Jive Forums Portlets to a page.

Note: After adding the portlets to an OracleAS Portal page, If you are logged on as a user other than the OracleAS Portal administrator,  you will be asked to update the login information for the External Application before viewing the portlets.  Click on the Update Login Information link and enter your  user credentials: Username, Password to view the portlet.