OracleAS Portal Integration Solutions
Oracle Application Server SMTP Portlet - Installation Instructions

Contents

Introduction
Deploying the Provider
Publishing the Portlet

Registering the Provider
Adding the Portlet

Introduction

The OracleAS SMTP Portlet only allows for the sending of messages; it does not allow for the receiving of messages.  Please use the OracleAS Internet Message Access Protocol (IMAP) Portlet if you need one to receive messages as well.  You can find the OracleAS IMAP Portlet, as well as the other Portal Integration Solutions downloads, on the Portal Integration Solutions page on the Oracle Technology Network (OTN) Portal Center.

The Simple Mail Transfer Protocol (SMTP) portlet supports the following features:

• Integrates with the Single Sign-On (SSO) Server being used by your OracleAS Portal, to provide LDAP Address Book mappings.
• Allows Users to pick the addresses from Oracle Identity Management while composing mails.
• Allows rich set of mail formats to be sent (multipart mails).
• Allows messages to be sent in Text, HTML or both the formats.
• Allows attachments to be sent with the messages.
• Provides user friendly interface to interact with.

• Mail Server configuration details
• Identity Management/LDAP Configuration

User Interface

When added to an OracleAS Portal page, this portlet provides the following user interface components:

Compose Message Page

Deploying the Provider

Publishing the Portlet

Creating the External Application

• Login to OracleAS Portal as an OracleAS Portal Administrator.  Go to the Administer tab of the OracleAS Portal Builder.  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: SmtpExternalApp
• Login URL: http://your_oc4j_hostname:port/smtp/login
• User Name/ID Field Name: user
• Password Field Name: password
• Type of Authentication Used: Select POST
In the additional field section, add the following:
 

Field Name	Field Value	Display to User
smtpHost	smtpServerName.domain	Check this box
smtpPort	<you can enter -1 to select a default port>	Check this box

• Click OK. 
• Now click on the link for your new SmtpExternalApp application and enter the Username and Password.  While supplying the values, you should ensure that user field contains user name with the domain information, e.g. username@domain

  Remember My Login Information... checkbox must be checked.

• If successful, you should get the message like "You have successfully registered with Portal".
• 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 right credentials.

Registering the Provider

1. Login to OracleAS Portal using an account that has build privileges. If your home page is not the Build/Administer page, click on the Builder link in the top right corner of the screen. Click on the Build tab if that is not the active tab.
2. Under the Build tab (on OracleAS Portal Home Page), click on Register Portlet Provider within the portlet called Providers.
3. Fill out provider information for the SMTP Provider:
• Name: SmtpProvider
• Display Name: SMTP Portlet Provider
• Timeout: 100
• Timeout Message: SMTP Portlet Provider 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://your_oc4j_hostname:port/smtp/providers/smtp
6. 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 SmtpExternalApp application you created in the previous step.
7. Scroll down to the User/Session Information section and specify the login frequency as Once Per Session.
8. Click on the Finish button to complete the registration

Adding the Portlet to a Page

Note: 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 you can view the contents of the portlet.  Click on the Update Login Information link and enter your SMTP user credentials: Username, Password, smtpHost and smtpPort.

While supplying the values, you should ensure that user field contains user name with the domain information, e.g. username@domain

Trademarks

Oracle and the Oracle logo are trademarks or registered trademarks of Oracle Corporation in the United States and other countries.

All other names are trademarks and/or registered trademarks of their respective owners.