EveSSO Plugin for DokuWiki

DokuWiki authentication via eve online SSO and access control for corporations/alliances/factions

EveSSO on DokuWiki.org

Installation

Search and install the plugin using the Plugin Manager. Refer to Plugins on how to install plugins manually.

Updating

Updating from version 2021-11-02 or earlier

EVESSO change the way eve groups are named.
They used to be:

• eve-corp-corporation_name
• eve-alliance-alliance_name
• eve-faction-faction_name
• Group names had space replaced by underscore and dot replaced with hyphen-minus

Now they're:

• (corporation)corporation_name
• (alliance)alliance_name
• (faction)faction_name
• Names are identical to in-game names

Configuration

Required Steps

1. Open the wiki in your browser
2. Login on a admin account
3. Go to admin > Configuration Settings
4. Go to Authentication > authtype and select EVESSO
5. Go to the Evesso section and enter your data from your eve online developer app
   • callback (Callback URL)
   • eveonline-key (Client ID)
   • eveonline-secret (Secret Key)
   • ⚠️ Do not change singleService (That will lock you out of the wiki)
6. Save the settings

Disable registration with email (Optional)

1. Open the wiki in your browser
2. Login on a admin account
3. Check Evesso > register-on-auth
4. Go to Authenticatio > disableactions
5. Check Register
6. Save the settings

Disable login with email (Optional)

⚠️
This have the potential to permantly lock you out of the wiki.
It is a good idea backup the wiki before you continue.

1. Open the wiki in your browser
2. Logout (if you're currently logged in)
3. Login via EveSSO on the character you want to be admin
4. Logout
5. Login on a admin account
6. Go to Admin > User Manager
7. Click the eve character you want for the admin account
8. Add the group admin and click Save Changes
9. Logout and login with your EveSSO admin account
10. Go to Admin > Configuration Settings
11. go to Evesso > singleService and select EVESSO (user menu) or EVESSO (login page) ⚠️
    This step can lock you out of the wiki. Make sure you're logged in on a EveSSO admin account and have a up-to-date backup of the wiki before you continue
12. Save settings

Access Control

All EVESSO users will have both the user and eveonline group. The will also have auth groups for their corporation, alliance (if in alliance), and faction (if in faction warfare):

• (corporation)corporation_name
• (alliance)alliance_name
• (faction)faction_name

You can change the access control for each auth group in admin > Access Control List Management

⚠️ Do not create your own auth groups starting with those prefixes when using this plugin. They will be deleted when the user login. ⚠️ ACL will allow access if any of the users group allow access

License

GNU General Public License v2

Original code from OAuth and PHPoAuthLib