2 User Service

This chapter contains the following sections:

2.1 Overview

Oracle Identity Analytics Web Services (web services) have been designed to support interaction of third-party systems with the user information inside Oracle Identity Analytics 11gR1 software. A set of methods are provided to perform various operations inside Oracle Identity Analytics such as adding, deleting, or modifying users.

This chapter describes the web services used to get information from Oracle Identity Analytics regarding users in the Identity Warehouse.

Each web service has two parts: the request parameters and the response. For example, to obtain a list of roles allocated to a user, use the username request parameter. The RoleVO object is then returned with the information on the user's roles.

Note - The User Management Service has been deprecated and is superseded by the User Service. Implementations using methods from the User Management Service, however, can continue to use the older methods.

2.2 WSDL Access

WSDL stands for Web Services Description Language. It is an XML format for describing web services as a set of endpoints operating on messages, and contains information on how to access them. It specifies the location of each service and the operations (or methods) the service exposes.

Use the following to access User Service WSDL through a browser:

http://server-name:port-number/rbacx/ws/userService?wsdl

where server-name is the IP address or alias of the server on which Oracle Identity Analytics is running, and port-number is the port number of the application server that is listening to Oracle Identity Analytics calls.

Example:

http://localhost:8081/rbacx/ws/userService?wsdl

In the previous example, localhost is the server name, and 8081 is the port number of the application server.

2.3 API Reference

This section describes the web services used to get information from Oracle Identity Analytics regarding users.

2.3.1 Find All Users by Filter String

This web service finds all of the users filtered by a specific criteria. The request parameter is the String filterString, and an array of UserVO[] objects is returned with all of the users that satisfy the filter string.

2.3.1.1 Method Signature

public UserVO[] findUsers(String filterString) throws RbacxServiceException

2.3.1.2 Request Parameters

Name Data Type Description
filterString String The string to filter to find all of the users.

2.3.1.3 Response

Data Type Description
UserVO[] An array of UserVO objects is returned.

2.3.1.4 Exception

This method throws an RbacxService Exception that has an error code and an error message.

2.3.2 Find Roles For A User

This web service finds the roles allocated to a user. The request parameter is the string username whose roles need to be found, and an array of RoleVO[] objects is returned with the information on the user's roles.

2.3.2.1 Method Signature

public RoleVO[] getRolesForUser(String userName) throws RbacxServiceException

2.3.2.2 Request Parameters

Name Data Type Description
userName String The user name for which roles need to be checked.

2.3.2.3 Response

Data Type Description
RoleVO[] An array of RoleVO objects is returned.

2.3.2.4 Exception

This method throws an RbacxService Exception that has an error code and an error message.

2.3.3 Find Accounts for a User

This web service finds the accounts associated with a user. The request parameter is the String username, and an array of AccountVO[] objects is returned with a list of all the accounts that the user has.

2.3.3.1 Method Signature

public AccountVO[] getAccountsForUser(String userName) throws RbacxServiceException

2.3.3.2 Request Parameters

Name Data Type Description
userName String The user name for which an account list needs to be generated.

2.3.3.3 Response

Data Type Description
AccountVO[] An array of AccountVO objects is returned.

2.3.3.4 Exception

This method throws an RbacxService Exception that has an error code and an error message.

2.3.4 Create a New User

This web service creates a new user. The request parameter is UserVO user, and a Boolean is returned indicating whether or not the user was created.

2.3.4.1 Method Signature

public boolean createUser(UserVO user) throws RbacxServiceException

2.3.4.2 Request Parameter

Name Data Type Description
user UserVO The user object that needs to be created.

2.3.4.3 Response

Data Type Description
Boolean True if the user has been successfully created; false otherwise.

2.3.4.4 Exception

This method throws an RbacxService Exception that has an error code and an error message.

2.3.5 Create a New User if Rule-Based Role Assignment

This web service creates a new user if there is a rule-based role assignment. The request parameters are UserVO user and a Boolean, isRuleBasedRoleAssignment. A Boolean is returned indicating whether or not the user was created.

2.3.5.1 Method Signature

public boolean createUser(UserVO user, boolean isRuleBasedRoleAssignment) throws RbacxServiceException

