Skip to main content

Introduction to Custom scripts

What is a Custom script?

The Administration Addon provides the admin user the capacity to launch custom scripts to perform any functionality or process that the Soffid API  has available.

Additionally, with this addon, there is available the possibility to enable a special to get the metrics of the performance of the Soffid IAM components.

Through the Custom scripts page you could perform the next operations:

  • You could create a new custom script.
  • You could execute the custom script On demand by clicking on the Execute now button.
  • You could execute the custom script as a Scheduled task, and it will be executed as you have configured the timetable. (*1)
    • Month: number of the month (1-12) when the task will be performed. 
    • Day:  number of the day (1-31) when the task will be performed.
    • Hour: hour (0-23) when the task will be performed. 
    • Minute: minute (0-59) when the task will be performed.
    • Day of week: number of day (0-7 where 0 means Sunday) of the week when the task will be performed. 
    • Server: where the agent is running.
  • You could define the event in which the script will be launched:

On user change

When you define an event on user change, the user object will be available.available on the user variable to access and operate with it. 

On grant permission


When

Enyou ladefine variablean userevent estarĂ¡on elrevoke usuario modificado
En la variablor grant elpermission, permisothe agregadogrant oobject revocado.
will be available on the grant variable to access and operate with it

Documentation

Below you could find a list of helpful links related to the building of custom scripts

API for the internal classes of Soffid: http://www.soffid.org/doc/console/latest/uml/

Custom utility classes: https://bookstack.soffid.com/books/soffid-3-reference-guide/page/utility-classes

Sample scripts

{{@100}}


(*1) For each value of mont, day, hour, minute or day of the week:

{{@102#bkmrk-%2A-means-any-month%2C-d}}