Package org.odpi.openmetadata.accessservices.communityprofile.client

Class SecurityGroupManagement

java.lang.Object

org.odpi.openmetadata.accessservices.communityprofile.client.SecurityGroupManagement

All Implemented Interfaces:

SecurityGroupInterface

public class SecurityGroupManagement
extends java.lang.Object
implements SecurityGroupInterface

SecurityManagerClient is the client for explicitly managing the security groups.

Constructor Summary

Constructors

Constructor	Description
SecurityGroupManagement(java.lang.String serverName, java.lang.String serverPlatformURLRoot)	Create a new client with no authentication embedded in the HTTP request.
SecurityGroupManagement(java.lang.String serverName, java.lang.String serverPlatformURLRoot, java.lang.String userId, java.lang.String password)	Create a new client that passes userId and password in each HTTP request.
SecurityGroupManagement(java.lang.String serverName, java.lang.String serverPlatformURLRoot, java.lang.String userId, java.lang.String password, AuditLog auditLog)	Create a new client that passes userId and password in each HTTP request.
SecurityGroupManagement(java.lang.String serverName, java.lang.String serverPlatformURLRoot, CommunityProfileRESTClient restClient, int maxPageSize)	Create a new client that passes userId and password in each HTTP request.
SecurityGroupManagement(java.lang.String serverName, java.lang.String serverPlatformURLRoot, AuditLog auditLog)	Create a new client with no authentication embedded in the HTTP request.

Method Summary

Modifier and Type	Method	Description
java.lang.String	createSecurityGroup(java.lang.String userId, SecurityGroupProperties properties)	Create a new security group.
void	deleteSecurityGroup(java.lang.String userId, java.lang.String securityGroupGUID)	Delete a specific security group.
java.util.List<SecurityGroupElement>	findSecurityGroups(java.lang.String userId, java.lang.String searchString, int startFrom, int pageSize)	Return the list of security groups that match the search string - this can be a regular expression.
java.util.List<ElementStub>	getElementsGovernedBySecurityGroup(java.lang.String userId, java.lang.String securityGroupGUID, int startFrom, int pageSize)	Return the elements that are governed by the supplied security group.
SecurityGroupElement	getSecurityGroupByGUID(java.lang.String userId, java.lang.String securityGroupGUID)	Retrieve the userIdentity metadata element with the supplied unique identifier.
java.util.List<SecurityGroupElement>	getSecurityGroupsForDistinguishedName(java.lang.String userId, java.lang.String distinguishedName, int startFrom, int pageSize)	Return the list of security groups associated with a unique distinguishedName.
void	updateSecurityGroup(java.lang.String userId, java.lang.String securityGroupGUID, boolean isMergeUpdate, SecurityGroupProperties properties)	Update an existing security group.

Methods inherited from class java.lang.Object

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

Constructor Detail

SecurityGroupManagement

public SecurityGroupManagement(java.lang.String serverName,
                               java.lang.String serverPlatformURLRoot)
                        throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST servers

Throws:

InvalidParameterException - bad input parameters

SecurityGroupManagement

public SecurityGroupManagement(java.lang.String serverName,
                               java.lang.String serverPlatformURLRoot,
                               AuditLog auditLog)
                        throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST servers

auditLog - logging destination

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

SecurityGroupManagement

public SecurityGroupManagement(java.lang.String serverName,
                               java.lang.String serverPlatformURLRoot,
                               java.lang.String userId,
                               java.lang.String password)
                        throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST servers

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

Throws:

InvalidParameterException - bad input parameters

SecurityGroupManagement

public SecurityGroupManagement(java.lang.String serverName,
                               java.lang.String serverPlatformURLRoot,
                               java.lang.String userId,
                               java.lang.String password,
                               AuditLog auditLog)
                        throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST servers

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

auditLog - logging destination

Throws:

InvalidParameterException - bad input parameters

SecurityGroupManagement

public SecurityGroupManagement(java.lang.String serverName,
                               java.lang.String serverPlatformURLRoot,
                               CommunityProfileRESTClient restClient,
                               int maxPageSize)
                        throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST servers

restClient - pre-initialized REST client

maxPageSize - pre-initialized parameter limit

Throws:

InvalidParameterException - there is a problem with the information about the remote OMAS

Method Detail

createSecurityGroup

public java.lang.String createSecurityGroup(java.lang.String userId,
                                            SecurityGroupProperties properties)
                                     throws InvalidParameterException,
                                            UserNotAuthorizedException,
                                            PropertyServerException

