User.pm: add no-pty to each key in ssh keys file
[girocco.git] / Girocco / Config.pm
blob9ce63f4a64761ad20f97b6cdaaa96877ec9cd7a8
1 package Girocco::Config;
3 use strict;
4 use warnings;
7 ## Basic settings
9 # Name of the service
10 our $name = "GiroccoEx";
12 # Nickname of the service (undef for initial part of $name upto first '.')
13 our $nickname = undef;
15 # Title of the service (as shown in gitweb)
16 our $title = "Example Girocco Hosting";
18 # Path to the Git binary to use (you MUST set this, even if to /usr/bin/git!)
19 our $git_bin = '/usr/bin/git';
21 # Path to the git-daemon binary to use (undef to use default)
22 # If $gitpullurl is undef this will never be used (assuming no git inetd
23 # service has been set up in that case).
24 # The default if this is undef is `$git_bin --exec-path`/git-daemon
25 # Setting this explicitly is slightly more efficient as it avoids calling --exec-path
26 our $git_daemon_bin = undef;
28 # Path to the git-http-backend binary to use (undef to use default)
29 # If both $httppullurl and $httpspushurl are undef this will never be used
30 # The default if this is undef is `$git_bin --exec-path`/git-http-backend
31 # Setting this explicitly is slightly more efficient as it avoids calling --exec-path
32 our $git_http_backend_bin = undef;
34 # Name (if in $PATH) or full path to netcat executable that accepts a -U option
35 # to connect to a unix socket. This may simply be 'nc' on many systems.
36 our $nc_openbsd_bin = 'nc.openbsd';
38 # Path to the sendmail instance to use. It should understand the -f <from>, -i and -t
39 # options as well as accepting a list of recipient addresses in order to be used here.
40 # You MUST set this, even if to '/usr/sbin/sendmail'!
41 # Setting this to 'sendmail.pl' is special and will automatically be expanded to
42 # a full path to the ../bin/sendmail.pl executable in this Girocco installation.
43 # sendmail.pl is a sendmail-compatible script that delivers the message directly
44 # using SMTP to a mail relay host. This is the recommended configuration as it
45 # minimizes the information exposed to recipients (no sender account names or uids),
46 # can talk to an SMTP server on another host (eliminating the need for a working
47 # sendmail and/or SMTP server on this host) and avoids any unwanted address rewriting.
48 # By default it expects the mail relay to be listening on localhost port 25.
49 # See the sendmail.pl section below for more information on configuring sendmail.pl.
50 our $sendmail_bin = 'sendmail.pl';
52 # E-mail of the site admin
53 our $admin = 'admin@example.org';
55 # Sender of emails
56 # This is the SMTP 'MAIL FROM:' value
57 # It will be passed to $sendmail_bin with the -f option
58 # Some sites may not allow non-privileged users to pass the -f option to
59 # $sendmail_bin. In that case set this to undef and no -f option will be
60 # passed which means the 'MAIL FROM:' value will be the user the mail is
61 # sent as (either $cgi_user or $mirror_user depending on the activity).
62 # To avoid having bounce emails go to $admin, this may be set to something
63 # else such as 'admin-noreply@example.org' and then the 'admin-noreply' address
64 # may be redirected to /dev/null. Setting this to '' or '<>' is not
65 # recommended because that will likely cause the emails to be marked as SPAM
66 # by the receiver's SPAM filter. If $sendmail_bin is set to 'sendmail.pl' this
67 # value must be acceptable to the receiving SMTP server as a 'MAIL FROM:' value.
68 # If this is set to undef and 'sendmail.pl' is used, the 'MAIL FROM:' value will
69 # be the user the mail is sent as (either $cgi_user or $mirror_user).
70 our $sender = $admin;
72 # Copy $admin on failure/recovery messages?
73 our $admincc = 1;
75 # Girocco branch to use for html.cgi view source links (undef for HEAD)
76 our $giroccobranch = undef;
79 ## Git user agent strings
81 # Git clients (i.e. fetch/clone) always send a user agent string when fetching
82 # over HTTP. Since version 1.7.12.1 an 'agent=' capability string is included
83 # as well which affects git:, smart HTTP and ssh: protocols.
85 # These settings allow the default user agent string to be changed independently
86 # for fetch/clone operations (only matters if $mirror is true) and server
87 # operations (some other Git client fetching from us). Note that it is not
88 # possible to suppress the capability entirely although it can be set to an
89 # empty string. If these values are not set, the default user agent string
90 # will be used. Typically (unless Git was built with non-standard options) the
91 # default is "git/" plus the version. So for example "git/1.8.5.6" or
92 # "git/2.1.4" might be seen.
94 # One might want to change the default user agent strings in order to prevent
95 # an attacker from learning the exact Git version being used to avoid being
96 # able to quickly target any version-specific vulnerabilities. Note that
97 # no matter what's set here, an attacker can easily determine whether a server
98 # is running JGit, libgit2 or Git and for Git whether it's version 1.7.12.1 or
99 # later. A reasonable value to hide the exact Git version number while
100 # remaining compatible with servers that require a "Git/" user agent string
101 # would be something like "git/2" or even just "git/".
103 # The GIT_USER_AGENT value to use when acting as a client (i.e. clone/fetch)
104 # This value is only used if $mirror is true and at least one mirror is set up.
105 # Setting this to the empty string will suppress the HTTP User-Agent header,
106 # but will still include an "agent=" capability in the packet protocol. The
107 # empty string is not recommended because some servers match on "git/".
108 # Leave undef to use the default Git user agent string
109 # IMPORTANT: some server sites will refuse to serve up Git repositories unless
110 # the client user agent string contains "Git/" (matched case insensitively)!
111 our $git_client_ua = undef;
113 # The GIT_USER_AGENT value to use when acting as a server (i.e. some Git client
114 # is fetching/cloning from us).
115 # Leave undef to use the default Git user agent string
116 our $git_server_ua = undef;
119 ## Feature knobs
121 # Enable mirroring mode if true (see "Foreign VCS mirrors" section below)
122 our $mirror = 1;
124 # Enable push mode if true
125 our $push = 1;
127 # If both $mirror and $push are enabled, setting this to 'mirror' pre-selects
128 # mirror mode on the initial regproj display, otherwise 'push' mode will be
129 # pre-selected. When forking the initial mode will be 'push' if $push enabled.
130 our $initial_regproj_mode = 'mirror';
132 # Enable user management if true; this means the interface for registering
133 # user accounts and uploading SSH keys. This implies full chroot.
134 our $manage_users = 1;
136 # Minimum key length (in bits) for uploaded SSH RSA/DSA keys.
137 # If this is not set (i.e. undef) keys as small as 512 bits will be allowed.
138 # Nowadays keys less than 2048 bits in length should probably not be allowed.
139 # Note, however, that versions of OpenSSH starting with 4.3p1 will only generate
140 # DSA keys of exactly 1024 bits in length even though that length is no longer
141 # recommended. (OpenSSL can be used to generate DSA keys with lengths > 1024.)
142 # OpenSSH does not have any problem generating RSA keys longer than 1024 bits.
143 # This setting is only checked when new keys are added so setting it/increasing it
144 # will not affect existing keys. For maximum compatibility a value of 1024 may
145 # be used however 2048 is recommended. Setting it to anything other than 1024,
146 # 2048 or 3072 may have the side effect of making it very difficult to generate
147 # DSA keys that satisfy the restriction (but RSA keys should not be a problem).
148 # Note that no matter what setting is specified here keys smaller than 512 bits
149 # will never be allowed via the reguser.cgi/edituser.cgi interface.
150 # RECOMMENDED VALUE: 2048 (ok) or 3072 (better)
151 our $min_key_length = 1024;
153 # Disable DSA public keys?
154 # If this is set to 1, adding DSA keys at reguser.cgi/edituser.cgi time will be
155 # prohibited. If $pushurl is undef then this is implicitly set to 1 since DSA
156 # keys are not usable with https push.
157 # OpenSSH will only generate 1024 bit DSA keys starting with version 4.3p1.
158 # Even if OpenSSL is used to generate a longer DSA key (which can then be used
159 # with OpenSSH), the SSH protocol itself still forces use of SHA-1 in the DSA
160 # signature blob which tends to defeat the purpose of going to a longer key in
161 # the first place. So it may be better from a security standpoint to simply
162 # disable DSA keys especially if $min_key_length and $rsakeylength have been set
163 # to something higher such as 3072 or 4096. This setting is only checked when
164 # new keys are added so setting it/increasing it will not affect existing keys.
165 # There is no way to disable DSA keys in the OpenSSH server config file itself.
166 # If this is set to 1, no ssh_host_dsa_key will be generated or used with the
167 # sshd running in the jail (but if the sshd_config has already been generated
168 # in the jail, it must be removed and 'sudo make install' run again or otherwise
169 # the sshd_config needs to be edited by hand for the change to take effect).
170 # RECOMMENDED VALUE: 1
171 our $disable_dsa = 0;
173 # Enable the special 'mob' user if set to 'mob'
174 our $mob = "mob";
176 # Let users set admin passwords; if false, all password inputs are assumed empty.
177 # This will make new projects use empty passwords and all operations on them
178 # unrestricted, but you will be able to do no operations on previously created
179 # projects you have set a password on.
180 our $project_passwords = 1;
182 # How to determine project owner; 'email' adds a form item asking for their
183 # email contact, 'source' takes realname of owner of source repository if it
184 # is a local path (and empty string otherwise). 'source' is suitable in case
185 # the site operates only as mirror of purely local-filesystem repositories.
186 our $project_owners = 'email';
188 # Which project fields to make editable, out of 'shortdesc', 'homepage',
189 # 'README', 'notifymail', 'notifyjson', 'notifycia'. (This is currently
190 # soft restriction - form fields aren't used, but manually injected values
191 # *are* used. Submit a patch if that's an issue for you.)
192 our @project_fields = qw(homepage shortdesc README notifymail notifyjson notifycia);
194 # Minimal number of seconds to pass between two updates of a project.
195 our $min_mirror_interval = 3600; # 1 hour
197 # Minimal number of seconds to pass between two garbage collections of a project.
198 our $min_gc_interval = 604800; # 1 week
200 # Whether or not to run the ../bin/update-pwd-db script whenever the etc/passwd
201 # database is changed. This is typically needed (i.e. set to a true value) for
202 # FreeBSD style systems when using an sshd chroot jail for push access. So if
203 # $pushurl is undef or the system Girocco is running on is not like FreeBSD
204 # (e.g. a master.passwd file that must be transformed into pwd.db and spwd.db), then
205 # this setting should normally be left false (i.e. 0). See comments in the
206 # provided ../bin/update-pwd-db script about when and how it's invoked.
207 our $update_pwd_db = 0;
209 # Port the sshd running in the jail should listen on
210 # Be sure to update $pushurl to match
211 # Not used if $pushurl is undef
212 our $sshd_jail_port = 22;
214 # If this is true then host names used in mirror source URLs will be checked
215 # and any that are not DNS names (i.e. IPv4 or IPv6) or match one of the DNS
216 # host names in any of the URL settings below will be rejected.
217 our $restrict_mirror_hosts = 1;
219 # If $restrict_mirror_hosts is enabled this is the minimum number of labels
220 # required in a valid dns name. Normally 2 is the correct value, but if
221 # Girocco is being used internally where a common default or search domain
222 # is set for everyone then this should be changed to 1 to allow a dns name
223 # with a single label in it. No matter what is set here at least 1 label
224 # is always required when $restrict_mirror_hosts is enabled.
225 our $min_dns_labels = 2;
228 ## Foreign VCS mirrors
230 # Note that if any of these settings are changed from true to false, then
231 # any pre-existing mirrors using the now-disabled foreign VCS will stop
232 # updating, new mirrors using the now-disabled foreign VCS will be disallowed
233 # and attempts to update ANY project settings for a pre-existing project that
234 # uses a now-disabled foreign VCS source URL will also be disallowed.
236 # If $mirror is true and $mirror_svn is true then mirrors from svn source
237 # repositories will be allowed (and be converted to Git). These URLs have
238 # the form svn://... or svn+http://... or svn+https://...
239 # Note that for this to work the "svn" command line command must be available
240 # in PATH and the "git svn" commands must work (which generally requires both
241 # Perl and the subversion perl bindings be installed).
242 our $mirror_svn = 1;
244 # If $mirror is true and $mirror_darcs is true then mirrors from darcs source
245 # repositories will be allowed (and be converted to Git). These URLs have
246 # the form darcs://...
247 # Note that for this to work the "darcs" command line command must be available
248 # in PATH and so must python (required to run the darcs-fast-export script).
249 our $mirror_darcs = 1;
251 # If $mirror is true and $mirror_bzr is true then mirrors from bzr source
252 # repositories will be allowed (and be converted to Git). These URLs have
253 # the form bzr://...
254 # Note that for this to work the "bzr" command line command must be available
255 # in PATH (it's a python script so python is required as well).
256 our $mirror_bzr = 1;
258 # If $mirror is true and $mirror_hg is true then mirrors from hg source
259 # repositories will be allowed (and be converted to Git). These URLs have
260 # the form hg+http://... or hg+https://...
261 # Note that for this to work the "hg" command line command must be available
262 # in PATH and so must python (required to run the hg-fast-export.py script).
263 # Note that if the PYTHON environment variable is set that will be used instead
264 # of just plain "python" to run the hg-fast-export.py script (which needs to
265 # be able to import from mercurial).
266 our $mirror_hg = 1;
269 ## Paths
271 # Path where the main chunk of Girocco files will be installed
272 # This will get COMPLETELY OVERWRITTEN by each make install!!!
273 our $basedir = '/home/repo/repomgr';
275 # Path where the automatically generated non-user certificates will be stored
276 # (The per-user certificates are always stored in $chroot/etc/sshcerts/)
277 # This is preserved by each make install and MUST NOT be under $basedir!
278 # Not used unless $httpspushurl is defined
279 our $certsdir = '/home/repo/certs';
281 # The repository collection
282 # "$reporoot-recyclebin" will also be created for use by toolbox/trash-project.pl
283 our $reporoot = "/srv/git";
285 # The repository collection's location within the chroot jail
286 # Normally $reporoot will be bind mounted onto $chroot/$jailreporoot
287 # Should NOT start with '/'
288 our $jailreporoot = "srv/git";
290 # The chroot for ssh pushing; location for project database and other run-time
291 # data even in non-chroot setups
292 our $chroot = "/home/repo/j";
294 # The gitweb files web directory (corresponds to $gitwebfiles)
295 # Note that it is safe to place this under $basedir since it's set up after
296 # $basedir is completely replaced during install time. Be WARNED, however,
297 # that normally the install process only adds/replaces things in $webroot,
298 # but if $webroot is under $basedir then it will be completely removed and
299 # rebuilt each time "make install" is run. This will make gitweb/git-browser
300 # web services very briefly unavailable while this is happening.
301 our $webroot = "/home/repo/WWW";
303 # The CGI-enabled web directory (corresponds to $gitweburl and $webadmurl)
304 our $cgiroot = "/home/repo/WWW";
306 # A web-accessible symlink to $reporoot (corresponds to $httppullurl, can be undef)
307 # If using the sample apache.conf (with paths suitably updated) this is not required
308 # to serve either smart or non-smart HTTP repositories to the Git client
309 our $webreporoot = "/home/repo/WWW/r";
312 ## Certificates (only used if $httpspushurl is defined)
314 # path to root certificate (undef to use automatic root cert)
315 # this certificate is made available for easy download and should be whatever
316 # the root certificate is for the https certificate being used by the web server
317 our $rootcert = undef;
319 # The certificate to sign user push client authentication certificates with (undef for auto)
320 # The automatically generated certificate should always be fine
321 our $clientcert = undef;
323 # The private key for $clientcert (undef for auto)
324 # The automatically generated key should always be fine
325 our $clientkey = undef;
327 # The client certificate chain suffix (a pemseq file to append to user client certs) (undef for auto)
328 # The automatically generated chain should always be fine
329 # This suffix will also be appended to the $mobusercert before making it available for download
330 our $clientcertsuffix = undef;
332 # The mob user certificate signed by $clientcert (undef for auto)
333 # The automatically generated certificate should always be fine
334 # Not used unless $mob is set to 'mob'
335 # The $clientcertsuffix will be appended before making $mobusercert available for download
336 our $mobusercert = undef;
338 # The private key for $mobusercert (undef for auto)
339 # The automatically generated key should always be fine
340 # Not used unless $mob is set to 'mob'
341 our $mobuserkey = undef;
343 # Server alt names to embed in the auto-generated girocco_www_crt.pem certificate.
344 # The common name (CN) in the server certificate is the host name from $httpspushurl.
345 # By default no server alt names are embedded (not even the host from $httpspushurl).
346 # If the web server configuration is not using this auto-generated server certificate
347 # then the values set here will have no impact and this setting can be ignored.
348 # To embed server alternative names, list each (separated by spaces). The names
349 # may be DNS names, IPv4 addresses or IPv6 addresses (NO surrounding '[' ']' please).
350 # If ANY DNS names are included here be sure to also include the host name from
351 # the $httpspushurl or else standards-conforming clients will fail with a host name
352 # mismatch error when they attempt to verify the connection.
353 #our $wwwcertaltnames = 'example.com www.example.com git.example.com 127.0.0.1 ::1';
354 our $wwwcertaltnames = undef;
356 # The key length for automatically generated RSA private keys (in bits).
357 # These keys are then used to create the automatically generated certificates.
358 # If undef or set to a value less than 2048, then 2048 will be used.
359 # Set to 3072 to generate more secure keys/certificates. Set to 4096 (or higher) for
360 # even greater security. Be warned that setting to a non-multiple of 8 and/or greater
361 # than 4096 could negatively impact compatibility with some clients.
362 # The values 2048, 3072 and 4096 are expected to be compatible with all clients.
363 # Note that OpenSSL has no problem with > 4096 or non-multiple of 8 lengths.
364 # See also the $min_key_length setting above to restrict user key sizes.
365 # This value is also used when generating the ssh_host_rsa_key for the chroot jail sshd.
366 # RECOMMENDED VALUE: 3072
367 our $rsakeylength = undef;
370 ## URL addresses
372 # URL of the gitweb.cgi script (must be in pathinfo mode)
373 # If mod_rewrite is enabled and the sample apache.conf configuration is used
374 # (with paths suitably updated), the trailing "/w" is optional for all browsers
375 # that send a User-Agent string WITHOUT (case insensitively) "git/". Alternatively
376 # a minor change to the sample apache.conf can redirect (301 or 302) URLs without
377 # the "/w" to a URL with it where appropriate.
378 our $gitweburl = "http://repo.or.cz/w";
380 # URL of the extra gitweb files (CSS, .js files, images, ...)
381 our $gitwebfiles = "http://repo.or.cz";
383 # URL of the Girocco CGI web admin interface (Girocco cgi/ subdirectory)
384 our $webadmurl = "http://repo.or.cz";
386 # URL of the Girocco CGI html templater (Girocco cgi/html.cgi)
387 our $htmlurl = "http://repo.or.cz/h";
389 # HTTP URL of the repository collection (undef if N/A)
390 # If mod_rewrite is enabled and the sample apache.conf configuration is used
391 # (with paths suitably updated), the trailing "/r" is optional for Git clients
392 # that send a User-Agent string containing "git/" (case insensitively).
393 our $httppullurl = "http://repo.or.cz/r";
395 # HTTPS push URL of the repository collection (undef if N/A)
396 # If this is defined, the openssl command must be available
397 # The sample apache.conf configuration requires mod_rewrite be enabled to
398 # support https push operations.
399 # Normally this should be set to $httppullurl with http: replaced with https:
400 # If the sample apache.conf configuration is used (with paths suitably updated),
401 # the trailing "/r" is optional for Git clients that send a User-Agent string
402 # containing "git/" (case insensitively).
403 our $httpspushurl = undef;
405 # Git URL of the repository collection (undef if N/A)
406 # (You need to set up git-daemon on your system, and Girocco will not
407 # do this particular thing for you.)
408 our $gitpullurl = "git://repo.or.cz";
410 # Pushy SSH URL of the repository collection (undef if N/A)
411 # Note that the "/$jailreporoot" portion is optional and will be automatically
412 # added if appropriate when omitted by the client so this URL can typically
413 # be made the same as $gitpullurl with git: replaced with ssh:
414 our $pushurl = "ssh://repo.or.cz/$jailreporoot";
416 # URL of gitweb of this Girocco instance (set to undef if you're not nice
417 # to the community)
418 our $giroccourl = "$Girocco::Config::gitweburl/girocco.git";
421 ## Some templating settings
423 # Legal warning (on reguser and regproj pages)
424 our $legalese = <<EOT;
425 <p>By submitting this form, you are confirming that you will mirror or push
426 only what we can store and show to anyone else who can visit this site without
427 breaking any law, and that you will be nice to all small furry animals.
428 <sup><a href="/h/about.html">(more details)</a></sup>
429 </p>
432 # Pre-configured mirror sources (set to undef for none)
433 # Arrayref of name - record pairs, the record has these attributes:
434 # label: The label of this source
435 # url: The template URL; %1, %2, ... will be substituted for inputs
436 # desc: Optional VERY short description
437 # link: Optional URL to make the desc point at
438 # inputs: Arrayref of hashref input records:
439 # label: Label of input record
440 # suffix: Optional suffix
441 # If the inputs arrayref is undef, single URL input is shown,
442 # pre-filled with url (probably empty string).
443 our $mirror_sources = [
445 label => 'Anywhere',
446 url => '',
447 desc => 'Any HTTP/Git/rsync pull URL - bring it on!',
448 inputs => undef
451 label => 'GitHub',
452 url => 'git://github.com/%1/%2.git',
453 desc => 'GitHub Social Code Hosting',
454 link => 'http://github.com/',
455 inputs => [ { label => 'User:' }, { label => 'Project:', suffix => '.git' } ]
458 label => 'Gitorious',
459 url => 'git://gitorious.org/%1/%2.git',
460 desc => 'Green and Orange Boxes',
461 link => 'http://gitorious.org/',
462 inputs => [ { label => 'Project:' }, { label => 'Repository:', suffix => '.git' } ]
466 # You can customize the gitweb interface widely by editing
467 # gitweb/gitweb_config.perl
470 ## Permission settings
472 # Girocco needs some way to manipulate write permissions to various parts of
473 # all repositories; this concerns three entities:
474 # - www-data: the web interface needs to be able to rewrite few files within
475 # the repository
476 # - repo: a user designated for cronjobs; handles mirroring and repacking;
477 # this one is optional if not $mirror
478 # - others: the designated users that are supposed to be able to push; they
479 # may have account either within chroot, or outside of it
481 # There are several ways how to use Girocco based on a combination of the
482 # following settings.
484 # (Non-chroot) UNIX user the CGI scripts run on; note that if some non-related
485 # untrusted CGI scripts run on this account too, that can be a big security
486 # problem and you'll probably need to set up suexec (poor you).
487 # This must always be set.
488 our $cgi_user = 'www-data';
490 # (Non-chroot) UNIX user performing mirroring jobs; this is the user who
491 # should run all the daemons and cronjobs and
492 # the user who should be running make install (if not root).
493 # This must always be set.
494 our $mirror_user = 'repo';
496 # (Non-chroot) UNIX group owning the repositories by default; it owns whole
497 # mirror repositories and at least web-writable metadata of push repositories.
498 # If you undefine this, all the data will become WORLD-WRITABLE.
499 # Both $cgi_user and $mirror_user should be members of this group!
500 our $owning_group = 'repo';
502 # Whether to use chroot jail for pushing; this must be always the same
503 # as $manage_users.
504 # TODO: Gitosis support for $manage_users and not $chrooted?
505 our $chrooted = $manage_users;
507 # How to control permissions of push-writable data in push repositories:
508 # * 'Group' for the traditional model: The $chroot/etc/group project database
509 # file is used as the UNIX group(5) file; the directories have gid appropriate
510 # for the particular repository and are group-writable. This works only if
511 # $chrooted so that users are put in the proper groups on login when using
512 # SSH push. Smart HTTPS push does not require a chroot to work -- simply
513 # run "make install" as the non-root $mirror_user user, but leave
514 # $manage_users and $chrooted enabled.
515 # * 'ACL' for a model based on POSIX ACL: The directories are coupled with ACLs
516 # listing the users with push permissions. This works for both chroot and
517 # non-chroot setups, however it requires ACL support within the filesystem.
518 # This option is BASICALLY UNTESTED, too. And UNIMPLEMENTED. :-)
519 # * 'Hooks' for a relaxed model: The directories are world-writable and push
520 # permission control is purely hook-driven. This is INSECURE and works only
521 # when you trust all your users; on the other hand, the attack vectors are
522 # mostly just DoS or fully-traceable tinkering.
523 our $permission_control = 'Group';
525 # Path to alternate screen multiuser acl file (see screen/README, undef for none)
526 our $screen_acl_file = undef;
529 ## sendmail.pl configuration
531 # Full information on available sendmail.pl settings can be found by running
532 # ../bin/sendmail.pl -v -h
534 # These settings will only used if $sendmail_bin is set to 'sendmail.pl'
536 # sendmail.pl host name
537 #$ENV{'SENDMAIL_PL_HOST'} = 'localhost'; # localhost is the default
539 # sendmail.pl port name
540 #$ENV{'SENDMAIL_PL_PORT'} = '25'; # port 25 is the default
542 # sendmail.pl nc executable
543 #$ENV{'SENDMAIL_PL_NCBIN'} = "$chroot/bin/nc.openbsd"; # default is nc found in $PATH
545 # sendmail.pl nc options
546 # multiple options may be included, e.g. '-4 -X connect -x 192.168.100.10:8080'
547 #$ENV{'SENDMAIL_PL_NCOPT'} = '-4'; # force IPv4, default is to allow IPv4 & IPv6
550 ## Sanity checks & defaults
552 # Couple of sanity checks and default settings (do not change these)
553 use Digest::MD5 qw(md5);
554 use MIME::Base64 qw(encode_base64);
555 $nickname = (split(/[.]/, $name))[0] unless $nickname;
556 our $tmpsuffix = substr(encode_base64(md5($name.':'.$nickname)),0,6);
557 $tmpsuffix =~ tr,+/,=_,;
558 ($mirror_user) or die "Girocco::Config: \$mirror_user must be set even if to current user";
559 ($basedir) or die "Girocco::Config: \$basedir must be set";
560 ($sendmail_bin) or die "Girocco::Config: \$sendmail_bin must be set";
561 $sendmail_bin = "$basedir/bin/sendmail.pl" if $sendmail_bin eq "sendmail.pl";
562 $screen_acl_file = "$basedir/screen/giroccoacl" unless $screen_acl_file;
563 $jailreporoot =~ s,^/+,,;
564 ($reporoot) or die "Girocco::Config \$reporoot must be set";
565 ($jailreporoot) or die "Girocco::Config \$jailreporoot must be set";
566 (not $mob or $mob eq 'mob') or die "Girocco::Config \$mob must be undef (or '') or 'mob'";
567 (not $min_key_length or $min_key_length =~ /^[1-9][0-9]*$/)
568 or die "Girocco::Config \$min_key_length must be undef or numeric";
569 $admincc = $admincc ? 1 : 0;
570 $rootcert = "$certsdir/girocco_root_crt.pem" if $httpspushurl && !$rootcert;
571 $clientcert = "$certsdir/girocco_client_crt.pem" if $httpspushurl && !$clientcert;
572 $clientkey = "$certsdir/girocco_client_key.pem" if $httpspushurl && !$clientkey;
573 $clientcertsuffix = "$certsdir/girocco_client_suffix.pem" if $httpspushurl && !$clientcertsuffix;
574 $mobusercert = "$certsdir/girocco_mob_user_crt.pem" if $httpspushurl && $mob && !$mobusercert;
575 $mobuserkey = "$certsdir/girocco_mob_user_key.pem" if $httpspushurl && $mob && !$mobuserkey;
576 our $mobpushurl = $pushurl;
577 $mobpushurl =~ s,^ssh://,ssh://mob@,i if $mobpushurl;
578 $disable_dsa = 1 unless $pushurl;
579 $disable_dsa = $disable_dsa ? 1 : '';
580 our $httpdnsname = ($gitweburl =~ m,https?://([A-Za-z0-9.-]+),i) ? lc($1) : undef if $gitweburl;
581 our $httpsdnsname = ($httpspushurl =~ m,https://([A-Za-z0-9.-]+),i) ? lc($1) : undef if $httpspushurl;
582 ($mirror or $push) or die "Girocco::Config: neither \$mirror nor \$push is set?!";
583 (not $push or ($pushurl or $httpspushurl or $gitpullurl or $httppullurl)) or die "Girocco::Config: no pull URL is set";
584 (not $push or ($pushurl or $httpspushurl)) or die "Girocco::Config: \$push set but \$pushurl and \$httpspushurl are undef";
585 (not $mirror or $mirror_user) or die "Girocco::Config: \$mirror set but \$mirror_user is undef";
586 ($manage_users == $chrooted) or die "Girocco::Config: \$manage_users and \$chrooted must be set to the same value";
587 (not $chrooted or $permission_control ne 'ACL') or die "Girocco::Config: resolving uids for ACL not supported when using chroot";
588 (grep { $permission_control eq $_ } qw(Group Hooks)) or die "Girocco::Config: \$permission_control must be set to Group or Hooks";
589 ($chrooted or not $mob) or die "Girocco::Config: mob user supported only in the chrooted mode";
590 (not $httpspushurl or $httpsdnsname) or die "Girocco::Config invalid \$httpspushurl does not start with https://domainname";
592 # Make sure Git has a consistent and reproducible environment
594 $ENV{'XDG_CONFIG_HOME'} = $chroot.'/var/empty';
595 $ENV{'HOME'} = $chroot.'/etc/girocco';
596 $ENV{'GIT_CONFIG_NOSYSTEM'} = 1;
597 $ENV{'GIT_ATTR_NOSYSTEM'} = 1;
598 $ENV{'GIT_TERMINAL_PROMPT'} = 0;
599 $ENV{'GIT_ASKPASS'} = $basedir.'/bin/git-askpass-password';
600 delete $ENV{'GIT_USER_AGENT'};
601 $ENV{'GIT_USER_AGENT'} = $git_client_ua if defined($git_client_ua);
602 delete $ENV{'GIT_HTTP_USER_AGENT'};
603 $ENV{'GIT_HTTP_USER_AGENT'} = $git_client_ua if defined($git_client_ua);