Differences

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

Link to this comparison view

documentation:latest:applications:bugzilla [2016/07/19 12:10] (current)
Line 1: Line 1:
 +====== Bugzilla ======
 +
 +{{ :​applications:​bugzilla_logo.png |}}
 +
 +===== Presentation =====
 +
 +[[http://​www.bugzilla.org|Bugzilla]] is server software designed to help you manage software development.
 +
 +Bugzilla can authenticate a user with HTTP headers, and auto-create its account with a few information:​
 +  * User ID
 +  * Email
 +  * Real name
 +
 +===== Configuration =====
 +
 +==== Bugzilla administration ====
 +
 +In Bugzilla administration interface, go in ''​Parameters''​ » ''​User authentication''​
 +
 +Then set:
 +  * **auth_env_id**:​ HTTP_AUTH_USER
 +  * **auth_env_email**:​ HTTP_AUTH_MAIL
 +  * **auth_env_realname**:​ HTTP_AUTH_CN
 +  * **user_info_class**:​ Env or Env,CGI
 +
 +==== Bugzilla virtual host ====
 +
 +Configure Bugzilla virtual host like other [[..configvhost|protected virtual host]].
 +
 +  * For Apache:
 +<file apache>
 +<​VirtualHost *:80>
 +       ​ServerName bugzilla.example.com
 +
 +       ​PerlHeaderParserHandler Lemonldap::​NG::​Handler
 +
 +       ...
 +       
 +</​VirtualHost>​
 +</​file>​
 +
 +  * For Nginx:
 +<file nginx>
 +server {
 +  listen 80;
 +  server_name bugzilla.example.com;​
 +  root /​path/​to/​application;​
 +  # Internal authentication request
 +  location = /lmauth {
 +    internal;
 +    include /​etc/​nginx/​fastcgi_params;​
 +    fastcgi_pass unix:/​var/​run/​llng-fastcgi-server/​llng-fastcgi.sock;​
 +    # Drop post datas
 +    fastcgi_pass_request_body ​ off;
 +    fastcgi_param CONTENT_LENGTH "";​
 +    # Keep original hostname
 +    fastcgi_param HOST $http_host;
 +    # Keep original request (LLNG server will received /llauth)
 +    fastcgi_param X_ORIGINAL_URI ​ $request_uri;​
 +  } 
 + 
 +  # Client requests
 +  location / {
 +    auth_request /lmauth;
 +    auth_request_set $lmremote_user $upstream_http_lm_remote_user;​
 +    auth_request_set $lmlocation $upstream_http_location;​
 +    error_page 401 $lmlocation;​
 +    try_files $uri $uri/ =404;
 + 
 +    ...
 + 
 +    include /​etc/​lemonldap-ng/​nginx-lua-headers.conf;​
 +  }
 +  location / {
 +    try_files $uri $uri/ =404;
 +  }
 +}
 +</​file>​
 +==== Bugzilla virtual host in Manager ====
 +
 +Go to the Manager and [[..configvhost#​lemonldapng_configuration|create a new virtual host]] for Bugzilla.
 +
 +Configure the [[..writingrulesand_headers#​rules|access rules]].
 +
 +Configure the following [[..writingrulesand_headers#​headers|headers]].
 +  * **Auth-User**:​ $uid
 +  * **Auth-Mail**:​ $mail
 +  * **Auth-Cn**:​ $cn