2.3.5.2 Request Parameters

Name Data Type Description
user UserVO The user object that needs to be created.
isRuleBasedRoleAssignment Boolean True if it is a rule-based role assignment; false otherwise.

2.3.5.3 Response

Data Type Description
Boolean True if the user has been successfully created; false otherwise.

2.3.5.4 Exception

This method throws an RbacxService Exception that has an error code and an error message.

2.3.6 Update User

This web service provides the capability to update an existing user. The request parameter is UserVO user, and a Boolean is returned indicating whether or not the user was successfully updated.

2.3.6.1 Method Signature

public boolean updateUser(UserVO user) throws RbacxServiceException

2.3.6.2 Request Parameter

Name Data Type Description
user UserVO The user object that needs to be updated.

2.3.6.3 Response

Data Type Description
Boolean True if the user has been successfully updated; false otherwise.

2.3.6.4 Exception

This method throws an RbacxService Exception that has an error code and an error message.

2.3.7 Update User if Rule-Based Role Assignment

This web service updates a user if there is a rule-based role assignment. The request parameter is UserVO user and a Boolean, isRuleBasedRoleAssignment. A Boolean is returned indicating whether or not the user was updated.

2.3.7.1 Method Signature

public boolean updateUser(UserVO user, boolean isRuleBasedRoleAssignment) throws RbacxServiceException

2.3.7.2 Request Parameters

Name Data Type Description
user UserVO The user object that needs to be created.
isRuleBasedRoleAssignment Boolean True if it is a rule-based role assignment; false otherwise.

2.3.7.3 Response

Data Type Description
Boolean True if the user has been successfully updated; false otherwise.

2.3.7.4 Exception

This method throws an RbacxService Exception that has an error code and an error message.

2.3.8 Disable Users

This web service disables existing users. The request parameter is a list of usernames, and a Boolean is returned indicating whether or not all of the users were disabled.

2.3.8.1 Method Signature

public boolean disableUsers(String[] userNames) throws RbacxServiceException

2.3.8.2 Request Parameter

Name Data Type Description
usernames String[] A list of usernames that have to be disabled.

2.3.8.3 Response

Data Type Description
Boolean True if all of the users have been disabled; false otherwise.

2.3.8.4 Exception

This method throws an RbacxService Exception that has an error code and an error message.

2.3.9 Enable Users

This web service provides the capability to enable existing users. The request parameter is a list of usernames, and a Boolean is returned indicating whether or not all of the users were enabled.

2.3.9.1 Method Signature

public boolean enableUsers(String[] userNames) throws RbacxServiceException

2.3.9.2 Request Parameter

Name Data Type Description
usernames String[] A list of usernames that need to be enabled.

2.3.9.3 Response

Data Type Description
Boolean True if all of the users are enabled; false otherwise.

2.3.9.4 Exception

This method throws an RbacxService Exception that has an error code and an error message.

2.3.10 Find Business Units for a User

This web service finds the business units assigned to a user. The request parameter is the string username whose business units need to be found. An array of BusinessUnitVO[] objects is returned with the information on the user's business units.

2.3.10.1 Method Signature

public BusinessUnitVO[] getBusinessUnitsForUser(String userName) throws RbacxServiceException

2.3.10.2 Request Parameters

Name Data Type Description
userName String The user name for which business units need to be checked.

2.3.10.3 Response

Data Type Description
BusinessUnitVO[] An array of BusinessUnitVO objects is returned.

2.3.10.4 Exception

This method throws an RbacxService Exception that has an error code and an error message.

2.3.11 Remove All Roles From User

This web service removes all the roles from a user. The request parameter is the String username, and a Boolean flag is returned to indicate the result.

2.3.11.1 Method Signature

public boolean removeAllRolesfromUser(String userName) throws RbacxServiceException

2.3.11.2 Request Parameters

Name Data Type Description
userName String The name of the user whose roles need to be removed.

2.3.11.3 Response

Data Type Description
Boolean True if all the roles have been successfully removed from the user; false otherwise.

2.3.11.4 Exception

This method throws an RbacxService Exception that has an error code and an error message.