handleTransactionLog Oracle Adaptive Access Manager APIs

Integrating Native Java Applications 4-9

4.5.5 updateTransactionStatus

updateTransactionStatus updates a transaction status and, if appropriate, triggers the data pattern processing. public VCryptResponse updateTransactionStatusString requestId, long transactionId, int status; public VCryptResponse updateTransactionStatusString requestId, Date requestTime, long transactionId, int status; public VCryptResponse updateTransactionStatusString requestId, long transactionId, int status, Map[] contextMap; public VCryptResponse updateTransactionStatusString requestId, Date requestTime, long transactionId, int status, Map[] contextMap; public VCryptResponse updateTransactionStatusString requestId, long transactionId, int status, boolean analyzePatterns; public VCryptResponse updateTransactionStatusString requestId, Date requestTime, long transactionId, int status, Map[] contextMap, boolean analyzePatterns;

4.5.6 updateLog

updateLog updates the user log and, if required, creates a CookieSet. public CookieSet updateLogString requestId, String remoteIPAddr, String remoteHost, String secureCookie, String digitalCookie, String groupId, String userId, String loginId, boolean isSecure, int result, int clientType, Note: Deprecated as of 10.1.4.5.1; instead, use the method updateTransaction . Table 4–5 updateTransactionStatus Parameters Parameter Description requestId The login session ID; this is the ID that should be used in all API calls for the login session requestTime The time at which the request was made contextMap An array of contextMaps; multiple transactions can be created with a single call; it expects to find a transactionType key in each context map of the array Status The transaction status transactionId The ID of the transaction with status to update; if null, it uses the last transaction in the given session analyzePatterns Boolean to indicate if pattern processing should be performed. When the value is passed in as true, the pattern processing is performed for the transaction if the resultStatus value is success. 4-10 Oracle Fusion Middleware Developers Guide for Oracle Adaptive Access Manager String clientVersion, int fingerPrintType, String fingerPrint, int digFingerPrintType, String digFingerPrint; public CookieSet updateLogString requestId, Date requestTime, String remoteIPAddr, String remoteHost, String secureCookie, String digitalCookie, String groupId, String userId, String loginId, boolean isSecure, int result, int clientType, String clientVersion, int fingerPrintType, String fingerPrint, int fingerPrintType2, String fingerPrint2; Table 4–6 updateLog 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 where the request came; optional secureCookie The secure cookie; passed only if it is received from a browser digitalCookie The digital signature cookie; can be the flash cookie; passed only if it is sent by a browser groupId The ID of the group this user belongs to userId The user ID; this is the primary ID key for the user; for invalid users, it is null loginId The ID used by the user to login in; required isSecure A Boolean indicating whether this node is secure and can be registered; it also indicates that the login is from a secure or registered device; if there is no concept of device, then set to false result A value of the user-defined enumeration auth.status.enum clientType An enumeration value indicating the client type used for authentication. The corresponding enum name is auth.client.type.enum. clientVersion The version of the client; optional 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 browser fingerprint type.