14.2.1.8. Event Handler

The following event handlers are known to privacyIDEA

class privacyidea.lib.event.EventConfiguration[source]

This class is supposed to contain the event handling configuration during the Request. It can be read initially (in the init method) an can be accessed later during the request.

events
get_event(eventid)[source]

Return the reduced list with the given eventid. This list should only have one element.

Parameters:eventid (int) – id of the event
Returns:list with one element
get_handled_events(eventname)[source]

Return a list of the event handling definitions for the given eventname

Parameters:eventname
Returns:
privacyidea.lib.event.delete_event(event_id)[source]

Delete the event configuration with this given ID. :param event_id: The database ID of the event. :type event_id: int :return:

privacyidea.lib.event.enable_event(event_id, enable=True)[source]

Enable or disable the and event :param event_id: ID of the event :return:

class privacyidea.lib.event.event(eventname, request, g)[source]

This is the event decorator that calls the event handler in the handler module. This event decorator can be used at any API call

privacyidea.lib.event.get_handler_object(handlername)[source]

Return an event handler object based on the Name of the event handler class

Parameters:handlername – The identifier of the Handler Class
Returns:
privacyidea.lib.event.set_event(name, event, handlermodule, action, conditions=None, ordering=0, options=None, id=None, active=True)[source]

Set an event handling configuration. This writes an entry to the database eventhandler.

Parameters:
  • name – The name of the event definition
  • event (basestring) – The name of the event to react on. Can be a single event or a comma separated list.
  • handlermodule (basestring) – The identifier of the event handler module. This is an identifier string like “UserNotification”
  • action (basestring) – The action to perform. This is an action defined by the handler module
  • conditions (dict) – A condition. Only if this condition is met, the action is performed.
  • ordering (integer) – An optional ordering of the event definitions.
  • options (dict) – Additional options, that are needed as parameters for the action
  • id (int) – The DB id of the event. If the id is given, the event is updated. Otherwise a new entry is generated.
Returns:

The id of the event.