You are on page 1of 184

Micro Focus Security

ArcSight ESM Service Layer


Software Version: 7.6

API Reference Vol. 1: Core-Client Services

Document Release Date: December 2021


Software Release Date: December 2021
API Reference Vol. 1: Core-Client Services

Legal Notices
Copyright Notice
© Copyright 2001-2021 Micro Focus or one of its affiliates
Confidential computer software. Valid license from Micro Focus required for possession, use or copying. The
information contained herein is subject to change without notice.
The only warranties for Micro Focus products and services are set forth in the express warranty statements
accompanying such products and services. Nothing herein should be construed as constituting an additional warranty.
Micro Focus shall not be liable for technical or editorial errors or omissions contained herein.
No portion of this product's documentation may be reproduced or transmitted in any form or by any means, electronic
or mechanical, including photocopying, recording, or information storage and retrieval systems, for any purpose other
than the purchaser's internal use, without the express written permission of Micro Focus.
Notwithstanding anything to the contrary in your license agreement for Micro Focus ArcSight software, you may
reverse engineer and modify certain open source components of the software in accordance with the license terms for
those particular components. See below for the applicable terms.
U.S. Governmental Rights. For purposes of your license to Micro Focus ArcSight software, “commercial computer
software” is defined at FAR 2.101. If acquired by or on behalf of a civilian agency, the U.S. Government acquires this
commercial computer software and/or commercial computer software documentation and other technical data subject
to the terms of the Agreement as specified in 48 C.F.R. 12.212 (Computer Software) and 12.211 (Technical Data) of the
Federal Acquisition Regulation (“FAR”) and its successors. If acquired by or on behalf of any agency within the
Department of Defense (“DOD”), the U.S. Government acquires this commercial computer software and/or commercial
computer software documentation subject to the terms of the Agreement as specified in 48 C.F.R. 227.7202-3 of the
DOD FAR Supplement (“DFARS”) and its successors. This U.S. Government Rights Section 18.11 is in lieu of, and
supersedes, any other FAR, DFARS, or other clause or provision that addresses government rights in computer software
or technical data.

Trademark Notices
Adobe™ is a trademark of Adobe Systems Incorporated.
Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation.
UNIX® is a registered trademark of The Open Group.

Support
Contact Information
Phone A list of phone numbers is available on the Technical Support
Page: https://softwaresupport.softwaregrp.com/support-contact-information

Support Web Site https://softwaresupport.softwaregrp.com/

ArcSight Product Documentation https://community.softwaregrp.com/t5/ArcSight-Product-Documentation/ct-p/productdocs

Micro Focus ESM Service Layer 7.6 Page 2 of 2


ESM Service Layer: Core Services 2.0 Page 2
Package
com.arcsight.coma.bridge

ESM Service Layer: Core Services 2.0 Page 3


com.arcsight.coma.bridge
Class AuthenticationException
java.lang.Object
|
+-java.lang.Throwable
|
+-java.lang.Exception
|
+-com.arcsight.coma.bridge.AuthenticationException
All Implemented Interfaces:
Serializable

public class AuthenticationException


extends Exception

Constructor Summary
public AuthenticationException(String message)

public AuthenticationException(String service, String method)

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage,


getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace,
printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
AuthenticationException
public AuthenticationException(String message)

AuthenticationException
public AuthenticationException(String service,
String method)

ESM Service Layer: Core Services 2.0 Page 4


com.arcsight.coma.bridge
Class AuthorizationException
java.lang.Object
|
+-java.lang.Throwable
|
+-java.lang.Exception
|
+-com.arcsight.coma.bridge.AuthorizationException
All Implemented Interfaces:
Serializable

public class AuthorizationException


extends Exception

Constructor Summary
public AuthorizationException(String message)

public AuthorizationException(String service, String method, boolean


classRequiresAuthentication, boolean methodRequiresAuthentication,
String[] classRequiredRights, String[] methodRequiredRights)

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage,


getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace,
printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
AuthorizationException
public AuthorizationException(String message)

(continued on next page)

ESM Service Layer: Core Services 2.0 Page 5


AuthorizationException
public AuthorizationException(String service,
String method,
boolean classRequiresAuthentication,
boolean methodRequiresAuthentication,
String[] classRequiredRights,
String[] methodRequiredRights)

ESM Service Layer: Core Services 2.0 Page 6


Package
com.arcsight.coma.client.gwt

ESM Service Layer: Core Services 2.0 Page 7


com.arcsight.coma.client.gwt
Class RemoteServiceException
java.lang.Object
|
+-java.lang.Throwable
|
+-java.lang.Exception
|
+-com.arcsight.coma.client.gwt.RemoteServiceException
All Implemented Interfaces:
Serializable, Serializable

public class RemoteServiceException


extends Exception
implements Serializable, Serializable

Copyright (c) 2001-2018 Micro Focus or one of its affiliates. Confidential commercial computer software. Valid license required.

Field Summary
public static final ERROR_UNKNOWN

Value: -54188

Constructor Summary
public RemoteServiceException()

public RemoteServiceException(String message, Throwable cause)

public RemoteServiceException(String message)

public RemoteServiceException(Throwable cause)

Method Summary
int getErrorCode()

String getRemoteStacktrace()

void setErrorCode(int errorCode)

void setRemoteStacktrace(String remoteStacktrace)

Methods inherited from class java.lang.Throwable

ESM Service Layer: Core Services 2.0 Page 8


addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage,
getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace,
printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Fields
ERROR_UNKNOWN
public static final int ERROR_UNKNOWN

Constant value: -54188

Constructors
RemoteServiceException
public RemoteServiceException()

RemoteServiceException
public RemoteServiceException(String message,
Throwable cause)

RemoteServiceException
public RemoteServiceException(String message)

RemoteServiceException
public RemoteServiceException(Throwable cause)

Methods
getRemoteStacktrace
public String getRemoteStacktrace()

ESM Service Layer: Core Services 2.0 Page 9


setRemoteStacktrace
public void setRemoteStacktrace(String remoteStacktrace)

getErrorCode
public int getErrorCode()

setErrorCode
public void setErrorCode(int errorCode)

ESM Service Layer: Core Services 2.0 Page 10


Package
com.arcsight.product.core.service.v1.axis2.
jaxws

ESM Service Layer: Core Services 2.0 Page 11


com.arcsight.product.core.service.v1.axis2.jaxws
Class AuthenticationExceptionBean
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.AuthenticationExceptionBean

public class AuthenticationExceptionBean


extends Object

This class was generated by the JAX-WS RI. JAX-WS RI 2.3.0 Generated source version: 2.3.0

Constructor Summary
public AuthenticationExceptionBean()

Method Summary
String getMessage()

void setMessage(String message)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
AuthenticationExceptionBean
public AuthenticationExceptionBean()

Methods
getMessage
public String getMessage()

Returns:
returns String

ESM Service Layer: Core Services 2.0 Page 12


setMessage
public void setMessage(String message)

Parameters:
message - the value for the message property

ESM Service Layer: Core Services 2.0 Page 13


com.arcsight.product.core.service.v1.axis2.jaxws
Class AuthorizationExceptionBean
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.AuthorizationExceptionBean

public class AuthorizationExceptionBean


extends Object

This class was generated by the JAX-WS RI. JAX-WS RI 2.3.0 Generated source version: 2.3.0

Constructor Summary
public AuthorizationExceptionBean()

Method Summary
String getMessage()

void setMessage(String message)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
AuthorizationExceptionBean
public AuthorizationExceptionBean()

Methods
getMessage
public String getMessage()

Returns:
returns String

ESM Service Layer: Core Services 2.0 Page 14


setMessage
public void setMessage(String message)

Parameters:
message - the value for the message property

ESM Service Layer: Core Services 2.0 Page 15


com.arcsight.product.core.service.v1.axis2.jaxws
Class GetAllRightsByGroupTypeResponse
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.GetAllRightsByGroupTypeResponse

public class GetAllRightsByGroupTypeResponse


extends Object

Constructor Summary
public GetAllRightsByGroupTypeResponse()

Method Summary
HashMap getReturn()

