handleTrackerRequest createTransaction Oracle Adaptive Access Manager APIs

4-6 Oracle Fusion Middleware Developers Guide for Oracle Adaptive Access Manager String digitalClientVersion, int fingerPrintType, String fingerPrint, int fingerPrintType2, String fingerPrint2; The returned object has functions to access its contents. They are: public String getFlashCookie public String getSecureCookie public String getRequestId public VCryptResponse getVCryptResponse

4.5.2 createTransaction

createTransaction creates a new transaction. public VCryptResponse createTransaction TransactionCreateRequestData transactionCreateRequestData; Table 4–1 handleTrackerRequest Parameters Parameter Description requestId The login session ID; this is the ID that should be used in all API calls for the login session remoteIPAddr The IP from where the request came; extracted from the HTTP request remoteHost The host name from the machine where the request came; optional secureCookie The secure cookie; passed only if it is received from a browser secureClientType An enumeration value that identifies the type of client used for authentication. The corresponding enum name is auth.client.type.enum. secureClientVersion The version of the client; optional digitalCookie The digital signature cookie; it can be the flash cookie; it is passed only if it is sent by a browser digitalClientType The digital client type that specifies the type of flash client used; if not available, use the value 0 digitalClientVersion The version of the digital client; it can be the version of the flash client fingerPrintType Refer to the OAAM enum vcrypt.fingerprint.type.enum for a list of valid values. Currently the enum has following values: ■ browser=1 ■ flash=2 It is recommended to use 1 for browser as the value of fingerPrintType as this parameter corresponds to the browser fingerprint type fingerPrint The fingerprint; if it describes browser characteristics, then the header is parsed into this string; it represents the browser header information fingerPrintType2 Used in case the same request has multiple fingerprints; it is defined in the properties file; optional fingerPrint2 The second fingerprint value; optional requestTime The time at which the request was made Integrating Native Java Applications 4-7

4.5.3 updateTransaction

updateTransaction updates a previously created transaction. public VCryptResponse updateTransaction Transaction UpdateRequestData transactionUpdateRequest Data; Table 4–2 createTransaction Parameter and Returned Value Parameter Description TransactionCreateRequestData The object to create a new transaction; it throws the exception BharosaException if it fails validation. The structure of this object is as follows: ■ requestId identifies the user session; required ■ requestTime is the time of the request; can be null; if null, the server uses the current time ■ transactionKey is the key to the transaction definition; used to create a transaction definition; required ■ externalTransactionId is used to correlate the application transaction with the corresponding OAAM Transaction. It can also be used to update the transaction. ■ status is the transaction status; can be null. The corresponding enum name is tracker.transaction.status.enum. ■ contextMap is the map of key-value pairs. Keys of this map should exactly match the Internal ID of the related Source Data of the Transaction Definition. The value should be always a java String value. If the value is a Date value then it should be in the format yyyy-MM-ddTHH:mm:ss.SSSz VCryptResponse The response object; make sure to check isSuccess before obtaining the transaction ID with the method getTransactionResponse 4-8 Oracle Fusion Middleware Developers Guide for Oracle Adaptive Access Manager

4.5.4 handleTransactionLog

handleTransactionLog captures transaction details. public VCryptResponse handleTransactionLogString requestId, Map[] contextMap; public VCryptResponse handleTransactionLogString requestId, Date requestTime, Map[] contextMap; public VCryptResponse handleTransactionLogString requestId, Date requestTime,Integer status, Map[] contextMap; Table 4–3 updateTransaction Parameter and Returned Value