This is the bridge between a Drupal installation and a Pydio. The aim is to provide a single-sign-on (SSO) mechanism based on
the Drupal users system : users logged in Drupal will have access to workspaces of Pydio.
It's never totally evident to interface two different softwares, so don't expect it to be magical, and please follow the steps carefully and in this order.
First of
all, make sure you have a Pydio recent version installed, and Drupal 6.x or
7.x
Unpack the
Drupal user.pydio.zip inside the [drupal 6]"sites/all/modules/"
or [drupal 7]"modules/" folder of your Drupal installation.
2.1 Administrator & guest
If it's not already done, with the standard pydio authentication mechanism, be sure that at least an "admin" user is created.
If you intend to allow guest browsing, set the "Allow Guest Browsing" option to true in the Pydio Settings > Global Options > Core Options > Authentication, and if you are logged, log out. This should create the "guest" user. As admin, log back to the interface and create a "Guest" Repository. Go to the users section and grant access (read only may be better) to this repository to the "guest" user. Now, when you log out, you should have access to this repository.
2.3 Workspaces
Now create one or many workspaces that you will want your Drupal logged users to access. You can use the AJXP_USER keyword inside the repository PATH if you want to create automatically "personal" folders for each users. Considering the acces rights, the trick here would be to set a "Default Right" value to "rw", so that you don't have to manually edit the users rights each time you add them.
2.4 Auth.remote configuration
Logged as admin, go to Settings > Global Options > Core Options > Authentication, and set the
Authentication "Main Instance" driver to be the "Remote Authentication" ( = auth.remote plugin) :
Other options should be left to default values, otherwise put your mouse on the options label to get more info. For the secret key, warning, if you want to use a "$" sign in your key, you have to put a \ before.
Also make sure NOT to set a secondary instance, this plugin does not support multi-auth configuration yet.
3.1 Activate Module
Login to Drupal as administrator and go to [6]"Administer > Site Building > Modules" or [7]"Modules". Here you can select the "Pydio Bridge" module under the "Other" section. Enable the plugin.
3.2 Configure the module
Go to "Site Configuration > Pydio Settings" (click on the module "Help" for v7). There are three parameters to configure for this plugin :
Pydio Install Path : here you have to enter the full path to the Pydio installation. "Full path" in the sense of the server filesystem. On Windows, it could be C:/Programs/ApacheData/html/pydio, or Linux more probably /var/www/html/Pydio. In any cases, use "slashes" and not backslashes, and take care that names are case sensitive.
Secret Key : here you'll have to enter the "SECRET" you entered in the Pydio authentication configuration. Warning, if they differ, it will (silently) not work.
Auto Create Users : This option is useful specially if you are installing this "bridge" when already managing many users in a Drupal installation. By default ("no"), Users will be created in Pydio only by a Drupal administrator action of creating a Drupal users. Existing users will not be recognized by Pydio. If you set to "Auto create", existing users will be automatically created when a user logs in to Drupal.
Save the module configuration.
Now everything should be connected, and you can try the following : create an Administrator user and a simple user in Drupal. Log in to Drupal as these user and check that you are recognized in Pydio, and further more, that the administrator has Pydio administration rights. If you want to enable the guest mechanism in Pydio, log out from Drupal and check that you are recognized as "guest" in Pydio.
If you have not enabled the automatic redirection, check that you can log in from Pydio using drupal users's credenatials. This is important to check, as it will allow the mobile devices to connect successfully as well.