Package cz.metacentrum.perun.core.impl

Class ExtSourceTCS

java.lang.Object

cz.metacentrum.perun.core.api.PerunBean

cz.metacentrum.perun.core.api.Auditable

cz.metacentrum.perun.core.api.ExtSource

cz.metacentrum.perun.core.impl.ExtSourceImpl

cz.metacentrum.perun.core.impl.ExtSourceTCS

All Implemented Interfaces:

ExtSourceApi, ExtSourceSimpleApi, Serializable, Comparable<PerunBean>

public class ExtSourceTCS
extends ExtSourceImpl
implements ExtSourceApi

Class ExtSource for TCS Synchronize certificates from defined address to Perun for existing users (skip not existing users)

Author:

Michal Stava stavamichal@gmail.com

See Also:

• Serialized Form

Field Summary

Fields inherited from class cz.metacentrum.perun.core.impl.ExtSourceImpl

perunBl

Constructor Summary

Constructors

Constructor	Description
ExtSourceTCS()

Method Summary

Modifier and Type	Method	Description
void	close()	If extSource needs to be closed, this method must be called.
List<Map<String,String>>	findSubjects(String searchString)	Finds all subjects with attributes in the external source, that contains searchString.
List<Map<String,String>>	findSubjects(String searchString, int maxResults)	Finds all subjects with attributes in the external source, that contains searchString limited by the maxResults
List<Map<String,String>>	findSubjectsLogins(String searchString)	Finds all subjects logins in the external source, that contains searchString.
List<Map<String,String>>	findSubjectsLogins(String searchString, int maxResults)	Finds all subjects logins in the external source, that contains searchString, limited by the maxResults.
protected Map<String,String>	getAttributes()
List<Map<String,String>>	getGroupSubjects(Map<String,String> attributes)	Get the list of the subjects in the external group.
Map<String,String>	getSubjectByLogin(String login)	Finds subject from the external source by the primary login used in external source.
List<Map<String,String>>	getSubjectGroups(Map<String,String> attributes)	Get the list of the subject groups in the external source.
List<Map<String,String>>	getUsersSubjects()	Get the list of subjects from the external source.
protected Map<String,Pair<org.bouncycastle.cert.X509CertificateHolder,String>>	prepareStructureOfValidCertificates(String url)	For every certificate from pem file (get from url address) parse only valid certificates.

Methods inherited from class cz.metacentrum.perun.core.api.ExtSource

compareTo, equals, getBeanName, getName, getType, hashCode, serializeToString, setName, setType, toString

Methods inherited from class cz.metacentrum.perun.core.api.Auditable

getCreatedAt, getCreatedBy, getCreatedByUid, getModifiedAt, getModifiedBy, getModifiedByUid, setCreatedAt, setCreatedBy, setCreatedByUid, setModifiedAt, setModifiedBy, setModifiedByUid

Methods inherited from class cz.metacentrum.perun.core.api.PerunBean

getId, setId

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

ExtSourceTCS

public ExtSourceTCS()

Method Details

close

public void close()
           throws ExtSourceUnsupportedOperationException

Description copied from interface: ExtSourceSimpleApi

If extSource needs to be closed, this method must be called.

Specified by:

close in interface ExtSourceSimpleApi

Throws:

ExtSourceUnsupportedOperationException

findSubjects

public List<Map<String,String>> findSubjects(String searchString)
                                      throws ExtSourceUnsupportedOperationException

Description copied from interface: ExtSourceApi

Finds all subjects with attributes in the external source, that contains searchString.

This method is used for getting all logins of subjects in external source with all possible attributes.

Specified by:

findSubjects in interface ExtSourceApi

Returns:

list of maps, which contains attr_name->attr_value (for all extSource attributes)

Throws:

ExtSourceUnsupportedOperationException

findSubjects

public List<Map<String,String>> findSubjects(String searchString,
 int maxResults)
                                      throws ExtSourceUnsupportedOperationException

Description copied from interface: ExtSourceApi

Finds all subjects with attributes in the external source, that contains searchString limited by the maxResults

