Changes between Initial Version and Version 1 of Bookmarks Project/Authentication


Ignore:
Timestamp:
02/18/16 21:11:48 (8 years ago)
Author:
peter
Comment:

documented the authentication setup as of [114/bookmarks]

Legend:

Unmodified
Added
Removed
Modified

  • Bookmarks Project/Authentication

    v1 v1  
     1= BookmarksProject: Authentication = 
     2 
     3You can configure authentication for all non-GET requests by adding the following to your `server.yml` config file: 
     4{{{ 
     5auth: 1 
     6htdigest: /path/to/htdigest/file 
     7# default realm is "Bookmarks"; uncomment and change if you want to use something different 
     8#realm: Bookmarks 
     9digest_key: secret 
     10}}} 
     11 
     12Replace the `digest_key` "secret" with an appropriately random string. This is the secret that is used to generate the digest nonce; see [perldoc:Plack::Middleware::Auth::Digest] for more info. 
     13 
     14The `htdigest` file can be created using the `htdigest` utility: 
     15 
     16{{{ 
     17$ htdigest -c /path/to/htdigest/file Bookmarks user 
     18}}} 
     19 
     20The `htdigest` utility comes with the Apache webserver, or in the `apache2-utils` package if you don't have the full Apache and don't want to install it. The realm you use in the digest file ''must'' match the `realm` configuration setting ("Bookmarks" by default). See the [https://httpd.apache.org/docs/2.2/programs/htdigest.html Apache docs] for more info.