1. Bilal Akhtar
  2. moin-2.0-gci

Commits

Sam Toyer  committed 218bd23

Add example Apache configuration and extend GivenAuth documentation

  • Participants
  • Parent commits 358f094
  • Branches default

Comments (0)

Files changed (3)

File docs/admin/configure.rst

View file
 username (like with german umlauts or accented characters). If moin does not
 crash (log a Unicode Error), you have likely found the correct coding.
 
+For users configuring GivenAuth on Apache, an example virtual host configuration
+file is included with MoinMoin in `docs/examples/deployment/moin.conf`.
+
 OpenID
 ------
 With OpenID moin can re-use the authentication done by some OpenID provider

File docs/admin/serve.rst

View file
 proceed with the MoinMoin app and its configuration.
 Otherwise, read your web server error log files.
 
+Apache users may wish to look at the example virtual host configuration file in `docs/examples/deployment/moin.conf`.

File docs/examples/deployment/moin.conf

View file
+# vim: ts=4 filetype=apache
+
+## Sample vhost config file for Apache 2 and MoinMoin
+## Add `Include /path/to/this/file` in your Apache httpd.conf activate
+## this configuration, and remember to install mod_wsgi and start Apache
+## with "-D WSGI"
+## For more information on mod_wsgi configuration directives, see
+## https://code.google.com/p/modwsgi/wiki/ConfigurationDirectives
+
+## Listen to port 80 on all IPs
+## You will probably want to replace * with your server name
+<VirtualHost *:80>
+    ## Replace with the name of your server (eg. localhost or my.domain.tld)
+    ServerName myservername
+
+    ## Note that python-path is required when deploying using virtualenv so
+    ## that the interpreter can find the necessary Python packages installed
+    ## with MoinMoin. You will probably want to refer to the mod_wsgi reference
+    ## documentation for help with this configuration directive, as it includes
+    ## too many useful  parameters to list here.
+    WSGIDaemonProcess moinmoin-wsgi user=myuser group=mygroup \
+        python-path=/path/to/moin/moin/virtualenv/python/interpreters/site-packages
+    ## The wiki will be accessible from myservername:80/wiki/root/url/ now
+    WSGIScriptAlias /wiki/root/url/ /path/to/moin/moin/install/moinmoin.wsgi
+    ## Uncomment the following line to let WSGI applications use HTTP
+    ## authentication methods
+    # WSGIPassAuthorization On
+
+    <Directory /home/sam/Programming/MoinMoin/moin-2.0>
+        ## Uncomment the following line for HTTP basic auth
+        ## Works with MoinMoin's GivenAuth authentication backend
+        ## See https://httpd.apache.org/docs/2.0/howto/auth.html for more
+        ## information on Apache authentication
+        # AuthType Basic
+        ## Authname is the message that the browser will display when asking
+        ## for username and password
+        # AuthName "MoinMoin requires user credentials"
+        ## AuthUserFile contains usernames and passwords for wiki users
+        ## and can be generated using the htpasswd utility included with
+        ## Apache
+        # AuthUserFile /home/sam/Programming/MoinMoin/moin-2.0/passwords
+        ## valid-user means that the supplied username must be in AuthUserFile
+        ## and the supplied password must match the entry for the user in
+        ## AuthUserFile
+        # Require valid-user
+        ## Name of the WSGI processes
+        WSGIProcessGroup moinmoin-wsgi
+        ## All WSGI applications in group %{GLOBAL} are run under the
+        ## same interpreter for compatibility with the Global Interpreter
+        ## Lock when using some C extensions
+        WSGIApplicationGroup %{GLOBAL}
+        Order deny,allow
+        Allow from all
+    </Directory>
+</VirtualHost>
+