Create a new security group. The type of the definition is located in the properties.

Specified by:

createSecurityGroup in interface SecurityGroupInterface

Parameters:

userId - calling user

properties - properties of the definition

Returns:

unique identifier of the definition

Throws:

InvalidParameterException - typeName, documentIdentifier or userId is null; documentIdentifier is not unique; typeName is not valid

PropertyServerException - problem accessing the metadata service

UserNotAuthorizedException - security access problem

updateSecurityGroup

public void updateSecurityGroup(java.lang.String userId,
                                java.lang.String securityGroupGUID,
                                boolean isMergeUpdate,
                                SecurityGroupProperties properties)
                         throws InvalidParameterException,
                                UserNotAuthorizedException,
                                PropertyServerException

Update an existing security group.

Specified by:

updateSecurityGroup in interface SecurityGroupInterface

Parameters:

userId - calling user

securityGroupGUID - unique identifier of the definition to update

isMergeUpdate - are unspecified properties unchanged (true) or removed?

properties - properties to update

Throws:

InvalidParameterException - guid, documentIdentifier or userId is null; documentIdentifier is not unique; guid is not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

deleteSecurityGroup

public void deleteSecurityGroup(java.lang.String userId,
                                java.lang.String securityGroupGUID)
                         throws InvalidParameterException,
                                UserNotAuthorizedException,
                                PropertyServerException

Delete a specific security group.

Specified by:

deleteSecurityGroup in interface SecurityGroupInterface

Parameters:

userId - calling user

securityGroupGUID - unique identifier of the definition to remove

Throws:

InvalidParameterException - guid is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getSecurityGroupsForDistinguishedName

public java.util.List<SecurityGroupElement> getSecurityGroupsForDistinguishedName(java.lang.String userId,
                                                                                  java.lang.String distinguishedName,
                                                                                  int startFrom,
                                                                                  int pageSize)
                                                                           throws InvalidParameterException,
                                                                                  UserNotAuthorizedException,
                                                                                  PropertyServerException

Return the list of security groups associated with a unique distinguishedName. In an ideal world, there should be only one.

Specified by:

getSecurityGroupsForDistinguishedName in interface SecurityGroupInterface

Parameters:

userId - calling user

distinguishedName - unique name of the security group

startFrom - where to start from in the list of definitions

pageSize - max number of results to return in one call

Returns:

list of security groups

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the caller is not authorized to issue the request

PropertyServerException - the metadata service has problems

getElementsGovernedBySecurityGroup

public java.util.List<ElementStub> getElementsGovernedBySecurityGroup(java.lang.String userId,
                                                                      java.lang.String securityGroupGUID,
                                                                      int startFrom,
                                                                      int pageSize)
                                                               throws InvalidParameterException,
                                                                      UserNotAuthorizedException,
                                                                      PropertyServerException

Return the elements that are governed by the supplied security group.

Specified by:

getElementsGovernedBySecurityGroup in interface SecurityGroupInterface

Parameters:

userId - calling user

securityGroupGUID - unique name of the security group

startFrom - where to start from in the list of definitions

pageSize - max number of results to return in one call

Returns:

list of headers for the associated elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the caller is not authorized to issue the request

PropertyServerException - the metadata service has problems

findSecurityGroups

public java.util.List<SecurityGroupElement> findSecurityGroups(java.lang.String userId,
                                                               java.lang.String searchString,
                                                               int startFrom,
                                                               int pageSize)
                                                        throws InvalidParameterException,
                                                               UserNotAuthorizedException,
                                                               PropertyServerException

Return the list of security groups that match the search string - this can be a regular expression.

Specified by:

findSecurityGroups in interface SecurityGroupInterface

Parameters:

userId - calling user

searchString - value to search for

startFrom - where to start from in the list of definition results

pageSize - max number of results to return in one call

Returns:

list of security groups

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the caller is not authorized to issue the request

PropertyServerException - the metadata service has problems

getSecurityGroupByGUID

public SecurityGroupElement getSecurityGroupByGUID(java.lang.String userId,
                                                   java.lang.String securityGroupGUID)
                                            throws InvalidParameterException,
                                                   UserNotAuthorizedException,
                                                   PropertyServerException

Retrieve the userIdentity metadata element with the supplied unique identifier.

Specified by:

getSecurityGroupByGUID in interface SecurityGroupInterface

Parameters:

userId - calling user

securityGroupGUID - unique identifier of the requested metadata element

Returns:

matching metadata element

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)