Differences

This shows you the differences between two versions of the page.

--- operating_systems:linux:debian:acdsn-ac-fx [2012/11/12 09:08] – [New] sbolay
+++ operating_systems:linux:debian:acdsn-ac-fx [2012/11/19 14:23] – [cron.txt] tret
@@ Line 64: / Line 64: @@
 | query user                 | x         |||
+===== Configuration Files =====
+The configuration files are flat text file where each fields are separated by a tabulation.
+==== keys.txt ====
+Contains the list of the key used to hash the credentials on the iButton key. You can generate a new key every day and add it to this file, the most recent key comming first.
+^ Field Name ^ Description                                               ^ Example                    ^
+| timestamp  | The timestamp of the time when the key has been generated | 1350028169                 |
+| key        | The value of the secret key                               | [Z}4V;qr$(/Kc_aiF7#K8tATNC |
+<file txt demo_keys.txt>
+1350028169      [Z}4V;qr$(/Kc_aiF7#K8tATNC
+1349094539      IdRPKslg\?/
+1349085044      9YxUJ`wa#\U;M18=L,>_bo8wIbn"IoY
+1349085044      cl8b]It3f,F-b
+1349085044      ad15lMR{*]P_<koY&=@;cNgr
+</file>
+==== units.txt ====
+Provides a link beetween the unit id and a human readable label.
+^ Field Name ^ Description                                               ^ Example     ^
+| id         | The unique identifier of the unit, as used in slaves.conf | 2           |
+| label      | A human description of the unit                           | Main Office |
+<file txt demo_units.txt>
+       Reception
+       Main Office
+       CEO's Office
+</file>
+==== users.txt ====
+Contains the list of all users, the timestamp of the last key read from the user and a value which can be incremented
+when an iButton key is lost or if the data on the iButton key has been copied by some nasty people.
+^ Field Name ^ Description                                                  ^ Example     ^
+| id         | The unique identifier the the user, as used in cron.txt      | Arthur Dent |
+| timestamp  | The timestamp of the last key read for the user              | 1350028169  |
+| increment  | A value which can be incremented when an iButton key is lost | 3           |
+<file txt demo_users.txt>
+Arthur Dent             1350028169      3
+Ford Prefect            1349085044      2
+Zaphod Beeblebrox       1349085044      5
+</file>
+==== cron.txt ====
+Contains the rights to access on some unit for a user during a specified time interval (specified as a cron).
+^ Field Name ^ Description                                                  ^ Example      ^
+| unit_id    | The number identifying the target unit of this rule          | 1            |
+| user_id    | The identifier of the user on which this rule applies        | Arthur Dent  |
+| cron       | The cron value of the accessible periods for this rule       | 0 8-17 * * * |
+<file txt demo_cron.txt>
+       Arthur Dent     0 8-17 * * *
+       Arthur Dent     0 8-17 * * *
+       Ford Prefect    * * * * *
+</file>