Product Documentation

The Rotate Symmetric Keys job will rotate and re-encrypt any record that used an encrypt ket that is older than the set cutoff days (be default is 365 days, annual). For example, if cutoff is at 365 days as default and the job runs in July 11, 2026, any token that was encrypted with a key older than or before July 11, 2025 will be re-encrypted with a newer encryption key. Which is why it is recommended to either schedule this job to run fairly soon at the start of the new year, or if there is too many tokens being generated, daily so it can keep up. Keep in mind, these jobs run on the background and as to not overload SAKA is best to schedule them on moments with lower usage of the appliance. The Rotate Symmetric Keys job will run automatically after schedule, only stopping when the user decides to stop it manually. This is a contrast to the Rotate Symmetric Keys Range which stops after all tokens selected on the range have their symmetric keys rotated. The steps to schedule this job are as follows:

  1. First, there needs to update the configuration variables to make available the job. This can be done by selecting "Configuration" -> "View Mutable Configuration" at the top, or selecting the tools icon in the hotbar. 


  2. Set the variables in the correct way for the job to run. There are two mutable configurations (number 76 to 78):
    1. Cutoff - The amount of days that must elapse before the symmetric key can be rotated. (It is set to true by default)  
    2. Reportprefix - The prefix to be used to name the reports (logs) generated by SAKA when running the job.
    3. Run - A boolean variable which sets whether the job can be run or not. Can be set to 'true' or 'false'. (It is set to true by default)



  3. After variables are correctly set, head into the Jobs tab by selecting the clock on the hotbar.


  4. By clicking the Rotate Symmetric Keys job and then the button for Scheduling on the bar at the right, the dialog will appear. For this job only two options will be available.


    1. Schedule first execution - This will set how many minutes to wait, from scheduling time, before the first execution of the job is ran.
    2. Execute schedule - Determines the time to wait after first execution to run the job again.
       
  5. Select Save at the bottom of the dialog to schedule the Rotate Symmetric Keys job.

 

Rotate Symmetric Keys Range

There is an option to do the Rotate Symmetric Keys job with a range of records instead of all the records that might be due for rotation. This job will take a selected number of record, by its tokens given on the scheduling process, to then rotate and re-encrypt those specific record. This job will complete once all symmetric keys have been rotated once for all records given. The steps to schedule this job are the same as with the Rotating Symmetric Keys that was explained above, but for the scheduling there will be more options available than there were before.

  1. Set the scheduling details on DACTool.


    1. Schedule first execution - This will set how many minutes to wait, from scheduling time, before the first execution of the job is ran.
    2. Execute schedule - Determines the time to wait after first execution to run the job again.
    3. Maximum Jobs to schedule - The amount of jobs to schedule to divide the workload of tokens. Example if there are 50 tokens selected, and this field is set at 5. Then there will be 5 jobs created, each one rotating 10 tokens of the ones selected, until every Symmetric key for those records are rotated.
    4. Range to Rotate (Min) - The minimum token from where the rotating will start. (Default will be the lowest token found on record)
    5. Range to Rotate (Max) - The maximum token from where the rotating will end. (Default will be the highest token found on record)

  2. Select Save to go see the preview of the jobs to be scheduled.

  3. Select Yes to successfully schedule the Rotate Symmetric Keys Range job/s.