Skip to content
Guiran Patrick edited this page Aug 8, 2011 · 1 revision

sshGate server : Data file format

This page describe how data are stored in sshGate server. Before reading this page, read sshGate-server: Description of directories and files.

Global configuration file

/etc/sshgate.conf is the system-wide configuration of sshGate. Each line contain a = pair. Line begining with a # are ignored.

{SSHGATE_DIR_DATA}/sshgate.setup is an internal configuration file. It define internal constant, and set configuration variable, which are not defined in the global configuration file (it define default values). Note that sshgate.setup file is a shell script file, not a pure configuration file.

Users

All users data are stored in {SSHGATE_DIR_USERS}. When a user is added, 2 files are created :

  • {SSHGATE_DIR_USERS}/ : the sshkey of the user, whom login is . The contain of the file is a standard sshkey, dsa or rsa, which could be used by OpenSSH.
  • {SSHGATE_DIR_USERS}/.properties : properties data of the user, stored in = format

To remove a user, sshGate delete its two files.

Targets & Access

All targets data are stored in {SSHGATE_DIR_TARGETS}. When a target is added, a {SSHGATE_DIR_TARGETS}/ is created, and it is deleted when a target is removed. In this directory, we can find several files :

  • access.groups.{ssh-login} : this file contain a list of usergroup name, one per line. Users of the usergroup can connect to the target with {ssh-login}.
  • access.users.{ssh-login} : This file contain a list of user login, one login per line. Each user can connect to the target with {ssh-login}.
  • (optional) properties : a configuration file containing = lines.
  • (optional) sshkey.priv / sshkey.pub : target specific sshkey pair, which can be used by OpenSSH.

User groups

All usergroups data are stored in {SSHGATE_DIR_USERS_GROUPS}. It contains one file per group, which name is the usergroup name. The file contain user logins, one per line.