Oracle Waveset 8.1.1 Resources Reference

authenticate Action

Use the authentication action to authenticate user IDs/passwords against the customer’s database. If you do not define the authentication action, the resource cannot support pass-through authentication.

Context

The actionContext map contains the following entries:

Key  

Value Type  

Value Description  

conn

java.sql.Connection 

JDBC connection to the customer’s database 

adapter

com.wavset.adapter.ScriptedJdbcResourceAdapter 

Adapter instance 

action

java.lang.String 

The authenticateUser string

id

java.lang.String 

Account ID of the user to authenticate 

password

java.lang.String 

The decrypted password to authenticate 

result

java.util.Map 

The script can add an entry with the expired key and a Boolean.TRUE value to indicate that the user’s password has expired.

errors

java.util.List 

Initially, this value is an empty list. 

The script may add java.lang.String objects to this list if any errors are found during processing.

trace

com.waveset.adapter.Trace 

Object used to trace execution. 

Scripts can use the methods of this class to make themselves “debuggable” in a customer environment. 

Error Handling

If the script executes without failure, the ID and password are considered valid.

Any throw from within the script is considered an authentication failure.

If the script encounters any errors, the script may alias appropriate strings to the errors key. The presence of any items in the errors List is considered an authentication failure.