[Zope3-dev] HEADS UP: PAU (pluggable authentication) users

[Garrett Smith]

Later today I'm going to checkin a major refactor of the pluggable
authentication utility. The change greatly simplifies the end-user
experience of configuring the PAU and will make custom plugins easier to
write.

The bad news: 

 *your existing PAUs will need to be manually converted via the ZMI*

I've provided instructions below.

When you update to the head your PAU will no longer work. You will be
able to unregister and delete it. You will also be able to copy existing
principals and groups into the new PAU. See below for details.

This only applies to trunk users as the PAU has not officially been
released.

I'll create a tag named BEFORE_PAU_REFACTOR before committing any
changes.

 -- Garrett


Instructions for Converting an Existing PAU
-------------------------------------------
Perform these steps *after* you've updated to a trunk revision
containing the PAU refactor.

- Rename your existing PAU (this is optional if you want to use the
existing name for the new PAU)

- Add and register a new PAU

To convert an existing principal folder:

- Click the new PAU's plugins tab and add/register a Principal Folder.
Use the same prefix as that of the existing principal folder.

- Select the new principal folder as an Authentication Plugin on the
PAU's 'Configure' tab. (Be sure to click Change at the bottom of the
form to save the change.)

- Copy the contents of the existing principal folder into the new
principal folder

Repeat these steps or any group folders.

- Unregister and delete the old PAU and any old principal/group folders