It is not uncommon to brand the SSO login form to match the company’s requirement. OAM Server needs two user inputs (username, and password) and a parameter (request_id) submission from OAM Custom Login Form. As long as these requirements are met, this form can be customized to any extent. This has to be a server page (JSP or ASP), not an HTML form. The following are the requirements of the form from Oracle Documentation:

About Custom Login Pages

Only Schemes with the Challenge Method of FORM, X509, or DAP can have custom login forms/pages. All custom login pages must meet the following requirements:

  • Custom login pages require exactly two form fields (username and password). Oracle Access Manager supports authentication forms with two fields only.

  • CustomWar and external context types, require logic within the custom login page to perform the following two tasks:

    • Send back the request ID the page received from the Oracle Access Manager server. For example: String reqId = request.getParameter("request_id"); <input type="hidden" name="request_id" value="<%=reqId%>">

    • Submit back to the OAM Server the end point, "/oam/server/auth_cred_submit". For example: <form action="/oam/server/auth_cred_submit"> or http://oamserverhost:port/oam/server/auth_cred_submit.

$ cat  ssologin.jsp
<%@page language="java" import="java.util.*" pageEncoding="ISO-8859-1"%>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.
getServerPort()+path+"/";
String reqId = request.getParameter("request_id");
%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<base href="<%=basePath%>">

<title>OAM Custom Login Form</title>
<meta http-equiv="pragma" content="no-cache">
<meta http-equiv="cache-control" content="no-cache">
<meta http-equiv="expires" content="0">
<meta http-equiv="keywords" content="OAM,Custom,Login,Form">
<meta http-equiv="description" content="This is my page">
<!--
<link rel="stylesheet" type="text/css" href="styles.css">
-->
</head>

<body>
<br/>
<br/>
<div style="clear: both; text-align: center;">
<IMG alt=Logo src="images/netegrity_logo.gif">
<img src="images/remoteitc.gif" hight="72" width="72" alt="Welcome to www.remoteitc.com"/>
<br/>
<br/>
</div>

<form action="http://oam.remoteitc.com:14100/oam/server/auth_cred_submit" method="post">
<center>
<table width="50%" height=200 border=1 cellpadding=0 cellspacing=0 >
<tr> 
<td>
<table WIDTH="100%" HEIGHT=200 BGCOLOR="#E7E8E8" border=0 cellpadding=0 cellspacing=0 >
        <tr>
          <td ALIGN="CENTER" VALIGN="CENTER" HEIGHT=40 COLSPAN=4 NOWRAP BGCOLOR="#333436">
                <font color="#FFFFFF" size="+1" face="Arial,Helvetica">
                <b>Free Oracle Help - OAM Single Sign-On(SSO)</b></font>
              </td>
        </tr>
<tr>
<td>Login</td>
<td><input type="text" name="username"></td>
</tr>
<tr>
<td>Password</td>
<td><input type="password" name="password"></td>
</tr>
<tr>
<td></td>
<td><input type="hidden" name="request_id" value="<%=reqId%>"></td>
</tr>
<tr>
<td><input type="submit"></td>
<td>&nbsp;</td>
</tr>
</table>
</td>
</tr>
</table>
</center>
</form>
</body>
</html>