API introduction

The API is documented in JavaDocs so you should browse it in most cases. Here is presented a short, general introduction only to show you good starting points. Package names were removed, but in most cases it is pl.edu.icm.unicore.voutils.

The classes in this package require quite complex configuration. You can provide it as a custom implementation of an proper interface: either IPullConfiguration or IPushConfiguration. There is a default implementation of both, which reads data from Java properties file: the PropertiesBasedConfiguration class. See Configuration document for the properties defined.

Pull mode support

  • VOAttributeFetcher this class allows for simple fetching of attributes for the effective user from the configured VO service. It can be used in custom authorisers or attribute resolvers.
  • SAMLAttributePullInHandler is a trivial wrapper around VOAttributeFetcher which invokes it as a handler. After adding it, fetched attributes are populated in standard UNICORE security context for every coming request.

Push mode support

  • ClientVOUtil allows for configuring SAMLAttributePushOutHandler to push previously obtained attributes to the service being used.
  • SAMLAttributePushInHandler extracts, parses and verifies assertions pushed in a request. Valid attributes are then injected into UNICORE security tokens.