gosa-core/debian/README.Debian

   1 GOsa 2.6 for debian
   2 -------------------
   3
   4 * Configure GOsa
   5
   6 By default you can point your favorite browser to the GOsa setup by
   7 using this URL:
   8
   9 http://you.server.address/gosa
  10
  11 Follow the instructions on the screen.
  12
  13
  14 * Security related information
  15
  16 GOsa is running as the www-data user. This makes it possible for other
  17 web applications (well, this is the rule for allmost every web application
  18 that stores information somewhere around) to read the gosa.conf file, which
  19 may contain vital information about your LDAP service.
  20
  21 To make it harder to extract these passwords, they get encrypted by a
  22 master password only readable by the GOsa location.
  23
  24 You can simply migrate old existing passwords by typing:
  25
  26 # a2enmod headers
  27 # gosa-encrypt-passwords
  28 # /etc/init.d/apache2 reload
  29
  30 If this is not enough for you (exploitable PHP code may make it possible to
  31 read the webservers memory), you can simply create another webserver instance
  32 running as a different user on different port for GOsa exclusively. Or use
  33 apache2-mpm-itk and assign a different user to a virtual host.
  34
  35
  36 * Generic informations
  37
  38 Getting GOsa running itself is not very complicated. Problems normally
  39 arise when integrating it in various services.
  40
  41 To play nice with your LDAP, you need to include the gosa schema files
  42 into your LDAP configuration. For Debian, you should install the
  43 gosa-schema package and add at least the following lines to your
  44 LDAP-servers slapd.conf:
  45
  46 Samba 2:
  47 include         /etc/ldap/schema/samba.schema
  48 include         /etc/ldap/schema/trust.schema
  49 include         /etc/ldap/schema/gosystem.schema
  50 include         /etc/ldap/schema/gofon.schema
  51 include         /etc/ldap/schema/goto.schema
  52 include         /etc/ldap/schema/gosa.schema
  53 include         /etc/ldap/schema/gofax.schema
  54 include         /etc/ldap/schema/goserver.schema
  55 include         /etc/ldap/schema/goto-mime.schema
  56
  57 Samba 3:
  58 include         /etc/ldap/schema/samba3.schema
  59 include         /etc/ldap/schema/trust.schema
  60 include         /etc/ldap/schema/gosystem.schema
  61 include         /etc/ldap/schema/gofon.schema
  62 include         /etc/ldap/schema/goto.schema
  63 include         /etc/ldap/schema/gosa+samba3.schema
  64 include         /etc/ldap/schema/gofax.schema
  65 include         /etc/ldap/schema/goserver.schema
  66 include         /etc/ldap/schema/goto-mime.schema
  67
  68 Schema files for samba and trust accounts are not part of the
  69 gosa-schema package, but are included in:
  70
  71 /usr/share/doc/gosa/contrib/openldap
  72
  73 There's no need to have samba services up and running, GOsa only
  74 uses the NT/LM attributes to pre-generate samba password hashes -
  75 to allow easy switching of account properties without asking for
  76 passwords after adding samba accounts.
  77
  78
  79 * Smarty PHP errors
  80
  81 There might pop up messages about "Only variables should be passed by
  82 reference" when using PHP5. I can't do anything about them - these are
  83 cause by smarty. To get rid of them set your "error_reporting" in the
  84 php.ini to "E_ALL ^ E_NOTICE". This is a workaround only, wait for the
  85 debian smarty package to support PHP5 in a propper way.
  86
  87
  88  -- Cajus Pollmeier <cajus@debian.org>  Mon, 07 Apr 2008 11:18:53 +0200
  89