Shibboleth Developers

Title: LISTPROC authz cookbook

here are some notes.... based on  exploring this  application

If you try  this, and discover errors, please post, we can maintain a pseudo-manual describing how  to do this.....

1) LISTPROC is a mailing list manager. In that sense, it predates the web. List managers and  subscribers would  use email to communicate  with it. Everything "inside" LISTPROC is based on email addresses.

2) The web interface is an add-on. It allows  people  to "register" (ie create  a user id and password to be used for web authentication,  and link them to an email address). >From the main web page, you can  click on a link to a registration page, to create your userid. This process sends email to the specified email address; the registration process  doesn't complete until LISTPROC gets a reply to its email.

3) the LISTPROC  web interface is available at http://shib1.internet2.edu:8000/.

4) To find or use any of the LISTPROC related files  on shib1, its probably best to switch to the listproc userid --> sudo su - listproc.

5) Interesting files:

The apache config file is available at  /home/listproc/lp-web/apache/conf/httpd.conf.

the  LISTPROC  config file  is at  /home/listproc/config This file contains the password  for the listmgr id.

command  line utilities can be  found at /home/listproc/lp-web/utils (eg add_web_user, list_users, etc)

the htaccess file used to control  access by "registered users" is  found in /home/listproc/lp-web/reguser

6) the test  list is called shib-lptest(@shib1.internet2.edu)

COOKBOOK FOR GAINING ACCESS TO THE LIST

1) subscribe to the list

        - go to http://shib1.internet2.edu:8000/;  click "Registerd User" access

        - login as "; password in config file mentioned above

        - click the OWNER checkbox, and click "Show Selected  Lists"

        - the screen will refresh,  hopefully with "There is one list for which you are an owner " and SHIB_LPTEST just below the buttons. Click SHIB-LPTEST.

        - you'll see a list of utilities. Click Manage Subscriptions.

        - look near the bottom of the form for the text "Select the action that you wish to perform (click here to add users):" click on HERE.

        - sign  someone up for the list.

2) link an authn identity to the email address (which was just subscribed). This can donein a couple of ways:

        - go to http://shib1.internet2.edu:8000/;  click "Register for a full account " (and follow thru the process described above)

        - or, ssh to shib1, sudo su - listproc, cd lp-web/utils, and type

                add_web_user identity password email_address

                type list_users  to see the results.....

You should now be able to go to the  main web address and authenticate (using either basic auth, or Shib.... depending on what's currently in the htaccess file)

--