CoSign Single Signon

CoSign SSO is a WordPress plugin that provides several alternative authentication methods to WordPress, and it maybe easily extend to support more SSO login methods. CoSign v2 and CoSign v3 are the first two Single Sign-on(SSO) addins, that whay this plugin named. The other login method is just a by-product which provides LDAP authentication.

When this plugin is enabled, and the login method is set to SSO, then using a external CoSign single sign-on login service. When user click login, browser will redirect to remote login url, and will redirect back after successful logged in. If set login method to LDAP, login with the familiar login screen, but authentication backend changed to LDAP.

Whether using SSO or LDAP login method, LDAP options must provided to fetch user account information. If the logged in user account does not exists, create it on the fly by default.

Settings

The settings for CoSign SSO are extremely simple. But before you change the login method to ‘SSO’ or ‘LDAP’, you mast check options for cosign and ldap carefully. Wrong configrations will ban all users including yourself!

If you cannot login any more, don’t blame me. A trick may help you:

$ touch <PLUGIN_DIR>/cosign-sso/FALLBACK

If the fallback file contains “ldap”, “cosign2”, or “cosign3”, it will fallback to the right login method.

After you correct the settings, not forgot to remove the FALLBACK file.

Notes for CoSign 3.x:

• CoSign 3.x filter needs to add a “/cosign/valid” location as cosign handler.
• If wordpress uses a permlink, which means the RewriteRule in .htaccess may conflict with the “/cosign/valid” handler.
• You can hack wp-includes/rewrite.php, add “RewriteRule ^cosign/valid – [L]” right after “RewriteBase” directive.

Localization

This section describes how to localized, which means let cosign-sso speak in your language.

• POT file : cosign-sso/languages/cosign_sso.pot
• Copy pot file to your locale, such as cosign-sso/languages/cosign_sso-zh_CN.pot for Chinese.
• Translate it using your favorate editor. lokalize and kbabel are recommended.
• Convert po to mo using command:

      $ cd plugins/cosign-sso/languages
      $ msgfmt cosign_sso-zh_CN.po -o cosign_sso-zh_CN.mo

Known Issues

No known issues at this time.

If you find any bugs or want to request some additional features for future releases, please log them on the wordpress project of homepage for our interest projects