This is an old revision of the document!

Authentication integration

Verifying FileRun user's credentials against a third-party system requires no PHP programming knowledge. You can simply activate and configure a plugin directly from FileRun's control panel (under “System configuration” » “User login and registration”).

Official/supported authentication plugins are included for:

  • LDAP/Active Directory
  • OAuth2 / Microsoft Azure OAuth2
  • SimpleSAMLphp, for SAML, Shibboleth, Active Directory Federation Services (ADFS), etc.
  • WordPress (v4)
  • Joomla (v3)
  • Drupal (v7)
  • Laravel (v5)
  • CMS Made Simple (v1 - FEU)
  • HumHub (v1b)
  • ModX (v2)
  • Generic SQL. This plugin uses PHP's PDO extension which supports MySQL, PostgreSQL, SQLite, MS SQL, Oracle, IBM, etc. It includes an example configuration for a WordPress site.

Before you enable a plugin, use the “Test settings” button to make sure the plugin is configured properly. In case you enabled a plugin with invalid configuration, or the third-party system stops working, you will still be able to login with the FileRun superuser login (with the password last stored in FileRun's own database).

Single-sign-on (SSO)

The authentication plugins for the CMS systems support single-sign-on, so that users authenticated in your site, are not required to type in their usernames and passwords again, for accessing FileRun. For this to work, after the users logged into your site, you need to redirect them to “http://your-site.com/filerun/sso” (note the “/sso” ending). If you direct them to the FileRun root URL, they will be prompted by the login form.