This method is used for getting all logins of subjects in external source with all possible attributes.

Specified by:

findSubjects in interface ExtSourceApi

maxResults - define max number of returned results, 0 means unlimited

Returns:

list of maps, which contains attr_name->attr_value (for all extSource attributes)

Throws:

ExtSourceUnsupportedOperationException

findSubjectsLogins

public List<Map<String,String>> findSubjectsLogins(String searchString,
 int maxResults)
                                            throws ExtSourceUnsupportedOperationException

Description copied from interface: ExtSourceSimpleApi

Finds all subjects logins in the external source, that contains searchString, limited by the maxResults.

This method is used for getting all logins of subjects in external source and then use them to searching in external source for other subjects attributes

Specified by:

findSubjectsLogins in interface ExtSourceSimpleApi

maxResults - limit returned results

Returns:

list of maps, which contains attr_name->attr_value but only for login definition eg. login;MichalS

Throws:

ExtSourceUnsupportedOperationException

findSubjectsLogins

public List<Map<String,String>> findSubjectsLogins(String searchString)
                                            throws ExtSourceUnsupportedOperationException

Description copied from interface: ExtSourceSimpleApi

Finds all subjects logins in the external source, that contains searchString.

This method is used for getting all logins of subjects in external source and then use them to searching in external source for other subjects attributes.

Specified by:

findSubjectsLogins in interface ExtSourceSimpleApi

Returns:

list of maps, which contains attr_name->attr_value but only for login definition eg. login;MichalS

Throws:

ExtSourceUnsupportedOperationException

getAttributes

protected Map<String,String> getAttributes()

Overrides:

getAttributes in class ExtSourceImpl

getGroupSubjects

public List<Map<String,String>> getGroupSubjects(Map<String,String> attributes)

Description copied from interface: ExtSourceSimpleApi

Get the list of the subjects in the external group.

Specified by:

getGroupSubjects in interface ExtSourceSimpleApi

Parameters:

attributes - map of attributes used for quering the external source

Returns:

list of maps, which contains attr_name->attr_value, e.g. firstName->Michal

getSubjectByLogin

public Map<String,String> getSubjectByLogin(String login)
                                     throws ExtSourceUnsupportedOperationException

Description copied from interface: ExtSourceSimpleApi

Finds subject from the external source by the primary login used in external source.

Specified by:

getSubjectByLogin in interface ExtSourceSimpleApi

Parameters:

login - login used in the external source

Returns:

map which contains attr_name -> attr_value, e.g. firstName->Michal

Throws:

ExtSourceUnsupportedOperationException

getSubjectGroups

public List<Map<String,String>> getSubjectGroups(Map<String,String> attributes)
                                          throws ExtSourceUnsupportedOperationException

Description copied from interface: ExtSourceSimpleApi

Get the list of the subject groups in the external source.

Specified by:

getSubjectGroups in interface ExtSourceSimpleApi

Parameters:

attributes - map of attributes used for quering the external source

Returns:

list of maps, which contains attr name and attr value

Throws:

ExtSourceUnsupportedOperationException

getUsersSubjects

public List<Map<String,String>> getUsersSubjects()

Description copied from interface: ExtSourceSimpleApi

Get the list of subjects from the external source.

Specified by:

getUsersSubjects in interface ExtSourceSimpleApi

Returns:

list of maps, which contains attr_name->attr_value, e.g. firstName->Michal

prepareStructureOfValidCertificates

protected Map<String,Pair<org.bouncycastle.cert.X509CertificateHolder,String>> prepareStructureOfValidCertificates(String url)

For every certificate from pem file (get from url address) parse only valid certificates. Valid certificate means: - it is not expired - login of the owner can be parsed from certificate subject - every valid owner already exists in perun as User - if more than 1 certificate exists for same owner, choose the one with later expiration

Parameters:

url - address of url to parse pem file from

Returns:

map of logins (in key) to pair of parsed certificate in the left part and certificate in base64 in the right part

Throws:

InternalErrorException - If there is any IO problem with parsing and processing the certificate