Package org.odpi.openmetadata.metadatasecurity

Interface OpenMetadataUserSecurity

All Known Implementing Classes:

OpenMetadataAccessSecurityConnector

public interface OpenMetadataUserSecurity

This interface is used to authenticate a user and return the properties known about them that can be included in the resulting JWT token.

Method Summary

Modifier and Type	Method	Description
List<String>	getDefaultZonesForUser(List<String> initialZones, String typeName, String serviceName, String userId)	Determine the appropriate setting for the default zones depending on the user and the default zones set up for the service.
List<String>	getPublishZonesForUser(List<String> currentZones, String typeName, String serviceName, String userId)	Determine the appropriate setting for the zones depending on the user and the current zones set up for the element.
List<String>	getSupportedZonesForUser(List<String> supportedZones, String typeName, String serviceName, String userId)	Determine the appropriate setting for the supported zones depending on the user and the default supported zones set up for the service.
OpenMetadataUserAccount	getUserAccount(String userId)	Retrieve information about a specific user
List<String>	getWithdrawZonesForUser(List<String> currentZones, String typeName, String serviceName, String userId)	Determine the appropriate setting for the zones depending on the user and the current zones set up for the element.

Method Details

getUserAccount

OpenMetadataUserAccount getUserAccount(String userId)
                                throws UserNotAuthorizedException

Retrieve information about a specific user

Parameters:

userId - calling user

Returns:

security properties about the user

Throws:

UserNotAuthorizedException - user not recognized - or supplied an incorrect password

getSupportedZonesForUser

List<String> getSupportedZonesForUser(List<String> supportedZones,
 String typeName,
 String serviceName,
 String userId)
                               throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Determine the appropriate setting for the supported zones depending on the user and the default supported zones set up for the service. This is called whenever an element is accessed.

Parameters:

supportedZones - default setting of the supported zones

typeName - type of the element

serviceName - name of the called service

userId - name of the user

Returns:

list of supported zones for the user

Throws:

InvalidParameterException - one of the parameter values is invalid

PropertyServerException - there is a problem calculating the zones

UserNotAuthorizedException - unknown user

getDefaultZonesForUser

List<String> getDefaultZonesForUser(List<String> initialZones,
 String typeName,
 String serviceName,
 String userId)
                             throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Determine the appropriate setting for the default zones depending on the user and the default zones set up for the service. This is called whenever an element is created.

Parameters:

initialZones - default setting of the default zones from the caller's create request.

typeName - type of the element

serviceName - name of the called service

userId - name of the user

Returns:

list of default zones for the user

Throws:

InvalidParameterException - one of the parameter values is invalid

PropertyServerException - there is a problem calculating the zones

UserNotAuthorizedException - unknown user

getPublishZonesForUser

List<String> getPublishZonesForUser(List<String> currentZones,
 String typeName,
 String serviceName,
 String userId)
                             throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Determine the appropriate setting for the zones depending on the user and the current zones set up for the element. This is called whenever an element is published.

Parameters:

currentZones - default setting of the published zones

typeName - type of the element

serviceName - name of the called service

userId - name of the user

Returns:

list of published zones for the user

Throws:

InvalidParameterException - one of the parameter values is invalid

PropertyServerException - there is a problem calculating the zones

UserNotAuthorizedException - unknown user

getWithdrawZonesForUser

List<String> getWithdrawZonesForUser(List<String> currentZones,
 String typeName,
 String serviceName,
 String userId)
                              throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Determine the appropriate setting for the zones depending on the user and the current zones set up for the element. This is called whenever an element is withdrawn.

Parameters:

currentZones - default setting of the default zones

typeName - type of the element

serviceName - name of the called service

userId - name of the user

Returns:

list of published zones for the user

Throws:

InvalidParameterException - one of the parameter values is invalid

PropertyServerException - there is a problem calculating the zones

UserNotAuthorizedException - unknown user