void setReturn(HashMap _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
GetAllRightsByGroupTypeResponse
public GetAllRightsByGroupTypeResponse()

Methods
getReturn
public HashMap getReturn()

Returns:
returns HashMap>

ESM Service Layer: Core Services 2.0 Page 16


setReturn
public void setReturn(HashMap _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 17


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceAuthenticate
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceAuthenticate

public class LoginServiceAuthenticate


extends Object

Constructor Summary
public LoginServiceAuthenticate()

Method Summary
AuthContext getAuthContext()

String getAuthToken()

PasswordCredential getCred()

void setAuthContext(AuthContext authContext)

void setAuthToken(String authToken)

void setCred(PasswordCredential cred)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceAuthenticate
public LoginServiceAuthenticate()

Methods

ESM Service Layer: Core Services 2.0 Page 18


getAuthToken
public String getAuthToken()

Returns:
returns String

setAuthToken
public void setAuthToken(String authToken)

Parameters:
authToken - the value for the authToken property

getCred
public PasswordCredential getCred()

Returns:
returns PasswordCredential

setCred
public void setCred(PasswordCredential cred)

Parameters:
cred - the value for the cred property

getAuthContext
public AuthContext getAuthContext()

Returns:
returns AuthContext

setAuthContext
public void setAuthContext(AuthContext authContext)

Parameters:
authContext - the value for the authContext property

ESM Service Layer: Core Services 2.0 Page 19


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceAuthenticateOSPCredential
java.lang.Object
|
+-
com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceAuthenticateOSPCredential

public class LoginServiceAuthenticateOSPCredential


extends Object

Constructor Summary
public LoginServiceAuthenticateOSPCredential()

Method Summary
String getAuthToken()

void setAuthToken(String authToken)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceAuthenticateOSPCredential
public LoginServiceAuthenticateOSPCredential()

Methods
getAuthToken
public String getAuthToken()

Returns:
returns String

ESM Service Layer: Core Services 2.0 Page 20


setAuthToken
public void setAuthToken(String authToken)

Parameters:
authToken - the value for the authToken property

ESM Service Layer: Core Services 2.0 Page 21


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceAuthenticateOSPCredentialResponse
java.lang.Object
|
+-
com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceAuthenticateOSPCredentialResp
onse

public class LoginServiceAuthenticateOSPCredentialResponse


extends Object

Constructor Summary
public LoginServiceAuthenticateOSPCredentialResponse()

Method Summary
AuthResponse getReturn()

void setReturn(AuthResponse _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceAuthenticateOSPCredentialResponse
public LoginServiceAuthenticateOSPCredentialResponse()

Methods
getReturn
public AuthResponse getReturn()

Returns:
returns AuthResponse

ESM Service Layer: Core Services 2.0 Page 22


setReturn
public void setReturn(AuthResponse _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 23


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceAuthenticateResponse
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceAuthenticateResponse

public class LoginServiceAuthenticateResponse


extends Object

Constructor Summary
public LoginServiceAuthenticateResponse()

Method Summary
AuthResponse getReturn()

void setReturn(AuthResponse _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceAuthenticateResponse
public LoginServiceAuthenticateResponse()

Methods
getReturn
public AuthResponse getReturn()

Returns:
returns AuthResponse

ESM Service Layer: Core Services 2.0 Page 24


setReturn
public void setReturn(AuthResponse _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 25


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceGetAuthenticationMethod
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceGetAuthenticationMethod

public class LoginServiceGetAuthenticationMethod


extends Object

Constructor Summary
public LoginServiceGetAuthenticationMethod()

Method Summary
String getAuthToken()

void setAuthToken(String authToken)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceGetAuthenticationMethod
public LoginServiceGetAuthenticationMethod()

Methods
getAuthToken
public String getAuthToken()

Returns:
returns String

ESM Service Layer: Core Services 2.0 Page 26


setAuthToken
public void setAuthToken(String authToken)

Parameters:
authToken - the value for the authToken property

ESM Service Layer: Core Services 2.0 Page 27


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceGetAuthenticationMethodResponse
java.lang.Object
|
+-
com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceGetAuthenticationMethodRespon
se

public class LoginServiceGetAuthenticationMethodResponse


extends Object

Constructor Summary
public LoginServiceGetAuthenticationMethodResponse()

Method Summary
AuthMethod getReturn()

void setReturn(AuthMethod _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceGetAuthenticationMethodResponse
public LoginServiceGetAuthenticationMethodResponse()

Methods
getReturn
public AuthMethod getReturn()

Returns:
returns AuthMethod

ESM Service Layer: Core Services 2.0 Page 28


setReturn
public void setReturn(AuthMethod _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 29


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceGetCurrentUser
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceGetCurrentUser

public class LoginServiceGetCurrentUser


extends Object

Constructor Summary
public LoginServiceGetCurrentUser()

Method Summary
String getAuthToken()

void setAuthToken(String authToken)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceGetCurrentUser
public LoginServiceGetCurrentUser()

Methods
getAuthToken
public String getAuthToken()

Returns:
returns String

ESM Service Layer: Core Services 2.0 Page 30


setAuthToken
public void setAuthToken(String authToken)

Parameters:
authToken - the value for the authToken property

ESM Service Layer: Core Services 2.0 Page 31


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceGetCurrentUserResponse
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceGetCurrentUserResponse

public class LoginServiceGetCurrentUserResponse


extends Object

Constructor Summary
public LoginServiceGetCurrentUserResponse()

Method Summary
User getReturn()

void setReturn(User _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceGetCurrentUserResponse
public LoginServiceGetCurrentUserResponse()

Methods
getReturn
public User getReturn()

Returns:
returns User

ESM Service Layer: Core Services 2.0 Page 32


setReturn
public void setReturn(User _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 33


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceGetOSPSettings
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceGetOSPSettings

public class LoginServiceGetOSPSettings


extends Object

Constructor Summary
public LoginServiceGetOSPSettings()

Method Summary
String getAuthToken()

void setAuthToken(String authToken)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceGetOSPSettings
public LoginServiceGetOSPSettings()

Methods
getAuthToken
public String getAuthToken()

Returns:
returns String

ESM Service Layer: Core Services 2.0 Page 34


setAuthToken
public void setAuthToken(String authToken)

Parameters:
authToken - the value for the authToken property

ESM Service Layer: Core Services 2.0 Page 35


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceGetOSPSettingsResponse
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceGetOSPSettingsResponse

public class LoginServiceGetOSPSettingsResponse


extends Object

Constructor Summary
public LoginServiceGetOSPSettingsResponse()

Method Summary
String getReturn()

void setReturn(String _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceGetOSPSettingsResponse
public LoginServiceGetOSPSettingsResponse()

Methods
getReturn
public String getReturn()

Returns:
returns String

ESM Service Layer: Core Services 2.0 Page 36


setReturn
public void setReturn(String _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 37


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceGetServiceMajorVersion
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceGetServiceMajorVersion

public class LoginServiceGetServiceMajorVersion


extends Object

Constructor Summary
public LoginServiceGetServiceMajorVersion()

Method Summary
String getAuthToken()

void setAuthToken(String authToken)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceGetServiceMajorVersion
public LoginServiceGetServiceMajorVersion()

Methods
getAuthToken
public String getAuthToken()

Returns:
returns String

ESM Service Layer: Core Services 2.0 Page 38


setAuthToken
public void setAuthToken(String authToken)

Parameters:
authToken - the value for the authToken property

ESM Service Layer: Core Services 2.0 Page 39


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceGetServiceMajorVersionResponse
java.lang.Object
|
+-
com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceGetServiceMajorVersionRespons
e

public class LoginServiceGetServiceMajorVersionResponse


extends Object

Constructor Summary
public LoginServiceGetServiceMajorVersionResponse()

Method Summary
int getReturn()

void setReturn(int _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceGetServiceMajorVersionResponse
public LoginServiceGetServiceMajorVersionResponse()

Methods
getReturn
public int getReturn()

Returns:
returns int

ESM Service Layer: Core Services 2.0 Page 40


setReturn
public void setReturn(int _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 41


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceGetServiceMinorVersion
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceGetServiceMinorVersion

public class LoginServiceGetServiceMinorVersion


extends Object

Constructor Summary
public LoginServiceGetServiceMinorVersion()

Method Summary
String getAuthToken()

void setAuthToken(String authToken)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceGetServiceMinorVersion
public LoginServiceGetServiceMinorVersion()

Methods
getAuthToken
public String getAuthToken()

Returns:
returns String

ESM Service Layer: Core Services 2.0 Page 42


setAuthToken
public void setAuthToken(String authToken)

Parameters:
authToken - the value for the authToken property

ESM Service Layer: Core Services 2.0 Page 43


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceGetServiceMinorVersionResponse
java.lang.Object
|
+-
com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceGetServiceMinorVersionRespons
e

public class LoginServiceGetServiceMinorVersionResponse


extends Object

Constructor Summary
public LoginServiceGetServiceMinorVersionResponse()

Method Summary
int getReturn()

void setReturn(int _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceGetServiceMinorVersionResponse
public LoginServiceGetServiceMinorVersionResponse()

Methods
getReturn
public int getReturn()

Returns:
returns int

ESM Service Layer: Core Services 2.0 Page 44


setReturn
public void setReturn(int _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 45


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceGetSession
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceGetSession

public class LoginServiceGetSession


extends Object

Constructor Summary
public LoginServiceGetSession()

Method Summary
String getAuthToken()

void setAuthToken(String authToken)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceGetSession
public LoginServiceGetSession()

Methods
getAuthToken
public String getAuthToken()

Returns:
returns String

ESM Service Layer: Core Services 2.0 Page 46


setAuthToken
public void setAuthToken(String authToken)

Parameters:
authToken - the value for the authToken property

ESM Service Layer: Core Services 2.0 Page 47


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceGetSessionResponse
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceGetSessionResponse

public class LoginServiceGetSessionResponse


extends Object

Constructor Summary
public LoginServiceGetSessionResponse()

Method Summary
Session getReturn()

void setReturn(Session _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceGetSessionResponse
public LoginServiceGetSessionResponse()

Methods
getReturn
public Session getReturn()

Returns:
returns Session

ESM Service Layer: Core Services 2.0 Page 48


setReturn
public void setReturn(Session _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 49


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceIsCASAuth
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceIsCASAuth

public class LoginServiceIsCASAuth


extends Object

Constructor Summary
public LoginServiceIsCASAuth()

Method Summary
String getAuthToken()

void setAuthToken(String authToken)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceIsCASAuth
public LoginServiceIsCASAuth()

Methods
getAuthToken
public String getAuthToken()

Returns:
returns String

ESM Service Layer: Core Services 2.0 Page 50


setAuthToken
public void setAuthToken(String authToken)

Parameters:
authToken - the value for the authToken property

ESM Service Layer: Core Services 2.0 Page 51


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceIsCASAuthResponse
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceIsCASAuthResponse

public class LoginServiceIsCASAuthResponse


extends Object

Constructor Summary
public LoginServiceIsCASAuthResponse()

Method Summary
boolean isReturn()

void setReturn(boolean _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceIsCASAuthResponse
public LoginServiceIsCASAuthResponse()

Methods
isReturn
public boolean isReturn()

Returns:
returns boolean

ESM Service Layer: Core Services 2.0 Page 52


setReturn
public void setReturn(boolean _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 53


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceLogin
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceLogin

public class LoginServiceLogin


extends Object

Constructor Summary
public LoginServiceLogin()

Method Summary
String getAuthToken()

String getLogin()

String getPassword()

void setAuthToken(String authToken)

void setLogin(String login)

void setPassword(String password)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceLogin
public LoginServiceLogin()

Methods

ESM Service Layer: Core Services 2.0 Page 54


getAuthToken
public String getAuthToken()

Returns:
returns String

setAuthToken
public void setAuthToken(String authToken)

Parameters:
authToken - the value for the authToken property

getLogin
public String getLogin()

Returns:
returns String

setLogin
public void setLogin(String login)

Parameters:
login - the value for the login property

getPassword
public String getPassword()

Returns:
returns String

setPassword
public void setPassword(String password)

Parameters:
password - the value for the password property

ESM Service Layer: Core Services 2.0 Page 55


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceLoginForOneTimeUse
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceLoginForOneTimeUse

public class LoginServiceLoginForOneTimeUse


extends Object

Constructor Summary
public LoginServiceLoginForOneTimeUse()

Method Summary
String getAuthToken()

String getLogin()

String getPassword()

void setAuthToken(String authToken)

void setLogin(String login)

void setPassword(String password)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceLoginForOneTimeUse
public LoginServiceLoginForOneTimeUse()

Methods

ESM Service Layer: Core Services 2.0 Page 56


getAuthToken
public String getAuthToken()

Returns:
returns String

setAuthToken
public void setAuthToken(String authToken)

Parameters:
authToken - the value for the authToken property

getLogin
public String getLogin()

Returns:
returns String

setLogin
public void setLogin(String login)

Parameters:
login - the value for the login property

getPassword
public String getPassword()

Returns:
returns String

setPassword
public void setPassword(String password)

Parameters:
password - the value for the password property

ESM Service Layer: Core Services 2.0 Page 57


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceLoginForOneTimeUseResponse
java.lang.Object
|
+-
com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceLoginForOneTimeUseResponse

public class LoginServiceLoginForOneTimeUseResponse


extends Object

Constructor Summary
public LoginServiceLoginForOneTimeUseResponse()

Method Summary
String getReturn()

void setReturn(String _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceLoginForOneTimeUseResponse
public LoginServiceLoginForOneTimeUseResponse()

Methods
getReturn
public String getReturn()

Returns:
returns String

ESM Service Layer: Core Services 2.0 Page 58


setReturn
public void setReturn(String _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 59


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceLoginResponse
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceLoginResponse

public class LoginServiceLoginResponse


extends Object

Constructor Summary
public LoginServiceLoginResponse()

Method Summary
String getReturn()

void setReturn(String _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceLoginResponse
public LoginServiceLoginResponse()

Methods
getReturn
public String getReturn()

Returns:
returns String

ESM Service Layer: Core Services 2.0 Page 60


setReturn
public void setReturn(String _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 61


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceLogout
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceLogout

public class LoginServiceLogout


extends Object

Constructor Summary
public LoginServiceLogout()

Method Summary
String getAuthToken()

void setAuthToken(String authToken)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceLogout
public LoginServiceLogout()

Methods
getAuthToken
public String getAuthToken()

Returns:
returns String

ESM Service Layer: Core Services 2.0 Page 62


setAuthToken
public void setAuthToken(String authToken)

Parameters:
authToken - the value for the authToken property

ESM Service Layer: Core Services 2.0 Page 63


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceLogoutResponse
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceLogoutResponse

public class LoginServiceLogoutResponse


extends Object

Constructor Summary
public LoginServiceLogoutResponse()

Method Summary
Void getReturn()

void setReturn(Void _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceLogoutResponse
public LoginServiceLogoutResponse()

Methods
getReturn
public Void getReturn()

Returns:
returns Void

ESM Service Layer: Core Services 2.0 Page 64


setReturn
public void setReturn(Void _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 65


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceResetPassword
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceResetPassword

public class LoginServiceResetPassword


extends Object

Constructor Summary
public LoginServiceResetPassword()

Method Summary
String getAuthToken()

String getLogin()

void setAuthToken(String authToken)

void setLogin(String login)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceResetPassword
public LoginServiceResetPassword()

Methods
getAuthToken
public String getAuthToken()

Returns:

ESM Service Layer: Core Services 2.0 Page 66


returns String

setAuthToken
public void setAuthToken(String authToken)

Parameters:
authToken - the value for the authToken property

getLogin
public String getLogin()

Returns:
returns String

setLogin
public void setLogin(String login)

Parameters:
login - the value for the login property

ESM Service Layer: Core Services 2.0 Page 67


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceResetPasswordResponse
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceResetPasswordResponse

public class LoginServiceResetPasswordResponse


extends Object

Constructor Summary
public LoginServiceResetPasswordResponse()

Method Summary
Void getReturn()

void setReturn(Void _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceResetPasswordResponse
public LoginServiceResetPasswordResponse()

Methods
getReturn
public Void getReturn()

Returns:
returns Void

ESM Service Layer: Core Services 2.0 Page 68


setReturn
public void setReturn(Void _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 69


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceSendAuthChallengeResponse
java.lang.Object
|
+-
com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceSendAuthChallengeResponse

public class LoginServiceSendAuthChallengeResponse


extends Object

Constructor Summary
public LoginServiceSendAuthChallengeResponse()

Method Summary
String getAuthToken()

int getChallengeId()

String getResp()

void setAuthToken(String authToken)

void setChallengeId(int challengeId)

void setResp(String resp)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceSendAuthChallengeResponse
public LoginServiceSendAuthChallengeResponse()

Methods

ESM Service Layer: Core Services 2.0 Page 70


getAuthToken
public String getAuthToken()

Returns:
returns String

setAuthToken
public void setAuthToken(String authToken)

Parameters:
authToken - the value for the authToken property

getChallengeId
public int getChallengeId()

Returns:
returns int

setChallengeId
public void setChallengeId(int challengeId)

Parameters:
challengeId - the value for the challengeId property

getResp
public String getResp()

Returns:
returns String

setResp
public void setResp(String resp)

Parameters:
resp - the value for the resp property

ESM Service Layer: Core Services 2.0 Page 71


com.arcsight.product.core.service.v1.axis2.jaxws
Class LoginServiceSendAuthChallengeResponseResponse
java.lang.Object
|
+-
com.arcsight.product.core.service.v1.axis2.jaxws.LoginServiceSendAuthChallengeResponseResp
onse

public class LoginServiceSendAuthChallengeResponseResponse


extends Object

Constructor Summary
public LoginServiceSendAuthChallengeResponseResponse()

Method Summary
AuthResponse getReturn()

void setReturn(AuthResponse _return)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
LoginServiceSendAuthChallengeResponseResponse
public LoginServiceSendAuthChallengeResponseResponse()

Methods
getReturn
public AuthResponse getReturn()

Returns:
returns AuthResponse

ESM Service Layer: Core Services 2.0 Page 72


setReturn
public void setReturn(AuthResponse _return)

Parameters:
_return - the value for the _return property

ESM Service Layer: Core Services 2.0 Page 73


com.arcsight.product.core.service.v1.axis2.jaxws
Class ModelLoader
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.ModelLoader

public final class ModelLoader


extends Object

Constructor Summary
public ModelLoader()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
ModelLoader
public ModelLoader()

ESM Service Layer: Core Services 2.0 Page 74


com.arcsight.product.core.service.v1.axis2.jaxws
Class ObjectFactory
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.ObjectFactory

public final class ObjectFactory


extends Object

Constructor Summary
public ObjectFactory()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
ObjectFactory
public ObjectFactory()

ESM Service Layer: Core Services 2.0 Page 75


com.arcsight.product.core.service.v1.axis2.jaxws
Class ServiceExceptionBean
java.lang.Object
|
+-com.arcsight.product.core.service.v1.axis2.jaxws.ServiceExceptionBean

public class ServiceExceptionBean


extends Object

This class was generated by the JAX-WS RI. JAX-WS RI 2.3.0 Generated source version: 2.3.0

Constructor Summary
public ServiceExceptionBean()

Method Summary
int getErrorCode()

String getMessage()

void setErrorCode(int errorCode)

void setMessage(String message)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
ServiceExceptionBean
public ServiceExceptionBean()

Methods
getErrorCode
public int getErrorCode()

ESM Service Layer: Core Services 2.0 Page 76


Returns:
returns int

setErrorCode
public void setErrorCode(int errorCode)

Parameters:
errorCode - the value for the errorCode property

getMessage
public String getMessage()

Returns:
returns String

setMessage
public void setMessage(String message)

Parameters:
message - the value for the message property

ESM Service Layer: Core Services 2.0 Page 77


Package
com.arcsight.product.core.service.v1.mode
l

ESM Service Layer: Core Services 2.0 Page 78


com.arcsight.product.core.service.v1.model
Class AuthContext
java.lang.Object
|
+-com.arcsight.product.core.service.v1.model.AuthContext
All Implemented Interfaces:
CoreServiceModel

public class AuthContext


extends Object
implements CoreServiceModel

Constructor Summary
public AuthContext()
Constructor

Method Summary
Boolean getFallback()
Tests whether this authContext is fallen back or not.

void setFallback(Boolean fallback)


Sets whether this authContext is fallen back.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
AuthContext
public AuthContext()

Constructor

Methods
getFallback
public Boolean getFallback()

Tests whether this authContext is fallen back or not.

ESM Service Layer: Core Services 2.0 Page 79


Returns:
True if this authContext is fallen back.

setFallback
public void setFallback(Boolean fallback)

Sets whether this authContext is fallen back.

Parameters:
fallback - If true, this authContext is fallen back.

ESM Service Layer: Core Services 2.0 Page 80


com.arcsight.product.core.service.v1.model
Class AuthMethod
java.lang.Object
|
+-com.arcsight.product.core.service.v1.model.AuthMethod
All Implemented Interfaces:
CoreServiceModel

public class AuthMethod


extends Object
implements CoreServiceModel

Description of authentication method. Available methods are provided to the user, so that he/she could decide which method to use
to connect to the server.

JSON prototype

Field Summary
public static final BUILTIN

public static final OSP

public static final PKI

public static final PKI_AND_LOCAL_PASSWORD

public static final PKI_WITH_PASSWORD_BACKUP

public static final RADIUS

public static final RADIUS_WITH_PASSWORD_BACKUP

Constructor Summary
public AuthMethod()
Constructor

public AuthMethod(boolean localPassword, boolean externalUserId)

Method Summary
boolean isExternalUserId()
Tests whether this authMethod has external user Id.

ESM Service Layer: Core Services 2.0 Page 81


boolean isLocalPassword()
Tests whether this AuthMethod has local password.

void setExternalUserId(boolean externalUserId)


Sets whether this authMethod has external user Id.

void setLocalPassword(boolean localPassword)


Sets whether this AuthMethod has local password.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Fields
BUILTIN
public static final com.arcsight.product.core.service.v1.model.AuthMethod BUILTIN

PKI
public static final com.arcsight.product.core.service.v1.model.AuthMethod PKI

RADIUS
public static final com.arcsight.product.core.service.v1.model.AuthMethod RADIUS

PKI_AND_LOCAL_PASSWORD
public static final com.arcsight.product.core.service.v1.model.AuthMethod
PKI_AND_LOCAL_PASSWORD

PKI_WITH_PASSWORD_BACKUP
public static final com.arcsight.product.core.service.v1.model.AuthMethod
PKI_WITH_PASSWORD_BACKUP

RADIUS_WITH_PASSWORD_BACKUP
public static final com.arcsight.product.core.service.v1.model.AuthMethod
RADIUS_WITH_PASSWORD_BACKUP

ESM Service Layer: Core Services 2.0 Page 82


OSP
public static final com.arcsight.product.core.service.v1.model.AuthMethod OSP

Constructors
AuthMethod
public AuthMethod()

Constructor

AuthMethod
public AuthMethod(boolean localPassword,
boolean externalUserId)

Methods
isLocalPassword
public boolean isLocalPassword()

Tests whether this AuthMethod has local password.

Returns:
True if this AuthMethod has local password.

setLocalPassword
public void setLocalPassword(boolean localPassword)

Sets whether this AuthMethod has local password.

Parameters:
localPassword - the localPassword to set

isExternalUserId
public boolean isExternalUserId()

Tests whether this authMethod has external user Id.

Returns:
True if this authMethod has external user Id.

ESM Service Layer: Core Services 2.0 Page 83


setExternalUserId
public void setExternalUserId(boolean externalUserId)

Sets whether this authMethod has external user Id.

Parameters:
externalUserId - IF true, this authMethod has external user Id.

ESM Service Layer: Core Services 2.0 Page 84


com.arcsight.product.core.service.v1.model
Class AuthResponse
java.lang.Object
|
+-com.arcsight.product.core.service.v1.model.AuthResponse
All Implemented Interfaces:
CoreServiceModel

public class AuthResponse


extends Object
implements CoreServiceModel

Constructor Summary
public AuthResponse()
Constructor

public AuthResponse(String authToken)


Constructor

Method Summary
String getAuthToken()
Gets the string value of authToken.

User getUser()
Returns the user being authenticated.

boolean isPasswordChangeRequired()
Gets whether or not the user must change their password.

boolean isPasswordExpiring()
Notifies user that password is expiring soon.

void setAuthToken(String authToken)


Sets the string value of authToken.

void setPasswordExpiring(boolean passwordExpiring)


Sets whether password is expiring soon.

void setUser(User user)


Sets the user being authenticated.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

ESM Service Layer: Core Services 2.0 Page 85


Constructors
AuthResponse
public AuthResponse()

Constructor

AuthResponse
public AuthResponse(String authToken)

Constructor

Parameters:
authToken - The string value of authToken.

Methods
getAuthToken
public String getAuthToken()

Gets the string value of authToken.

Returns:
The string value of authToken.

setAuthToken
public void setAuthToken(String authToken)

Sets the string value of authToken.

Parameters:
authToken - the string value authToken to set

getUser
public User getUser()

Returns the user being authenticated.

Returns:
User being authenticated.

setUser
public void setUser(User user)

Sets the user being authenticated.

ESM Service Layer: Core Services 2.0 Page 86


Parameters:
user - The user being authenticated.

isPasswordExpiring
public boolean isPasswordExpiring()

Notifies user that password is expiring soon.

Returns:
True if password is expiring soon.

setPasswordExpiring
public void setPasswordExpiring(boolean passwordExpiring)

Sets whether password is expiring soon.

Parameters:
passwordExpiring - If true, password is expiring soon.

isPasswordChangeRequired
public boolean isPasswordChangeRequired()

Gets whether or not the user must change their password.

Returns:
True if the user must change their password.

ESM Service Layer: Core Services 2.0 Page 87


com.arcsight.product.core.service.v1.model
Class Credential
java.lang.Object
|
+-com.arcsight.product.core.service.v1.model.Credential
All Implemented Interfaces:
CoreServiceModel

Direct Known Subclasses:


PasswordCredential

public class Credential


extends Object
implements CoreServiceModel

Constructor Summary
public Credential()

Method Summary
String getUserName()

void setUserName(String userName)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
Credential
public Credential()

Methods
getUserName
public String getUserName()

ESM Service Layer: Core Services 2.0 Page 88


Returns:
the userName

setUserName
public void setUserName(String userName)

Parameters:
userName - the userName to set

ESM Service Layer: Core Services 2.0 Page 89


com.arcsight.product.core.service.v1.model
Class Group
java.lang.Object
|
+-com.arcsight.product.core.service.v1.model.Group
All Implemented Interfaces:
CoreServiceModel

public class Group


extends Object
implements CoreServiceModel

Description of a Group of Users.

JSON prototype

Constructor Summary
public Group()

Method Summary
String getDescription()

long getId()

boolean getIsDefault()

String getName()

Long[] getRightIds()

GroupType getType()

Long[] getUserIds()

void setDescription(String description)

void setId(long id)

void setIsDefault(boolean isDefault)

void setName(String name)

ESM Service Layer: Core Services 2.0 Page 90


void setRightIds(Long[] rightIds)

void setType(GroupType type)

void setUserIds(Long[] userIds)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
Group
public Group()

Methods
getId
public long getId()

getRightIds
public Long[] getRightIds()

setRightIds
public void setRightIds(Long[] rightIds)

getUserIds
public Long[] getUserIds()

setUserIds
public void setUserIds(Long[] userIds)

ESM Service Layer: Core Services 2.0 Page 91


setId
public void setId(long id)

getType
public GroupType getType()

setType
public void setType(GroupType type)

getName
public String getName()

setName
public void setName(String name)

getDescription
public String getDescription()

setDescription
public void setDescription(String description)

getIsDefault
public boolean getIsDefault()

setIsDefault
public void setIsDefault(boolean isDefault)

ESM Service Layer: Core Services 2.0 Page 92


com.arcsight.product.core.service.v1.model
Class GroupType
java.lang.Object
|
+-java.lang.Enum
|
+-com.arcsight.product.core.service.v1.model.GroupType
All Implemented Interfaces:
Serializable, Comparable

public final class GroupType


extends Enum

Different types of groups that can be created.

Field Summary
public static final CONAPP_RIGHTS

public static final LOGGER_REPORT

public static final LOGGER_RIGHTS

public static final LOGGER_SEARCH

public static final SYSTEM_ADMIN

Method Summary
String getDbName()

static GroupType valueOf(String name)

static GroupType[] values()

Methods inherited from class java.lang.Enum

compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Comparable

ESM Service Layer: Core Services 2.0 Page 93


compareTo

Fields
SYSTEM_ADMIN
public static final com.arcsight.product.core.service.v1.model.GroupType SYSTEM_ADMIN

LOGGER_RIGHTS
public static final com.arcsight.product.core.service.v1.model.GroupType LOGGER_RIGHTS

LOGGER_REPORT
public static final com.arcsight.product.core.service.v1.model.GroupType LOGGER_REPORT

LOGGER_SEARCH
public static final com.arcsight.product.core.service.v1.model.GroupType LOGGER_SEARCH

CONAPP_RIGHTS
public static final com.arcsight.product.core.service.v1.model.GroupType CONAPP_RIGHTS

Methods
values
public static GroupType[] values()

valueOf
public static GroupType valueOf(String name)

ESM Service Layer: Core Services 2.0 Page 94


getDbName
public String getDbName()

ESM Service Layer: Core Services 2.0 Page 95


com.arcsight.product.core.service.v1.model
Class LoginCookieType
java.lang.Object
|
+-java.lang.Enum
|
+-com.arcsight.product.core.service.v1.model.LoginCookieType
All Implemented Interfaces:
Serializable, Comparable

public final class LoginCookieType


extends Enum

Field Summary
public static final ESM

public static final PLATFORM

Method Summary
static valueOf(String name)
LoginCookieType

static values()
LoginCookieType[]

Methods inherited from class java.lang.Enum

compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Comparable

compareTo

Fields
ESM
public static final com.arcsight.product.core.service.v1.model.LoginCookieType ESM

ESM Service Layer: Core Services 2.0 Page 96


PLATFORM
public static final com.arcsight.product.core.service.v1.model.LoginCookieType PLATFORM

Methods
values
public static LoginCookieType[] values()

valueOf
public static LoginCookieType valueOf(String name)

ESM Service Layer: Core Services 2.0 Page 97


com.arcsight.product.core.service.v1.model
Class PasswordComplexityRequirement
java.lang.Object
|
+-java.lang.Enum
|
+-com.arcsight.product.core.service.v1.model.PasswordComplexityRequirement
All Implemented Interfaces:
Serializable, Comparable

public final class PasswordComplexityRequirement


extends Enum

Different types of complexity requirements that may be imposed when a user is changing their password.

Field Summary
public static final MAXIMUM_LENGTH
...

public static final MINIMUM_DIFFERENCE


...

public static final MINIMUM_LENGTH


is the password at least a minimum length ...

public static final MINIMUM_LOWER_CASE


...

public static final MINIMUM_NUMERIC


...

public static final MINIMUM_SPECIAL_CHARACTERS


...

public static final MINIMUM_UPPER_CASE


...

Method Summary
static valueOf(String name)
PasswordComplexityReq
uirement

static values()
PasswordComplexityReq
uirement[]

Methods inherited from class java.lang.Enum

compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

ESM Service Layer: Core Services 2.0 Page 98


Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Comparable

compareTo

Fields
MINIMUM_LENGTH
public static final
com.arcsight.product.core.service.v1.model.PasswordComplexityRequirement MINIMUM_LENGTH

is the password at least a minimum length ...

MAXIMUM_LENGTH
public static final
com.arcsight.product.core.service.v1.model.PasswordComplexityRequirement MAXIMUM_LENGTH

... at most a maximum length ...

MINIMUM_NUMERIC
public static final
com.arcsight.product.core.service.v1.model.PasswordComplexityRequirement MINIMUM_NUMERIC

... have a minimum number of numeric characters ...

MINIMUM_UPPER_CASE
public static final
com.arcsight.product.core.service.v1.model.PasswordComplexityRequirement
MINIMUM_UPPER_CASE

... have a minimum number of upper-case characters ...

MINIMUM_LOWER_CASE
public static final
com.arcsight.product.core.service.v1.model.PasswordComplexityRequirement
MINIMUM_LOWER_CASE

... have a minimum number of lower-case characters ...

MINIMUM_SPECIAL_CHARACTERS
public static final
com.arcsight.product.core.service.v1.model.PasswordComplexityRequirement
MINIMUM_SPECIAL_CHARACTERS

ESM Service Layer: Core Services 2.0 Page 99


... have a minimum number of special characters ...

MINIMUM_DIFFERENCE
public static final
com.arcsight.product.core.service.v1.model.PasswordComplexityRequirement
MINIMUM_DIFFERENCE

... at least a certain number of characters different from the old password

Methods
values
public static PasswordComplexityRequirement[] values()

valueOf
public static PasswordComplexityRequirement valueOf(String name)

ESM Service Layer: Core Services 2.0 Page 100


com.arcsight.product.core.service.v1.model
Class PasswordCredential
java.lang.Object
|
+-com.arcsight.product.core.service.v1.model.Credential
|
+-com.arcsight.product.core.service.v1.model.PasswordCredential
All Implemented Interfaces:
CoreServiceModel, CoreServiceModel

public class PasswordCredential


extends Credential
implements CoreServiceModel, CoreServiceModel

Constructor Summary
public PasswordCredential()
Constructor.

public PasswordCredential(String userName, String password)


Constructor.

Method Summary
String getPassword()
Gets the password of the login user.

void setPassword(String password)


Sets the password for the login user.

Methods inherited from class com.arcsight.product.core.service.v1.model.Credential

getUserName, setUserName

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
PasswordCredential
public PasswordCredential()

Constructor.

ESM Service Layer: Core Services 2.0 Page 101


PasswordCredential
public PasswordCredential(String userName,
String password)

Constructor.

Parameters:
userName - The login name of the login user.
password - The password of the login user.

Methods
getPassword
public String getPassword()

Gets the password of the login user.

Returns:
the password

setPassword
public void setPassword(String password)

Sets the password for the login user.

Parameters:
password - The password to set.

ESM Service Layer: Core Services 2.0 Page 102


com.arcsight.product.core.service.v1.model
Class PasswordRequirement
java.lang.Object
|
+-com.arcsight.product.core.service.v1.model.PasswordRequirement
All Implemented Interfaces:
CoreServiceModel

public class PasswordRequirement


extends Object
implements CoreServiceModel

Requirements for new passwords.

JSON prototype

Constructor Summary
public PasswordRequirement()

Method Summary
PasswordComplexityReq getRequirement()
uirement

Integer getValue()

void setRequirement(PasswordComplexityRequirement requirement)

void setValue(Integer value)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
PasswordRequirement
public PasswordRequirement()

Methods

ESM Service Layer: Core Services 2.0 Page 103


getRequirement
public PasswordComplexityRequirement getRequirement()

setRequirement
public void setRequirement(PasswordComplexityRequirement requirement)

getValue
public Integer getValue()

setValue
public void setValue(Integer value)

ESM Service Layer: Core Services 2.0 Page 104


com.arcsight.product.core.service.v1.model
Class Right
java.lang.Object
|
+-com.arcsight.product.core.service.v1.model.Right
All Implemented Interfaces:
CoreServiceModel

public class Right


extends Object
implements CoreServiceModel

DESCRIBE ME

JSON prototype

Constructor Summary
public Right()

Method Summary
String getCategory()

String getDescription()

long getId()

String getModule()

String getName()

String getType()

void setCategory(String category)

void setDescription(String description)

void setId(long id)

void setModule(String module)

void setName(String name)

ESM Service Layer: Core Services 2.0 Page 105


void setType(String type)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
Right
public Right()

Methods
getId
public long getId()

setId
public void setId(long id)

getType
public String getType()

setType
public void setType(String type)

getModule
public String getModule()

setModule
public void setModule(String module)

ESM Service Layer: Core Services 2.0 Page 106


getName
public String getName()

setName
public void setName(String name)

getDescription
public String getDescription()

setDescription
public void setDescription(String description)

getCategory
public String getCategory()

setCategory
public void setCategory(String category)

ESM Service Layer: Core Services 2.0 Page 107


com.arcsight.product.core.service.v1.model
Class ScheduledWorkPeriod
java.lang.Object
|
+-com.arcsight.product.core.service.v1.model.ScheduledWorkPeriod
All Implemented Interfaces:
CoreServiceModel

public class ScheduledWorkPeriod


extends Object
implements CoreServiceModel

Description of scheduled work period.

JSON prototype

Constructor Summary
public ScheduledWorkPeriod()

Method Summary
Workday getDayOfWeek()
Get the dayOfWeek.

Time getEndTime()
Get the endTime.

Long getId()
Get the id.

Time getStartTime()
Get the startTime.

void setDayOfWeek(Workday dayOfWeek)


Set the dayOfWeek.

void setEndTime(Time endTime)


Set the endTime.

void setId(Long id)


Set the id.

void setStartTime(Time startTime)


Set the startTime.

String toString()

ESM Service Layer: Core Services 2.0 Page 108


Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
ScheduledWorkPeriod
public ScheduledWorkPeriod()

Methods
getId
public Long getId()

Get the id.

Returns:
the id

setId
public void setId(Long id)

Set the id.

Parameters:
id - the id to set

getDayOfWeek
public Workday getDayOfWeek()

Get the dayOfWeek.

Returns:
the dayOfWeek

setDayOfWeek
public void setDayOfWeek(Workday dayOfWeek)

Set the dayOfWeek.

Parameters:
dayOfWeek - the dayOfWeek to set

ESM Service Layer: Core Services 2.0 Page 109


getStartTime
public Time getStartTime()

Get the startTime.

Returns:
the startTime

setStartTime
public void setStartTime(Time startTime)

Set the startTime.

Parameters:
startTime - the startTime to set

getEndTime
public Time getEndTime()

Get the endTime.

Returns:
the endTime

setEndTime
public void setEndTime(Time endTime)

Set the endTime.

Parameters:
endTime - the endTime to set

toString
public String toString()

ESM Service Layer: Core Services 2.0 Page 110


com.arcsight.product.core.service.v1.model
Class Session
java.lang.Object
|
+-com.arcsight.product.core.service.v1.model.Session
All Implemented Interfaces:
CoreServiceModel

public class Session


extends Object
implements CoreServiceModel

DESCRIBE ME

JSON prototype

Constructor Summary
public Session()

Method Summary
String getAuthToken()
Gets the string value of authToken.

long getCreationMillis()
Gets the long value of creation time in millisecond of this session.

long getExpirationMillis()
Gets the long value of expiration time in millisecond of this session.

long getUserId()
Gets the ID of the login user in this session.

void setAuthToken(String authToken)


Sets the string value of authToken.

void setCreationMillis(long creationMillis)


Sets the long value of creation time in millisecond of this session.

void setExpirationMillis(long expirationMillis)


Sets the long value of expiration time in millisecond of this session.

void setUserId(long userId)


Sets the ID of the login user in this session.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

ESM Service Layer: Core Services 2.0 Page 111


Constructors
Session
public Session()

Methods
getAuthToken
public String getAuthToken()

Gets the string value of authToken.

Returns:
The string value of authToken.

setAuthToken
public void setAuthToken(String authToken)

Sets the string value of authToken.

Parameters:
authToken - The string value of authToken.

getUserId
public long getUserId()

Gets the ID of the login user in this session.

Returns:
The ID of the login user.

setUserId
public void setUserId(long userId)

Sets the ID of the login user in this session.

Parameters:
userId - The ID of login user.

getCreationMillis
public long getCreationMillis()

Gets the long value of creation time in millisecond of this session.

ESM Service Layer: Core Services 2.0 Page 112


Returns:
The long value of creation time in millisecond of this session.

setCreationMillis
public void setCreationMillis(long creationMillis)

Sets the long value of creation time in millisecond of this session.

Parameters:
creationMillis - The long value of creation time in millisecond of this session.

getExpirationMillis
public long getExpirationMillis()

Gets the long value of expiration time in millisecond of this session.

Returns:
The long value of expiration time in millisecond of this session.

setExpirationMillis
public void setExpirationMillis(long expirationMillis)

Sets the long value of expiration time in millisecond of this session.

Parameters:
expirationMillis - The long value of expiration time in millisecond of this session.

ESM Service Layer: Core Services 2.0 Page 113


com.arcsight.product.core.service.v1.model
Class Time
java.lang.Object
|
+-com.arcsight.product.core.service.v1.model.Time
All Implemented Interfaces:
CoreServiceModel

public class Time


extends Object
implements CoreServiceModel

DESCRIBE ME

JSON prototype

Constructor Summary
public Time()

Method Summary
int getHour()
Get the hour.

int getMinutes()
Get the minutes.

void setHour(int hour)


Set the hour.

void setMinutes(int minutes)


Set the minutes.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
Time
public Time()

ESM Service Layer: Core Services 2.0 Page 114


Methods
getHour
public int getHour()

Get the hour.

Returns:
the hour

setHour
public void setHour(int hour)

Set the hour.

Parameters:
hour - the hour to set

getMinutes
public int getMinutes()

Get the minutes.

Returns:
the minutes

setMinutes
public void setMinutes(int minutes)

Set the minutes.

Parameters:
minutes - the minutes to set

ESM Service Layer: Core Services 2.0 Page 115


com.arcsight.product.core.service.v1.model
Class User
java.lang.Object
|
+-com.arcsight.product.core.service.v1.model.User
All Implemented Interfaces:
CoreServiceModel

public class User


extends Object
implements CoreServiceModel

DESCRIBE ME

JSON prototype

Constructor Summary
public User()
Constructor

Method Summary
String getDepartment()
Gets the department of this user.

String getEmail()
Gets the email of this user.

String getExternalLoginId()
Get the external login Id of this user.

String getFax()
Gets the fax information of this user.

String getFirstName()
Gets the first name of this user.

String[] getGroupIds()
Gets the IDs of the groups which this user is/was in.

Long getId()
Gets the ID of this user.

Boolean getIsActive()
Tests whether this user is active.

boolean getIsDefault()

ESM Service Layer: Core Services 2.0 Page 116


String getLastName()
Gets the last name of this user.

String getLogin()
Gets the login name of this user.

boolean getMustChangePassword()
Tests whether the password is required to change.

String getNotes()
Gets the notes of this user.

String getPagerNumber()
Gets the pager number of this user.

String getPassword()
Gets the password of this user.

String getPhone()
Gets the phone number of this user.

List getScheduledWorkPeriods()
Gets the list of scheduled work periods for this user.

String getTitle()
Gets the title of this user.

boolean isLocked()
Tests whether this user is locked.

void setDepartment(String department)


Sets the department of this user.

void setEmail(String email)


Sets the email of this user.

void setExternalLoginId(String externalLoginId)


Set the external login Id of this user.

void setFax(String fax)


Sets the fax information of this user.

void setFirstName(String firstName)


Sets the first name of this user.

void setGroupIds(String[] groupIds)


Sets the ID of the group which this user is in.

void setId(Long id)


Sets the ID of this user.

void setIsActive(Boolean isActive)


Sets whether this user is active.

void setIsDefault(boolean isDefault)

ESM Service Layer: Core Services 2.0 Page 117


void setLastName(String lastName)
Sets the last name of this user.

void setLocked(boolean locked)


Sets whether this user is locked.

void setLogin(String login)


Sets the login name of this user.

void setMustChangePassword(boolean mustChangePassword)


Sets whether the password is required to change.

void setNotes(String notes)


Sets the notes of this user.

void setPagerNumber(String pagerNumber)


Sets the pager number of this user.

void setPassword(String password)


Sets the password of this user.

void setPhone(String phone)


Sets the phone number of this user.

void setScheduledWorkPeriods(List scheduledWorkPeriods)


Set the list of scheduled work periods.

void setTitle(String title)


Sets the title of this user.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
User
public User()

Constructor

Methods
getId
public Long getId()

Gets the ID of this user.

Returns:
ID of this user.

ESM Service Layer: Core Services 2.0 Page 118


setId
public void setId(Long id)

Sets the ID of this user.

Parameters:
id - of this user.

getGroupIds
public String[] getGroupIds()

Gets the IDs of the groups which this user is/was in.

Returns:
IDs of the groups which this user is/was in.

setGroupIds
public void setGroupIds(String[] groupIds)

Sets the ID of the group which this user is in.

Parameters:
groupIds - ID of the group which this user is in.

getLogin
public String getLogin()

Gets the login name of this user.

Returns:
The login name of this user.

setLogin
public void setLogin(String login)

Sets the login name of this user.

Parameters:
login - The login name of this user.

getFirstName
public String getFirstName()

Gets the first name of this user.

Returns:
The first name of this user.

ESM Service Layer: Core Services 2.0 Page 119


setFirstName
public void setFirstName(String firstName)

Sets the first name of this user.

Parameters:
firstName - The first name of this user.

getLastName
public String getLastName()

Gets the last name of this user.

Returns:
The last name of this user.

setLastName
public void setLastName(String lastName)

Sets the last name of this user.

Parameters:
lastName - The last name of this user.

getEmail
public String getEmail()

Gets the email of this user.

Returns:
The email of this user.

setEmail
public void setEmail(String email)

Sets the email of this user.

Parameters:
email - The email of this user.

setPassword
public void setPassword(String password)

Sets the password of this user.

Parameters:
password - The password of this user.

ESM Service Layer: Core Services 2.0 Page 120


getIsActive
public Boolean getIsActive()

Tests whether this user is active.

Returns:
True if this user is active.

setIsActive
public void setIsActive(Boolean isActive)

Sets whether this user is active.

Parameters:
isActive - If true, this user is active.

getPhone
public String getPhone()

Gets the phone number of this user.

Returns:
The phone number of this user.

setPhone
public void setPhone(String phone)

Sets the phone number of this user.

Parameters:
phone - The phone number of this user.

getIsDefault
public boolean getIsDefault()

setIsDefault
public void setIsDefault(boolean isDefault)

getPassword
public String getPassword()

Gets the password of this user. NOTE: for API - business layer mapping only; not expected to be used by clients.

ESM Service Layer: Core Services 2.0 Page 121


Returns:
The password of this user.

getExternalLoginId
public String getExternalLoginId()

Get the external login Id of this user.

Returns:
The external login Id of this user.

setExternalLoginId
public void setExternalLoginId(String externalLoginId)

Set the external login Id of this user.

Parameters:
externalLoginId - The external login Id to set for this user.

getMustChangePassword
public boolean getMustChangePassword()

Tests whether the password is required to change.

Returns:
True if the password is required to change.

setMustChangePassword
public void setMustChangePassword(boolean mustChangePassword)

Sets whether the password is required to change.

Parameters:
mustChangePassword - If true, the password is required to change.

getScheduledWorkPeriods
public List getScheduledWorkPeriods()

Gets the list of scheduled work periods for this user.

Returns:
The list of scheduled work periods.

setScheduledWorkPeriods
public void setScheduledWorkPeriods(List scheduledWorkPeriods)

Set the list of scheduled work periods.

ESM Service Layer: Core Services 2.0 Page 122


Parameters:
scheduledWorkPeriods - The list of scheduled work periods to set

getTitle
public String getTitle()

Gets the title of this user.

Returns:
The title of this user.

setTitle
public void setTitle(String title)

Sets the title of this user.

Parameters:
title - The title of this user.

getDepartment
public String getDepartment()

Gets the department of this user.

Returns:
The department of this user.

setDepartment
public void setDepartment(String department)

Sets the department of this user.

Parameters:
department - The department of this user.

getFax
public String getFax()

Gets the fax information of this user.

Returns:
The fax information of this user.

setFax
public void setFax(String fax)

Sets the fax information of this user.

ESM Service Layer: Core Services 2.0 Page 123


Parameters:
fax - The fax information of this user.

getPagerNumber
public String getPagerNumber()

Gets the pager number of this user.

Returns:
The pager number of this user.

setPagerNumber
public void setPagerNumber(String pagerNumber)

Sets the pager number of this user.

Parameters:
pagerNumber - The pager number of this user.

getNotes
public String getNotes()

Gets the notes of this user.

Returns:
The notes of this user.

setNotes
public void setNotes(String notes)

Sets the notes of this user.

Parameters:
notes - The notes of this user.

isLocked
public boolean isLocked()

Tests whether this user is locked.

Returns:
True if this user is locked.

setLocked
public void setLocked(boolean locked)

Sets whether this user is locked.

ESM Service Layer: Core Services 2.0 Page 124


Parameters:
locked - If true, this user is locked.

ESM Service Layer: Core Services 2.0 Page 125


com.arcsight.product.core.service.v1.model
Class Workday
java.lang.Object
|
+-java.lang.Enum
|
+-com.arcsight.product.core.service.v1.model.Workday
All Implemented Interfaces:
Serializable, Comparable

public final class Workday


extends Enum

Field Summary
public static final Friday

public static final Monday

public static final Saturday

public static final Sunday

public static final Thursday

public static final Tuesday

public static final Wednesday

Method Summary
static Workday valueOf(String name)

static Workday[] values()

Methods inherited from class java.lang.Enum

compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Comparable

ESM Service Layer: Core Services 2.0 Page 126


compareTo

Fields
Sunday
public static final com.arcsight.product.core.service.v1.model.Workday Sunday

Monday
public static final com.arcsight.product.core.service.v1.model.Workday Monday

Tuesday
public static final com.arcsight.product.core.service.v1.model.Workday Tuesday

Wednesday
public static final com.arcsight.product.core.service.v1.model.Workday Wednesday

Thursday
public static final com.arcsight.product.core.service.v1.model.Workday Thursday

Friday
public static final com.arcsight.product.core.service.v1.model.Workday Friday

Saturday
public static final com.arcsight.product.core.service.v1.model.Workday Saturday

Methods

ESM Service Layer: Core Services 2.0 Page 127


values
public static Workday[] values()

valueOf
public static Workday valueOf(String name)

ESM Service Layer: Core Services 2.0 Page 128


Package
com.arcsight.product.core.service.v1.mode
l.jaxb

ESM Service Layer: Core Services 2.0 Page 129


com.arcsight.product.core.service.v1.model.jaxb
Class HashMapOfRightListResponse
java.lang.Object
|
+-com.arcsight.coma.util.HashMapOfListsResponse
|
+-com.arcsight.product.core.service.v1.model.jaxb.HashMapOfRightListResponse

public class HashMapOfRightListResponse


extends com.arcsight.coma.util.HashMapOfListsResponse

Class to be used with JAXB for return types like HashMap>.

Constructor Summary
public HashMapOfRightListResponse()

Methods inherited from class com.arcsight.coma.util.HashMapOfListsResponse

getReturn, setReturn

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
HashMapOfRightListResponse
public HashMapOfRightListResponse()

ESM Service Layer: Core Services 2.0 Page 130


com.arcsight.product.core.service.v1.model.jaxb
Class ObjectFactory
java.lang.Object
|
+-com.arcsight.product.core.service.v1.model.jaxb.ObjectFactory

public final class ObjectFactory


extends Object

Constructor Summary
public ObjectFactory()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
ObjectFactory
public ObjectFactory()

ESM Service Layer: Core Services 2.0 Page 131


Package
com.arcsight.product.core.service.v1.rest

ESM Service Layer: Core Services 2.0 Page 132


com.arcsight.product.core.service.v1.rest
Class LoginServiceImpl
java.lang.Object
|
+-com.arcsight.product.core.service.v1.rest.LoginServiceImpl

public class LoginServiceImpl


extends Object

Implementation of the login service interface.

Constructor Summary
public LoginServiceImpl()

Method Summary
LoginServiceAuthentic authenticate(LoginServiceAuthenticate value)
ateResponse
Authenticates the user with the given credentials.

LoginServiceAuthentic authenticateOSPCredential(javax.ws.rs.core.HttpHeaders hh)


ateOSPCredentialRespo
nse OSP has authenticated the user, this method verifies the user is valid in the system and
processes accordingly Note: It is expected that the OSPCredential has been stashed in a
ThreadLocal variable which is known to the OSPCredential class.

LoginServiceAuthentic authenticateOSPCredential(LoginServiceAuthenticateOSPCredential value)


ateOSPCredentialRespo
nse OSP has authenticated the user, this method verifies the user is valid in the system and
processes accordingly Note: It is expected that the OSPCredential has been stashed in a
ThreadLocal variable which is known to the OSPCredential class.

LoginServiceAuthentic authenticateOSPCredentialPost(javax.ws.rs.core.HttpHeaders hh)


ateOSPCredentialRespo
nse OSP has authenticated the user, this method verifies the user is valid in the system and
processes accordingly Note: It is expected that the OSPCredential has been stashed in a
ThreadLocal variable which is known to the OSPCredential class.

LoginServiceGetAuthen getAuthenticationMethod(javax.ws.rs.core.HttpHeaders hh)


ticationMethodRespons
e Gets the method that applications should use to authenticate users.

LoginServiceGetAuthen getAuthenticationMethod(LoginServiceGetAuthenticationMethod value)


ticationMethodRespons
e Gets the method that applications should use to authenticate users.

LoginServiceGetAuthen getAuthenticationMethodPost(javax.ws.rs.core.HttpHeaders hh)


ticationMethodRespons
e Gets the method that applications should use to authenticate users.

LoginServiceGetCurren getCurrentUser(LoginServiceGetCurrentUser value)


tUserResponse
Returns the login user for the current session.

LoginServiceGetCurren getCurrentUser(String authToken, javax.ws.rs.core.HttpHeaders hh)


tUserResponse
Returns the login user for the current session.

ESM Service Layer: Core Services 2.0 Page 133


LoginServiceGetCurren getCurrentUserPost(String authToken, javax.ws.rs.core.HttpHeaders hh)
tUserResponse
Returns the login user for the current session.

LoginServiceGetOSPSet getOSPSettings(javax.ws.rs.core.HttpHeaders hh)


tingsResponse
Gets the OSP settings from the jaas.config file.

LoginServiceGetOSPSet getOSPSettings(LoginServiceGetOSPSettings value)


tingsResponse
Gets the OSP settings from the jaas.config file.

LoginServiceGetOSPSet getOSPSettingsPost(javax.ws.rs.core.HttpHeaders hh)


tingsResponse
Gets the OSP settings from the jaas.config file.

LoginServiceGetServic getServiceMajorVersion(LoginServiceGetServiceMajorVersion value)


eMajorVersionResponse
The major version of this service.

LoginServiceGetServic getServiceMajorVersion(String authToken, javax.ws.rs.core.HttpHeaders hh)


eMajorVersionResponse
The major version of this service.

LoginServiceGetServic getServiceMajorVersionPost(String authToken, javax.ws.rs.core.HttpHeaders


eMajorVersionResponse hh)
The major version of this service.

LoginServiceGetServic getServiceMinorVersion(LoginServiceGetServiceMinorVersion value)


eMinorVersionResponse
The minor version of this service.

LoginServiceGetServic getServiceMinorVersion(String authToken, javax.ws.rs.core.HttpHeaders hh)


eMinorVersionResponse
The minor version of this service.

LoginServiceGetServic getServiceMinorVersionPost(String authToken, javax.ws.rs.core.HttpHeaders


eMinorVersionResponse hh)
The minor version of this service.

LoginServiceGetSessio getSession(LoginServiceGetSession value)


nResponse
Returns the current session.

LoginServiceGetSessio getSession(String authToken, javax.ws.rs.core.HttpHeaders hh)


nResponse
Returns the current session.

LoginServiceGetSessio getSessionPost(String authToken, javax.ws.rs.core.HttpHeaders hh)


nResponse
Returns the current session.

LoginServiceIsCASAuth isCASAuth(javax.ws.rs.core.HttpHeaders hh)


Response
Is authentication configured via CAS (Common Access Service).

LoginServiceIsCASAuth isCASAuth(LoginServiceIsCASAuth value)


Response
Is authentication configured via CAS (Common Access Service).

LoginServiceIsCASAuth isCASAuthPost(javax.ws.rs.core.HttpHeaders hh)


Response
Is authentication configured via CAS (Common Access Service).

LoginServiceLoginResp login(LoginServiceLogin value)


onse
Establishes a session using the specified login and password, and gets the string value of the
auth-token which is valid throughout the life of the session.

ESM Service Layer: Core Services 2.0 Page 134


LoginServiceLoginResp login(String login, String password, javax.ws.rs.core.HttpHeaders hh)
onse
Establishes a session using the specified login and password, and gets the string value of the
auth-token which is valid throughout the life of the session.

LoginServiceLoginForO loginForOneTimeUse(LoginServiceLoginForOneTimeUse value)


neTimeUseResponse
Establishes a session which can only be used once subsequent to its creation, and gets the
string value of auth-token which is valid throughout the life of the session.

LoginServiceLoginForO loginForOneTimeUse(String login, String password,


neTimeUseResponse javax.ws.rs.core.HttpHeaders hh)
Establishes a session which can only be used once subsequent to its creation, and gets the
string value of auth-token which is valid throughout the life of the session.

LoginServiceLoginForO loginForOneTimeUsePost(String login, String password,


neTimeUseResponse javax.ws.rs.core.HttpHeaders hh)
Establishes a session which can only be used once subsequent to its creation, and gets the
string value of auth-token which is valid throughout the life of the session.

LoginServiceLoginResp loginPost(String login, String password, javax.ws.rs.core.HttpHeaders hh)


onse
Establishes a session using the specified login and password, and gets the string value of the
auth-token which is valid throughout the life of the session.

Void logout(LoginServiceLogout value)


Drops the current session and its bound auth-token.

Void logout(String authToken, javax.ws.rs.core.HttpHeaders hh)


Drops the current session and its bound auth-token.

Void logoutPost(String authToken, javax.ws.rs.core.HttpHeaders hh)


Drops the current session and its bound auth-token.

Void resetPassword(LoginServiceResetPassword value)


Resets the password for the user specified by the login userName.

Void resetPassword(String login, javax.ws.rs.core.HttpHeaders hh)


Resets the password for the user specified by the login userName.

Void resetPasswordPost(String login, javax.ws.rs.core.HttpHeaders hh)


Resets the password for the user specified by the login userName.

LoginServiceSendAuthC sendAuthChallengeResponse(int challengeId, String resp,


hallengeResponseRespo javax.ws.rs.core.HttpHeaders hh)
nse
Sends a response for the requested challenge back to JAAS CallbackHandler, which initiates
that challenge.

LoginServiceSendAuthC sendAuthChallengeResponse(LoginServiceSendAuthChallengeResponse value)


hallengeResponseRespo
nse Sends a response for the requested challenge back to JAAS CallbackHandler, which initiates
that challenge.

LoginServiceSendAuthC sendAuthChallengeResponsePost(int challengeId, String resp,


hallengeResponseRespo javax.ws.rs.core.HttpHeaders hh)
nse
Sends a response for the requested challenge back to JAAS CallbackHandler, which initiates
that challenge.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

ESM Service Layer: Core Services 2.0 Page 135


Constructors
LoginServiceImpl
public LoginServiceImpl()

Methods
login
public LoginServiceLoginResponse login(String login,
String password,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Establishes a session using the specified login and password, and gets the string value of the auth-token which is valid
throughout the life of the session.
If the provided information is enough to authenticate the user, the server sends back the authentication token. Otherwise
this method throws an ServiceException. Check the error code of the exception to determine whether authentication failed
or the server requested additional challenge if the error code equals to RuntimeLoginException.LOGIN_CHALLENGE.
The ID of the additional challenge and key for the prompt string could be retrieved from exception's message that is
prepared as String.format("prompt=%s&id=%s", challengePromptKey, Integer.toString(challengeId)).
The client application is responsible for requesting additional information from the user for the challenge ID and sending the
response back via another method sendAuthChallengeResponse.

Parameters:
login - The login user name
password - The password of the login user
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
The string value of auth-token to use for further calls otherwise

Throws:
ServiceException - if authentication failed or the server challenges with additional question
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

loginPost
public LoginServiceLoginResponse loginPost(String login,
String password,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

ESM Service Layer: Core Services 2.0 Page 136


Establishes a session using the specified login and password, and gets the string value of the auth-token which is valid
throughout the life of the session.
If the provided information is enough to authenticate the user, the server sends back the authentication token. Otherwise
this method throws an ServiceException. Check the error code of the exception to determine whether authentication failed
or the server requested additional challenge if the error code equals to RuntimeLoginException.LOGIN_CHALLENGE.
The ID of the additional challenge and key for the prompt string could be retrieved from exception's message that is
prepared as String.format("prompt=%s&id=%s", challengePromptKey, Integer.toString(challengeId)).
The client application is responsible for requesting additional information from the user for the challenge ID and sending the
response back via another method sendAuthChallengeResponse.

Parameters:
login - The login user name
password - The password of the login user
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
The string value of auth-token to use for further calls otherwise

Throws:
ServiceException - if authentication failed or the server challenges with additional question
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated

login
public LoginServiceLoginResponse login(LoginServiceLogin value)
throws ServiceException,
AuthorizationException,
AuthenticationException

Establishes a session using the specified login and password, and gets the string value of the auth-token which is valid
throughout the life of the session.
If the provided information is enough to authenticate the user, the server sends back the authentication token. Otherwise
this method throws an ServiceException. Check the error code of the exception to determine whether authentication failed
or the server requested additional challenge if the error code equals to RuntimeLoginException.LOGIN_CHALLENGE.
The ID of the additional challenge and key for the prompt string could be retrieved from exception's message that is
prepared as String.format("prompt=%s&id=%s", challengePromptKey, Integer.toString(challengeId)).
The client application is responsible for requesting additional information from the user for the challenge ID and sending the
response back via another method sendAuthChallengeResponse.

Parameters:
value - Model object containing request body

Returns:
The string value of auth-token to use for further calls otherwise

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

ESM Service Layer: Core Services 2.0 Page 137


logout
public Void logout(String authToken,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Drops the current session and its bound auth-token.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

logoutPost
public Void logoutPost(String authToken,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Drops the current session and its bound auth-token.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated

logout
public Void logout(LoginServiceLogout value)
throws ServiceException,
AuthorizationException,
AuthenticationException

Drops the current session and its bound auth-token.

Parameters:
value - Model object containing request body

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

ESM Service Layer: Core Services 2.0 Page 138


getCurrentUser
public LoginServiceGetCurrentUserResponse getCurrentUser(String authToken,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Returns the login user for the current session. If there is no User associated with the current session this method returns
null.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
The login user for the current session or null

Throws:
ServiceException
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

getCurrentUserPost
public LoginServiceGetCurrentUserResponse getCurrentUserPost(String authToken,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Returns the login user for the current session. If there is no User associated with the current session this method returns
null.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
The login user for the current session or null

Throws:
ServiceException
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated

getCurrentUser
public LoginServiceGetCurrentUserResponse getCurrentUser(LoginServiceGetCurrentUser
value)
throws ServiceException,
AuthorizationException,
AuthenticationException

ESM Service Layer: Core Services 2.0 Page 139


Returns the login user for the current session. If there is no User associated with the current session this method returns
null.

Parameters:
value - Model object containing request body

Returns:
The login user for the current session or null

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

getSession
public LoginServiceGetSessionResponse getSession(String authToken,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Returns the current session.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
The current session.

Throws:
ServiceException
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

getSessionPost
public LoginServiceGetSessionResponse getSessionPost(String authToken,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Returns the current session.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
The current session.

Throws:

ESM Service Layer: Core Services 2.0 Page 140


ServiceException
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated

getSession
public LoginServiceGetSessionResponse getSession(LoginServiceGetSession value)
throws ServiceException,
AuthorizationException,
AuthenticationException

Returns the current session.

Parameters:
value - Model object containing request body

Returns:
The current session.

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

isCASAuth
public LoginServiceIsCASAuthResponse isCASAuth(javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Is authentication configured via CAS (Common Access Service).

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
True if authentication via CAS is enabled.

Throws:
ServiceException
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

isCASAuthPost
public LoginServiceIsCASAuthResponse isCASAuthPost(javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Is authentication configured via CAS (Common Access Service).

ESM Service Layer: Core Services 2.0 Page 141


Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
True if authentication via CAS is enabled.

Throws:
ServiceException
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated

isCASAuth
public LoginServiceIsCASAuthResponse isCASAuth(LoginServiceIsCASAuth value)
throws ServiceException,
AuthorizationException,
AuthenticationException

Is authentication configured via CAS (Common Access Service).

Parameters:
value - Model object containing request body

Returns:
True if authentication via CAS is enabled.

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

authenticate
public LoginServiceAuthenticateResponse authenticate(LoginServiceAuthenticate value)
throws ServiceException,
AuthorizationException,
AuthenticationException

Authenticates the user with the given credentials. If this is a multi-step authentication, the authContext needs to be passed
to indicate the session.
If the provided information is enough to authenticate the user, the server sends back an instance of AuthResponse
containing the authentication token. Otherwise this method throws an ServiceException. Check the error code of the
exception to determine whether authentication failed or the server requested additional challenge if the error code equals
to RuntimeLoginException.LOGIN_CHALLENGE. The ID of the additional challenge and key for the prompt string could
be retrieved from exception's message that is prepared as String.format("prompt=%s&id=%s",
challengePromptKey, Integer.toString(challengeId)). The client application is responsible for requesting
additional information from the user for the challenge ID and sending the response back via another method
sendAuthChallengeResponse.

Parameters:
value - Model object containing request body

Returns:
The response from the server, used to indicate if it was successful or more steps are required. Also contains the
authToken to be used in further operations

ESM Service Layer: Core Services 2.0 Page 142


Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

authenticateOSPCredential
public LoginServiceAuthenticateOSPCredentialResponse
authenticateOSPCredential(javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

OSP has authenticated the user, this method verifies the user is valid in the system and processes accordingly Note: It is
expected that the OSPCredential has been stashed in a ThreadLocal variable which is known to the OSPCredential class.
If the provided information is enough to identify the user in the service and the user account is accessible, the server sends
back an instance of AuthResponse containing the authentication token. Otherwise this method throws an ServiceException.
Check the error code of the exception to determine what failed.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
The response from the server, used to indicate if it was successful or more steps are required. Also contains the
authToken to be used in further operations

Throws:
ServiceException - if authentication failed
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

authenticateOSPCredentialPost
public LoginServiceAuthenticateOSPCredentialResponse
authenticateOSPCredentialPost(javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

OSP has authenticated the user, this method verifies the user is valid in the system and processes accordingly Note: It is
expected that the OSPCredential has been stashed in a ThreadLocal variable which is known to the OSPCredential class.
If the provided information is enough to identify the user in the service and the user account is accessible, the server sends
back an instance of AuthResponse containing the authentication token. Otherwise this method throws an ServiceException.
Check the error code of the exception to determine what failed.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
The response from the server, used to indicate if it was successful or more steps are required. Also contains the
authToken to be used in further operations

Throws:
ServiceException - if authentication failed

ESM Service Layer: Core Services 2.0 Page 143


com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated

authenticateOSPCredential
public LoginServiceAuthenticateOSPCredentialResponse
authenticateOSPCredential(LoginServiceAuthenticateOSPCredential value)
throws ServiceException,
AuthorizationException,
AuthenticationException

OSP has authenticated the user, this method verifies the user is valid in the system and processes accordingly Note: It is
expected that the OSPCredential has been stashed in a ThreadLocal variable which is known to the OSPCredential class.
If the provided information is enough to identify the user in the service and the user account is accessible, the server sends
back an instance of AuthResponse containing the authentication token. Otherwise this method throws an ServiceException.
Check the error code of the exception to determine what failed.

Parameters:
value - Model object containing request body

Returns:
The response from the server, used to indicate if it was successful or more steps are required. Also contains the
authToken to be used in further operations

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

sendAuthChallengeResponse
public LoginServiceSendAuthChallengeResponseResponse sendAuthChallengeResponse(int
challengeId,
String resp,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Sends a response for the requested challenge back to JAAS CallbackHandler, which initiates that challenge. This method is
to be called on behalf of a client (e.g. ArcSight Console) after the client receives the challenge challengeId and the user
provides the response.
If the provided response is enough to authenticate the user, the server sends back an instance of AuthResponse containing
the authentication token. Otherwise this method throws an ServiceException. Check the error code of the exception to
determine whether the server requested another challenge if the error code equals to
RuntimeLoginException.LOGIN_CHALLENGE or authentication failed. The ID of the additional challenge and key for the
prompt string could be retrieved from exception's message that is prepared as String.format("prompt=%s&id=%s",
challengePromptKey, Integer.toString(challengeId)).

Parameters:
challengeId - Identifier of a challenge send by JAAS authenticator
response - User response to the challenge
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
Authentication response which includes the authentication token

ESM Service Layer: Core Services 2.0 Page 144


Throws:
ServiceException - if authentication failed or the server challenges with another question
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

sendAuthChallengeResponsePost
public LoginServiceSendAuthChallengeResponseResponse sendAuthChallengeResponsePost(int
challengeId,
String resp,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Sends a response for the requested challenge back to JAAS CallbackHandler, which initiates that challenge. This method is
to be called on behalf of a client (e.g. ArcSight Console) after the client receives the challenge challengeId and the user
provides the response.
If the provided response is enough to authenticate the user, the server sends back an instance of AuthResponse containing
the authentication token. Otherwise this method throws an ServiceException. Check the error code of the exception to
determine whether the server requested another challenge if the error code equals to
RuntimeLoginException.LOGIN_CHALLENGE or authentication failed. The ID of the additional challenge and key for the
prompt string could be retrieved from exception's message that is prepared as String.format("prompt=%s&id=%s",
challengePromptKey, Integer.toString(challengeId)).

Parameters:
challengeId - Identifier of a challenge send by JAAS authenticator
response - User response to the challenge
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
Authentication response which includes the authentication token

Throws:
ServiceException - if authentication failed or the server challenges with another question
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated

sendAuthChallengeResponse
public LoginServiceSendAuthChallengeResponseResponse
sendAuthChallengeResponse(LoginServiceSendAuthChallengeResponse value)
throws ServiceException,
AuthorizationException,
AuthenticationException

Sends a response for the requested challenge back to JAAS CallbackHandler, which initiates that challenge. This method is
to be called on behalf of a client (e.g. ArcSight Console) after the client receives the challenge challengeId and the user
provides the response.
If the provided response is enough to authenticate the user, the server sends back an instance of AuthResponse containing
the authentication token. Otherwise this method throws an ServiceException. Check the error code of the exception to
determine whether the server requested another challenge if the error code equals to
RuntimeLoginException.LOGIN_CHALLENGE or authentication failed. The ID of the additional challenge and key for the
prompt string could be retrieved from exception's message that is prepared as String.format("prompt=%s&id=%s",
challengePromptKey, Integer.toString(challengeId)).

ESM Service Layer: Core Services 2.0 Page 145


Parameters:
value - Model object containing request body

Returns:
Authentication response which includes the authentication token

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

getAuthenticationMethod
public LoginServiceGetAuthenticationMethodResponse
getAuthenticationMethod(javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Gets the method that applications should use to authenticate users.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
The Auth

Throws:
ServiceException
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

getAuthenticationMethodPost
public LoginServiceGetAuthenticationMethodResponse
getAuthenticationMethodPost(javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Gets the method that applications should use to authenticate users.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
The Auth

Throws:
ServiceException
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated

ESM Service Layer: Core Services 2.0 Page 146


getAuthenticationMethod
public LoginServiceGetAuthenticationMethodResponse
getAuthenticationMethod(LoginServiceGetAuthenticationMethod value)
throws ServiceException,
AuthorizationException,
AuthenticationException

Gets the method that applications should use to authenticate users.

Parameters:
value - Model object containing request body

Returns:
The Auth

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

loginForOneTimeUse
public LoginServiceLoginForOneTimeUseResponse loginForOneTimeUse(String login,
String password,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Establishes a session which can only be used once subsequent to its creation, and gets the string value of auth-token which
is valid throughout the life of the session.
If the provided information is enough to authenticate the user, the server sends back the authentication token. Otherwise
this method throws an ServiceException. Check the error code of the exception to determine whether authentication failed
or the server requested additional challenge if the error code equals to RuntimeLoginException.LOGIN_CHALLENGE.
The ID of the additional challenge and key for the prompt string could be retrieved from exception's message that is
prepared as String.format("prompt=%s&id=%s", challengePromptKey, Integer.toString(challengeId)).
The client application is responsible for requesting additional information from the user for the challenge ID and sending the
response back via another method sendAuthChallengeResponse.

Parameters:
login - The login user name.
password - The password of the login user.
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
The string value of auth-token to use for further calls otherwise.

Throws:
ServiceException - if authentication failed or the server challenges with additional question
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

ESM Service Layer: Core Services 2.0 Page 147


loginForOneTimeUsePost
public LoginServiceLoginForOneTimeUseResponse loginForOneTimeUsePost(String login,
String password,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Establishes a session which can only be used once subsequent to its creation, and gets the string value of auth-token which
is valid throughout the life of the session.
If the provided information is enough to authenticate the user, the server sends back the authentication token. Otherwise
this method throws an ServiceException. Check the error code of the exception to determine whether authentication failed
or the server requested additional challenge if the error code equals to RuntimeLoginException.LOGIN_CHALLENGE.
The ID of the additional challenge and key for the prompt string could be retrieved from exception's message that is
prepared as String.format("prompt=%s&id=%s", challengePromptKey, Integer.toString(challengeId)).
The client application is responsible for requesting additional information from the user for the challenge ID and sending the
response back via another method sendAuthChallengeResponse.

Parameters:
login - The login user name.
password - The password of the login user.
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Returns:
The string value of auth-token to use for further calls otherwise.

Throws:
ServiceException - if authentication failed or the server challenges with additional question
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated

loginForOneTimeUse
public LoginServiceLoginForOneTimeUseResponse
loginForOneTimeUse(LoginServiceLoginForOneTimeUse value)
throws ServiceException,
AuthorizationException,
AuthenticationException

Establishes a session which can only be used once subsequent to its creation, and gets the string value of auth-token which
is valid throughout the life of the session.
If the provided information is enough to authenticate the user, the server sends back the authentication token. Otherwise
this method throws an ServiceException. Check the error code of the exception to determine whether authentication failed
or the server requested additional challenge if the error code equals to RuntimeLoginException.LOGIN_CHALLENGE.
The ID of the additional challenge and key for the prompt string could be retrieved from exception's message that is
prepared as String.format("prompt=%s&id=%s", challengePromptKey, Integer.toString(challengeId)).
The client application is responsible for requesting additional information from the user for the challenge ID and sending the
response back via another method sendAuthChallengeResponse.

Parameters:
value - Model object containing request body

Returns:
The string value of auth-token to use for further calls otherwise.

Throws:

ESM Service Layer: Core Services 2.0 Page 148


com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

getOSPSettings
public LoginServiceGetOSPSettingsResponse getOSPSettings(javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Gets the OSP settings from the jaas.config file.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Throws:
ServiceException
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

getOSPSettingsPost
public LoginServiceGetOSPSettingsResponse getOSPSettingsPost(javax.ws.rs.core.HttpHeaders
hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Gets the OSP settings from the jaas.config file.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Throws:
ServiceException
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated

getOSPSettings
public LoginServiceGetOSPSettingsResponse getOSPSettings(LoginServiceGetOSPSettings
value)
throws ServiceException,
AuthorizationException,
AuthenticationException

Gets the OSP settings from the jaas.config file.

Parameters:
value - Model object containing request body

ESM Service Layer: Core Services 2.0 Page 149


Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

resetPassword
public Void resetPassword(String login,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Resets the password for the user specified by the login userName. The ArcSight Manager assigns a new random password (8
characters, including numbers and letters) and sends it to the selected user's assigned e-mail address. Please note that this
feature needs to be configured as per ESM User's guide.

Parameters:
login - User name associated with the account.
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Throws:
ServiceException
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

resetPasswordPost
public Void resetPasswordPost(String login,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

Resets the password for the user specified by the login userName. The ArcSight Manager assigns a new random password (8
characters, including numbers and letters) and sends it to the selected user's assigned e-mail address. Please note that this
feature needs to be configured as per ESM User's guide.

Parameters:
login - User name associated with the account.
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Throws:
ServiceException
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated

ESM Service Layer: Core Services 2.0 Page 150


resetPassword
public Void resetPassword(LoginServiceResetPassword value)
throws ServiceException,
AuthorizationException,
AuthenticationException

Resets the password for the user specified by the login userName. The ArcSight Manager assigns a new random password (8
characters, including numbers and letters) and sends it to the selected user's assigned e-mail address. Please note that this
feature needs to be configured as per ESM User's guide.

Parameters:
value - Model object containing request body

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

getServiceMajorVersion
public LoginServiceGetServiceMajorVersionResponse getServiceMajorVersion(String
authToken,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

The major version of this service.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

getServiceMajorVersionPost
public LoginServiceGetServiceMajorVersionResponse getServiceMajorVersionPost(String
authToken,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

The major version of this service.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation

ESM Service Layer: Core Services 2.0 Page 151


com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated

getServiceMajorVersion
public LoginServiceGetServiceMajorVersionResponse
getServiceMajorVersion(LoginServiceGetServiceMajorVersion value)
throws ServiceException,
AuthorizationException,
AuthenticationException

The major version of this service.

Parameters:
value - Model object containing request body

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

getServiceMinorVersion
public LoginServiceGetServiceMinorVersionResponse getServiceMinorVersion(String
authToken,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

The minor version of this service.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

getServiceMinorVersionPost
public LoginServiceGetServiceMinorVersionResponse getServiceMinorVersionPost(String
authToken,
javax.ws.rs.core.HttpHeaders hh)
throws ServiceException,
AuthorizationException,
AuthenticationException

The minor version of this service.

Parameters:
authToken - Authentication token created for the current session
hh - HTTP headers from http request

ESM Service Layer: Core Services 2.0 Page 152


Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated

getServiceMinorVersion
public LoginServiceGetServiceMinorVersionResponse
getServiceMinorVersion(LoginServiceGetServiceMinorVersion value)
throws ServiceException,
AuthorizationException,
AuthenticationException

The minor version of this service.

Parameters:
value - Model object containing request body

Throws:
com.arcsight.coma.bridge.AuthorizationException - If the user is not authorized to perform this operation
com.arcsight.coma.bridge.AuthenticationException - If the user is not authenticated
com.arcsight.tools.coma.service.ServiceException - For any errors happened during execution of this
operation

ESM Service Layer: Core Services 2.0 Page 153


Package
com.arcsight.product.core.service.v1.rest.c
onfig

ESM Service Layer: Core Services 2.0 Page 154


com.arcsight.product.core.service.v1.rest.config
Class ApplicationConfig
java.lang.Object
|
+-javax.ws.rs.core.Application
|
+-org.glassfish.jersey.server.ResourceConfig
|
+-com.arcsight.product.core.service.v1.rest.config.ApplicationConfig
All Implemented Interfaces:
org.glassfish.jersey.server.ServerConfig, javax.ws.rs.core.Configurable

public class ApplicationConfig


extends org.glassfish.jersey.server.ResourceConfig

Nested Class Summary


class ApplicationConfig.AuthenticationExceptionMapper
ApplicationConfig.AuthenticationExceptionMapper

class ApplicationConfig.AuthorizationExceptionMapper
ApplicationConfig.AuthorizationExceptionMapper

class ApplicationConfig.JettisonJsonJaxbMessagingFeature
ApplicationConfig.JettisonJsonJaxbMessagingFeature

class ApplicationConfig.ServiceExceptionMapper
ApplicationConfig.ServiceExceptionMapper

Constructor Summary
public ApplicationConfig()

Methods inherited from class org.glassfish.jersey.server.ResourceConfig

addProperties, files, files, forApplication, forApplicationClass, forApplicationClass,


getApplication, getApplicationName, getClasses, getClassLoader, getConfiguration,
getContracts, getInstances, getProperties, getProperty, getPropertyNames, getResources,
getRuntimeType, getSingletons, isEnabled, isEnabled, isProperty, isRegistered,
isRegistered, packages, packages, property, register, register, register, register,
register, register, register, register, registerClasses, registerClasses,
registerFinder, registerInstances, registerInstances, registerResources,
registerResources, setApplicationName, setClassLoader, setProperties

Methods inherited from class javax.ws.rs.core.Application

getClasses, getProperties, getSingletons

ESM Service Layer: Core Services 2.0 Page 155


Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.ws.rs.core.Configurable

getConfiguration, property, register, register, register, register, register, register,


register, register

Methods inherited from interface org.glassfish.jersey.server.ServerConfig

getResources

Methods inherited from interface org.glassfish.jersey.ExtendedConfig

isProperty

Methods inherited from interface javax.ws.rs.core.Configuration

getClasses, getContracts, getInstances, getProperties, getProperty, getPropertyNames,


getRuntimeType, isEnabled, isEnabled, isRegistered, isRegistered

Constructors
ApplicationConfig
public ApplicationConfig()

ESM Service Layer: Core Services 2.0 Page 156


com.arcsight.product.core.service.v1.rest.config
Class ApplicationConfig.JettisonJsonJaxbMessagingFeature
java.lang.Object
|
+-org.glassfish.jersey.jettison.JettisonFeature
|
+-
com.arcsight.product.core.service.v1.rest.config.ApplicationConfig.JettisonJsonJaxbMessagi
ngFeature
All Implemented Interfaces:
javax.ws.rs.core.Feature

public static class ApplicationConfig.JettisonJsonJaxbMessagingFeature


extends org.glassfish.jersey.jettison.JettisonFeature

Constructor Summary
public JettisonJsonJaxbMessagingFeature()

Method Summary
boolean configure(javax.ws.rs.core.FeatureContext context)

Methods inherited from class org.glassfish.jersey.jettison.JettisonFeature

configure

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.ws.rs.core.Feature

configure

Constructors
JettisonJsonJaxbMessagingFeature
public JettisonJsonJaxbMessagingFeature()

Methods

ESM Service Layer: Core Services 2.0 Page 157


configure
public boolean configure(javax.ws.rs.core.FeatureContext context)

ESM Service Layer: Core Services 2.0 Page 158


com.arcsight.product.core.service.v1.rest.config
Class ApplicationConfig.AuthenticationExceptionMapper
java.lang.Object
|
+-
com.arcsight.product.core.service.v1.rest.config.ApplicationConfig.AuthenticationException
Mapper
All Implemented Interfaces:
javax.ws.rs.ext.ExceptionMapper

public static class ApplicationConfig.AuthenticationExceptionMapper


extends Object
implements javax.ws.rs.ext.ExceptionMapper

Constructor Summary
public AuthenticationExceptionMapper()

Method Summary
javax.ws.rs.core.Resp toResponse(AuthenticationException e)
onse

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.ws.rs.ext.ExceptionMapper

toResponse

Constructors
AuthenticationExceptionMapper
public AuthenticationExceptionMapper()

Methods
toResponse
public javax.ws.rs.core.Response toResponse(AuthenticationException e)

ESM Service Layer: Core Services 2.0 Page 159


ESM Service Layer: Core Services 2.0 Page 160
com.arcsight.product.core.service.v1.rest.config
Class ApplicationConfig.AuthorizationExceptionMapper
java.lang.Object
|
+-
com.arcsight.product.core.service.v1.rest.config.ApplicationConfig.AuthorizationExceptionM
apper
All Implemented Interfaces:
javax.ws.rs.ext.ExceptionMapper

public static class ApplicationConfig.AuthorizationExceptionMapper


extends Object
implements javax.ws.rs.ext.ExceptionMapper

Constructor Summary
public AuthorizationExceptionMapper()

Method Summary
javax.ws.rs.core.Resp toResponse(AuthorizationException e)
onse

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.ws.rs.ext.ExceptionMapper

toResponse

Constructors
AuthorizationExceptionMapper
public AuthorizationExceptionMapper()

Methods
toResponse
public javax.ws.rs.core.Response toResponse(AuthorizationException e)

ESM Service Layer: Core Services 2.0 Page 161


ESM Service Layer: Core Services 2.0 Page 162
com.arcsight.product.core.service.v1.rest.config
Class ApplicationConfig.ServiceExceptionMapper
java.lang.Object
|
+-
com.arcsight.product.core.service.v1.rest.config.ApplicationConfig.ServiceExceptionMapper
All Implemented Interfaces:
javax.ws.rs.ext.ExceptionMapper

public static class ApplicationConfig.ServiceExceptionMapper


extends Object
implements javax.ws.rs.ext.ExceptionMapper

Constructor Summary
public ServiceExceptionMapper()

Method Summary
javax.ws.rs.core.Resp toResponse(ServiceException e)
onse

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.ws.rs.ext.ExceptionMapper

toResponse

Constructors
ServiceExceptionMapper
public ServiceExceptionMapper()

Methods
toResponse
public javax.ws.rs.core.Response toResponse(ServiceException e)

ESM Service Layer: Core Services 2.0 Page 163


Package
com.arcsight.tools.coma.service

ESM Service Layer: Core Services 2.0 Page 164


com.arcsight.tools.coma.service
Class RuntimeCodedException
java.lang.Object
|
+-java.lang.Throwable
|
+-java.lang.Exception
|
+-java.lang.RuntimeException
|
+-com.arcsight.tools.coma.service.RuntimeCodedException
All Implemented Interfaces:
Serializable

Direct Known Subclasses:


RuntimeLoginException

public class RuntimeCodedException


extends RuntimeException

Base class for various internal runtime exceptions that may happen while communicating from service layer with internal ESM
classes.

Constructor Summary
public RuntimeCodedException()
Constructs a new runtime exception with null as its detail message.

public RuntimeCodedException(String message)


Constructs a new runtime exception with the specified detail message.

public RuntimeCodedException(Throwable cause)


Constructs a new runtime exception with the specified cause and a detail message of
(cause==null ? null : cause.toString()) (which typically contains the class and detail message
of cause).

public RuntimeCodedException(String message, Throwable cause)


Constructs a new runtime exception with the specified detail message and cause.

public RuntimeCodedException(int errorCode)


Constructs a new exception with the specified error code

Method Summary
int getErrorCode()
Returns the error code associated with this exception.

void setErrorCode(int errorCode)


Associates the error code with the exception.

Methods inherited from class java.lang.Throwable

ESM Service Layer: Core Services 2.0 Page 165


addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage,
getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace,
printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
RuntimeCodedException
public RuntimeCodedException()

Constructs a new runtime exception with null as its detail message.

RuntimeCodedException
public RuntimeCodedException(String message)

Constructs a new runtime exception with the specified detail message.

Parameters:
message - the detail message.

RuntimeCodedException
public RuntimeCodedException(Throwable cause)

Constructs a new runtime exception with the specified cause and a detail message of (cause==null ? null : cause.toString())
(which typically contains the class and detail message of cause). This constructor is useful for runtime exceptions that are
little more than wrappers for other throwables.

Parameters:
cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is
permitted, and indicates that the cause is nonexistent or unknown.)

RuntimeCodedException
public RuntimeCodedException(String message,
Throwable cause)

Constructs a new runtime exception with the specified detail message and cause.

Note that the detail message associated with cause is not automatically incorporated in this runtime exception's detail
message.

Parameters:
message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is
permitted, and indicates that the cause is nonexistent or unknown.)

ESM Service Layer: Core Services 2.0 Page 166


RuntimeCodedException
public RuntimeCodedException(int errorCode)

Constructs a new exception with the specified error code

Parameters:
errorCode - error code identifying the exceptional case

Methods
getErrorCode
public int getErrorCode()

Returns the error code associated with this exception. The error code is set when the exception thrown and it indicates the
failure or irregular situation.

Returns:
the errorCode

setErrorCode
public void setErrorCode(int errorCode)

Associates the error code with the exception.

Parameters:
errorCode - The errorCode to set

ESM Service Layer: Core Services 2.0 Page 167


com.arcsight.tools.coma.service
Class RuntimeLoginException
java.lang.Object
|
+-java.lang.Throwable
|
+-java.lang.Exception
|
+-java.lang.RuntimeException
|
+-com.arcsight.tools.coma.service.RuntimeCodedException
|
+-com.arcsight.tools.coma.service.RuntimeLoginException
All Implemented Interfaces:
Serializable

public class RuntimeLoginException


extends RuntimeCodedException

Exception thrown for authentication issues. It doesn't necessarily means failure. The exception could indicate a request for
additional information (challenge).
This is internal exception not returned by API calls. To report related exceptional cases to the clients API converts this exception to
ServiceLoginException

Field Summary
public static final LOGIN_CHALLENGE
Indicates additional challenge requested by the server.
Value: -4

public static final LOGIN_ERROR_FAILURE


Indicates login failure.
Value: 0

public static final LOGIN_ERROR_LICENSE_EXPIRED


Indicates an expired license.
Value: -1

public static final LOGIN_ERROR_PASSWORD_EXPIRED


Indicates expired password.
Value: -3

public static final LOGIN_ERROR_USER_DISABLED


Indicates the fact that user account was disabled.
Value: -2

public static final LOGIN_ERROR_USER_NOT_ALLOWED


Indicates that the user doesn't have permission to access the component.
Value: -5

ESM Service Layer: Core Services 2.0 Page 168


Constructor Summary
public RuntimeLoginException()
Constructs a new runtime exception with null as its detail message.

public RuntimeLoginException(String message)


Constructs a new runtime exception with the specified detail message.

public RuntimeLoginException(Throwable cause)


Constructs a new runtime exception with the specified cause and a detail message of
(cause==null ? null : cause.toString()) (which typically contains the class and detail message
of cause).

public RuntimeLoginException(String message, Throwable cause)


Constructs a new runtime exception with the specified detail message and cause.

public RuntimeLoginException(int errorCode)

Methods inherited from class com.arcsight.tools.coma.service.RuntimeCodedException

getErrorCode, setErrorCode

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage,


getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace,
printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Fields
LOGIN_ERROR_FAILURE
public static final int LOGIN_ERROR_FAILURE

Indicates login failure.


Constant value: 0

LOGIN_ERROR_LICENSE_EXPIRED
public static final int LOGIN_ERROR_LICENSE_EXPIRED

Indicates an expired license.


Constant value: -1

LOGIN_ERROR_USER_DISABLED
public static final int LOGIN_ERROR_USER_DISABLED

ESM Service Layer: Core Services 2.0 Page 169


Indicates the fact that user account was disabled.
Constant value: -2

LOGIN_ERROR_PASSWORD_EXPIRED
public static final int LOGIN_ERROR_PASSWORD_EXPIRED

Indicates expired password.


Constant value: -3

LOGIN_CHALLENGE
public static final int LOGIN_CHALLENGE

Indicates additional challenge requested by the server. Login cannot be completed until the user to meet the challenge.
Constant value: -4

LOGIN_ERROR_USER_NOT_ALLOWED
public static final int LOGIN_ERROR_USER_NOT_ALLOWED

Indicates that the user doesn't have permission to access the component.
Constant value: -5

Constructors
RuntimeLoginException
public RuntimeLoginException()

Constructs a new runtime exception with null as its detail message.

RuntimeLoginException
public RuntimeLoginException(String message)

Constructs a new runtime exception with the specified detail message.

Parameters:
message - the detail message.

RuntimeLoginException
public RuntimeLoginException(Throwable cause)

Constructs a new runtime exception with the specified cause and a detail message of (cause==null ? null : cause.toString())
(which typically contains the class and detail message of cause). This constructor is useful for runtime exceptions that are
little more than wrappers for other throwables.

Parameters:
cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is
permitted, and indicates that the cause is nonexistent or unknown.)

ESM Service Layer: Core Services 2.0 Page 170


RuntimeLoginException
public RuntimeLoginException(String message,
Throwable cause)

Constructs a new runtime exception with the specified detail message and cause.

Note that the detail message associated with cause is not automatically incorporated in this runtime exception's detail
message.

Parameters:
message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is
permitted, and indicates that the cause is nonexistent or unknown.)

RuntimeLoginException
public RuntimeLoginException(int errorCode)

ESM Service Layer: Core Services 2.0 Page 171


com.arcsight.tools.coma.service
Interface Service
All Known Implementing Classes:
ServiceBase

public interface Service


extends

Copyright (c) 2001-2018 Micro Focus or one of its affiliates. Confidential commercial computer software. Valid license required.
Base interface for services.

Method Summary
abstract int getServiceMajorVersion()
The major version of this service.

abstract int getServiceMinorVersion()


The minor version of this service.

Methods
getServiceMajorVersion
public abstract int getServiceMajorVersion()

The major version of this service.

Returns:
The major version of this service.

getServiceMinorVersion
public abstract int getServiceMinorVersion()

The minor version of this service.

Returns:
The minor version of this service.

ESM Service Layer: Core Services 2.0 Page 172


com.arcsight.tools.coma.service
Class ServiceBase
java.lang.Object
|
+-com.arcsight.tools.coma.service.ServiceBase
All Implemented Interfaces:
Service

public abstract class ServiceBase


extends Object
implements Service

Copyright (c) 2001-2018 Micro Focus or one of its affiliates. Confidential commercial computer software. Valid license required.
Base service implementation.

Constructor Summary
public ServiceBase()

Method Summary
int getServiceMajorVersion()

int getServiceMinorVersion()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.arcsight.tools.coma.service.Service

getServiceMajorVersion, getServiceMinorVersion

Constructors
ServiceBase
public ServiceBase()

Methods

ESM Service Layer: Core Services 2.0 Page 173


getServiceMajorVersion
public int getServiceMajorVersion()

getServiceMinorVersion
public int getServiceMinorVersion()

ESM Service Layer: Core Services 2.0 Page 174


com.arcsight.tools.coma.service
Class ServiceException
java.lang.Object
|
+-java.lang.Throwable
|
+-java.lang.Exception
|
+-com.arcsight.tools.coma.service.ServiceException
All Implemented Interfaces:
Serializable, Serializable

Direct Known Subclasses:


ValidationException, ServiceLoginException

public class ServiceException


extends Exception
implements Serializable, Serializable

This is exception for kahuna/coma service. There are several reasons to have special exception impl: 1. Make it serializable so all
service binding can marshal it 2. Due to the known GWT marshaling issue, parent message can not be marshaled we have to
duplicated parent instance variables in this class.

Field Summary
public static final ERROR_UNKNOWN

Value: -54188

Constructor Summary
public ServiceException()
Constructs a new exception with null as its detail message.

public ServiceException(String message)


Constructs a new exception with the specified detail message.

public ServiceException(Throwable cause)


Constructs a new exception with the specified cause and a detail message of (cause==null ?
null : cause.toString()) (which typically contains the class and detail message of cause).

public ServiceException(String message, Throwable cause)


Constructs a new exception with the specified detail message and cause.

Method Summary
static String buildExceptionStackTraceString(Throwable e)
It builds a string for stack trace of an exception.

ESM Service Layer: Core Services 2.0 Page 175


static createServiceException(Throwable e)
ServiceException
It creates an exception which is serializable.

int getErrorCode()
Returns the error code associated with this exception.

void setErrorCode(int errorCode)


Associates the error code with the exception.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage,


getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace,
printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Fields
ERROR_UNKNOWN
public static final int ERROR_UNKNOWN

Constant value: -54188

Constructors
ServiceException
public ServiceException()

Constructs a new exception with null as its detail message. The cause is not initialized, and may subsequently be initialized
by a call to Throwable.initCause(java.lang.Throwable).

ServiceException
public ServiceException(String message)

Constructs a new exception with the specified detail message. The cause is not initialized, and may subsequently be
initialized by a call to Throwable.initCause(java.lang.Throwable).

Parameters:
message - the detail message. The detail message is saved for later retrieval by the Throwable.getMessage()
method.

ServiceException
public ServiceException(Throwable cause)

ESM Service Layer: Core Services 2.0 Page 176


Constructs a new exception with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which
typically contains the class and detail message of cause). This constructor is useful for exceptions that are little more than
wrappers for other throwables (for example, java.security.PrivilegedActionException).

Parameters:
cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is
permitted, and indicates that the cause is nonexistent or unknown.)

ServiceException
public ServiceException(String message,
Throwable cause)

Constructs a new exception with the specified detail message and cause.

Note that the detail message associated with cause is not automatically incorporated in this exception's detail message.

Parameters:
message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is
permitted, and indicates that the cause is nonexistent or unknown.)

Methods
buildExceptionStackTraceString
public static String buildExceptionStackTraceString(Throwable e)

It builds a string for stack trace of an exception. It is used for debugging log.

Parameters:
e

Returns:

createServiceException
public static ServiceException createServiceException(Throwable e)

It creates an exception which is serializable. Some of the throwables, such as NullPointerException, are not serializable.
They will cause serialization error when they are wrapped in service exception. This approach wraps all stack traces as string
in service exception.

Parameters:
e

Returns:

getErrorCode
public int getErrorCode()

Returns the error code associated with this exception. The error code is set when the exception thrown and it indicates the
failure or irregular situation.

ESM Service Layer: Core Services 2.0 Page 177


Returns:
the errorCode

setErrorCode
public void setErrorCode(int errorCode)

Associates the error code with the exception.

Parameters:
errorCode - The errorCode to set

ESM Service Layer: Core Services 2.0 Page 178


com.arcsight.tools.coma.service
Class ServiceLoginException
java.lang.Object
|
+-java.lang.Throwable
|
+-java.lang.Exception
|
+-com.arcsight.tools.coma.service.ServiceException
|
+-com.arcsight.tools.coma.service.ServiceLoginException
All Implemented Interfaces:
Serializable, Serializable

public class ServiceLoginException


extends ServiceException

Exception thrown for authentication issues. It doesn't necessarily means failure. The exception could indicate a request for
additional information (challenge).

Field Summary
public static final LOGIN_ERROR_FAILURE
Indicates login failure.
Value: 0

public static final LOGIN_ERROR_LICENSE_EXPIRED


Indicates an expired license.
Value: -1

public static final LOGIN_ERROR_USER_DISABLED


Indicates the fact that user account was disabled.
Value: -2

public static final LOGIN_ERROR_USER_NOT_ALLOWED


Indicates that the user doesn't have permission to access the component.
Value: -5

Fields inherited from class com.arcsight.tools.coma.service.ServiceException

ERROR_UNKNOWN

Constructor Summary
public ServiceLoginException()
Constructs a new exception with null as its detail message.

public ServiceLoginException(String message)


Constructs a new exception with the specified detail message.

ESM Service Layer: Core Services 2.0 Page 179


public ServiceLoginException(Throwable cause)
Constructs a new exception with the specified cause and a detail message of (cause==null ?
null : cause.toString()) (which typically contains the class and detail message of cause).

public ServiceLoginException(String message, Throwable cause)


Constructs a new exception with the specified detail message and cause.

public ServiceLoginException(int errorCode)


Constructs a new exception with the specified error code

Methods inherited from class com.arcsight.tools.coma.service.ServiceException

buildExceptionStackTraceString, createServiceException, getErrorCode, setErrorCode

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage,


getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace,
printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Fields
LOGIN_ERROR_FAILURE
public static final int LOGIN_ERROR_FAILURE

Indicates login failure.


Constant value: 0

LOGIN_ERROR_LICENSE_EXPIRED
public static final int LOGIN_ERROR_LICENSE_EXPIRED

Indicates an expired license.


Constant value: -1

LOGIN_ERROR_USER_DISABLED
public static final int LOGIN_ERROR_USER_DISABLED

Indicates the fact that user account was disabled.


Constant value: -2

LOGIN_ERROR_USER_NOT_ALLOWED
public static final int LOGIN_ERROR_USER_NOT_ALLOWED

Indicates that the user doesn't have permission to access the component.

ESM Service Layer: Core Services 2.0 Page 180


Constant value: -5

Constructors
ServiceLoginException
public ServiceLoginException()

Constructs a new exception with null as its detail message. The cause is not initialized, and may subsequently be initialized
by a call to Throwable.initCause(java.lang.Throwable).

ServiceLoginException
public ServiceLoginException(String message)

Constructs a new exception with the specified detail message. The cause is not initialized, and may subsequently be
initialized by a call to Throwable.initCause(java.lang.Throwable).

Parameters:
message - the detail message. The detail message is saved for later retrieval by the Throwable.getMessage()
method.

ServiceLoginException
public ServiceLoginException(Throwable cause)

Constructs a new exception with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which
typically contains the class and detail message of cause). This constructor is useful for exceptions that are little more than
wrappers for other throwables (for example, java.security.PrivilegedActionException).

Parameters:
cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is
permitted, and indicates that the cause is nonexistent or unknown.)

ServiceLoginException
public ServiceLoginException(String message,
Throwable cause)

Constructs a new exception with the specified detail message and cause.

Note that the detail message associated with cause is not automatically incorporated in this exception's detail message.

Parameters:
message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is
permitted, and indicates that the cause is nonexistent or unknown.)

ServiceLoginException
public ServiceLoginException(int errorCode)

Constructs a new exception with the specified error code

Parameters:
errorCode - error code identifying the exceptional case

ESM Service Layer: Core Services 2.0 Page 181


com.arcsight.tools.coma.service
Class ValidationException
java.lang.Object
|
+-java.lang.Throwable
|
+-java.lang.Exception
|
+-com.arcsight.tools.coma.service.ServiceException
|
+-com.arcsight.tools.coma.service.ValidationException
All Implemented Interfaces:
Serializable, Serializable

public class ValidationException


extends ServiceException

Base class for various validation exceptions to indicate failures to validate different types of data (e.g. password).

Fields inherited from class com.arcsight.tools.coma.service.ServiceException

ERROR_UNKNOWN

Constructor Summary
public ValidationException()
Constructs a new exception with null as its detail message.

public ValidationException(String message)


Constructs a new exception with the specified detail message.

public ValidationException(String message, Map validationErrors)


Constructs a new exception with the specified detail message and a map containing error
descriptions.

Method Summary
String getLocalizedMessage()

String getMessage()

Map getValidationErrors()
Returns validationErrors, which is a map of errors found for different items.

void setValidationErrors(Map validationErrors)


Sets the validationErrors.

String toString()

ESM Service Layer: Core Services 2.0 Page 182


Methods inherited from class com.arcsight.tools.coma.service.ServiceException

buildExceptionStackTraceString, createServiceException, getErrorCode, setErrorCode

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage,


getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace,
printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors
ValidationException
public ValidationException()

Constructs a new exception with null as its detail message. The cause is not initialized, and may subsequently be initialized
by a call to Throwable.initCause(java.lang.Throwable).

ValidationException
public ValidationException(String message)

Constructs a new exception with the specified detail message. The cause is not initialized, and may subsequently be
initialized by a call to Throwable.initCause(java.lang.Throwable).

Parameters:
message - the detail message. The detail message is saved for later retrieval by the getMessage() method.

ValidationException
public ValidationException(String message,
Map validationErrors)

Constructs a new exception with the specified detail message and a map containing error descriptions. The cause is not
initialized, and may subsequently be initialized by a call to Throwable.initCause(java.lang.Throwable).

Parameters:
message - the detail message. The detail message is saved for later retrieval by the getMessage() method.
validationErrors - Map containing errors found for different items

Methods
getValidationErrors
public Map getValidationErrors()

Returns validationErrors, which is a map of errors found for different items.

ESM Service Layer: Core Services 2.0 Page 183


Returns:
the validationErrors errors associated with different properties

setValidationErrors
public void setValidationErrors(Map validationErrors)

Sets the validationErrors.

Parameters:
validationErrors - the validationErrors to set

getMessage
public String getMessage()

getLocalizedMessage
public String getLocalizedMessage()

toString
public String toString()

ESM Service Layer: Core Services 2.0 Page 184

You might also like