The Great Services Refactor (#594)

* Hooks registration, discovery and retrieval module

Will discover @hooks.register decorated functions inside
the auth_hooks module in any installed django app.

* Class to register modular service apps

* Register service modules URLs

* Example service module

* Refactor services into modules

Each service type has been split out into its own django app/module. A
hook mechanism is provided to register a subclass of the ServiceHook
class. The modules then overload functions defined in ServiceHook as
required to provide interoperability with alliance auth. Service modules
provide their own urls and views for user registration and account
management and a partial template to display on the services page. Where
possible, new modules should provide their own models for local data
storage.

* Added menu items hooks and template tags

* Added menu item hook for broadcasts

* Added str method to ServicesHook

* Added exception handling to hook iterators

* Refactor mumble migration and table name

Upgrading will require `migrate mumble --fake-initial` to be run first
and then `migrate mumble` to rename the table.

* Refactor teamspeak3 migration and rename table

Upgrading will require `migrate teamspeak3 --fake-initial`

* Added module models and migrations for refactoring AuthServicesInfo

* Migrate AuthServiceInfo fields to service modules models

* Added helper for getting a users main character

* Added new style celery instance

* Changed Discord from AuthServicesInfo to DiscordUser model

* Switch celery tasks to staticmethods

* Changed Discourse from AuthServicesInfo to DiscourseUser model

* Changed IPBoard from AuthServicesInfo to IpboardUser model

* Changed Ips4 from AuthServicesInfo to Ips4User model

Also added disable service task.

This service still needs some love though. Was always missing a
deactivate services hook (before refactoring) for reasons I'm unsure of
so I'm reluctant to add it without knowing why.

* Changed Market from AuthServicesInfo to MarketUser model

* Changed Mumble from AuthServicesInfo to MumbleUser model

Switched user foreign key to one to one relationship.
Removed implicit password change on user exists.
Combined regular and blue user creation.

* Changed Openfire from AuthServicesInfo to OpenfireUser model

* Changed SMF from AuthServicesInfo to SmfUser model

Added disable task

* Changed Phpbb3 from AuthServicesInfo to Phpbb3User model

* Changed XenForo from AuthServicesInfo to XenforoUser model

* Changed Teamspeak3 from AuthServicesInfo to Teamspeak3User model

* Remove obsolete manager functions

* Standardise URL format

This will break some callback URLs
Discord changes from /discord_callback/ to /discord/callback/

* Removed unnecessary imports

* Mirror upstream decorator change

* Setup for unit testing

* Unit tests for discord service

* Added add main character helper

* Added Discourse unit tests

* Added Ipboard unit tests

* Added Ips4 unit tests

* Fix naming of market manager, switch to use class methods

* Remove unused hook functions

* Added market service unit tests

* Added corp ticker to add main character helper

* Added mumble unit tests

* Fix url name and remove namespace

* Fix missing return and add missing URL

* Added openfire unit tests

* Added missing return

* Added phpbb3 unit tests

* Fix SmfManager naming inconsistency and switch to classmethods

* Added smf unit tests

* Remove unused functions, Added missing return

* Added xenforo unit tests

* Added missing return

* Fixed reference to old model

* Fixed error preventing groups from syncing on reset request

* Added teamspeak3 unit tests

* Added nose as test runner and some test settings

* Added package requirements for running tests

* Added unit tests for services signals and tasks

* Remove unused tests file

* Fix teamspeak3 service signals

* Added unit tests for teamspeak3 signals

Changed other unit tests setUp to inert signals

* Fix password gen and hashing python3 compatibility

Fixes #630

Adds unit tests to check the password functions run on both platforms.

* Fix unit test to not rely on checking url params

* Add Travis CI settings file

* Remove default blank values from services models

* Added dynamic user model admin actions for syncing service groups

* Remove unused search fields

* Add hook function for syncing nicknames

* Added discord hook for sync nickname

* Added user admin model menu actions for sync nickname hook

* Remove obsolete code

* Rename celery config app to avoid package name clash

* Added new style celerybeat schedule configuration

periodic_task decorator is depreciated

* Added string representations

* Added admin pages for services user models

* Removed legacy code

* Move link discord button to correct template

* Remove blank default fields from example model

* Disallow empty django setting

* Fix typos

* Added coverage configuration file

* Add coverage and coveralls to travis config

Should probably use nose's built in coverage, but this works for now.

* Replace AuthServicesInfo get_or_create instances with get

Reflects upstream changes to AuthServicesInfo behaviour.

* Update mumble user table name

* Split out mumble authenticator requirements

zeroc-ice seems to cause long build times on travis-ci and isn't
required for the core projects functionality or testing.

services/modules/discourse/admin.py

@@ -0,0 +1,10 @@
+from __future__ import unicode_literals
+from django.contrib import admin
+from .models import DiscourseUser
+
+
+class DiscourseUserAdmin(admin.ModelAdmin):
+        list_display = ('user',)
+        search_fields = ('user__username',)
+
+admin.site.register(DiscourseUser, DiscourseUserAdmin)

services/modules/discourse/apps.py

@@ -0,0 +1,7 @@
+from __future__ import unicode_literals
+
+from django.apps import AppConfig
+
+
+class DiscourseServiceConfig(AppConfig):
+    name = 'discourse'

services/modules/discourse/auth_hooks.py

@@ -0,0 +1,57 @@
+from __future__ import unicode_literals
+
+from django.conf import settings
+from django.template.loader import render_to_string
+
+from services.hooks import ServicesHook
+from alliance_auth import hooks
+from eveonline.managers import EveManager
+
+from .urls import urlpatterns
+from .tasks import DiscourseTasks
+
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+class DiscourseService(ServicesHook):
+    def __init__(self):
+        ServicesHook.__init__(self)
+        self.urlpatterns = urlpatterns
+        self.name = 'discourse'
+        self.service_ctrl_template = 'registered/discourse_service_ctrl.html'
+
+    def delete_user(self, user, notify_user=False):
+        logger.debug('Deleting user %s %s account' % (user, self.name))
+        return DiscourseTasks.delete_user(user, notify_user=notify_user)
+
+    def update_groups(self, user):
+        logger.debug('Processing %s groups for %s' % (self.name, user))
+        if DiscourseTasks.has_account(user):
+            DiscourseTasks.update_groups.delay(user.pk)
+
+    def validate_user(self, user):
+        logger.debug('Validating user %s %s account' % (user, self.name))
+        if DiscourseTasks.has_account(user) and not self.service_active_for_user(user):
+            self.delete_user(user, notify_user=True)
+
+    def update_all_groups(self):
+        logger.debug('Update all %s groups called' % self.name)
+        DiscourseTasks.update_all_groups.delay()
+
+    def service_enabled_members(self):
+        return settings.ENABLE_AUTH_DISCOURSE or False
+
+    def service_enabled_blues(self):
+        return settings.ENABLE_BLUE_DISCOURSE or False
+
+    def render_services_ctrl(self, request):
+        return render_to_string(self.service_ctrl_template, {
+            'char': EveManager.get_main_character(request.user)
+        }, request=request)
+
+
+@hooks.register('services_hook')
+def register_service():
+    return DiscourseService()

services/modules/discourse/manager.py

@@ -0,0 +1,381 @@
+from __future__ import unicode_literals
+import logging
+import requests
+import random
+import string
+import datetime
+import json
+import re
+from django.conf import settings
+from django.utils import timezone
+from services.models import GroupCache
+
+logger = logging.getLogger(__name__)
+
+
+class DiscourseError(Exception):
+    def __init__(self, endpoint, errors):
+        self.endpoint = endpoint
+        self.errors = errors
+
+    def __str__(self):
+        return "API execution failed.\nErrors: %s\nEndpoint: %s" % (self.errors, self.endpoint)
+
+# not exhaustive, only the ones we need
+ENDPOINTS = {
+    'groups': {
+        'list': {
+            'path': "/admin/groups.json",
+            'method': requests.get,
+            'args': {
+                'required': [],
+                'optional': [],
+            },
+        },
+        'create': {
+            'path': "/admin/groups",
+            'method': requests.post,
+            'args': {
+                'required': ['name'],
+                'optional': ['visible'],
+            }
+        },
+        'add_user': {
+            'path': "/admin/groups/%s/members.json",
+            'method': requests.put,
+            'args': {
+                'required': ['usernames'],
+                'optional': [],
+            },
+        },
+        'remove_user': {
+            'path': "/admin/groups/%s/members.json",
+            'method': requests.delete,
+            'args': {
+                'required': ['username'],
+                'optional': [],
+            },
+        },
+        'delete': {
+            'path': "/admin/groups/%s.json",
+            'method': requests.delete,
+            'args': {
+                'required': [],
+                'optional': [],
+            },
+        },
+    },
+    'users': {
+        'create': {
+            'path': "/users",
+            'method': requests.post,
+            'args': {
+                'required': ['name', 'email', 'password', 'username'],
+                'optional': ['active'],
+            },
+        },
+        'update': {
+            'path': "/users/%s.json",
+            'method': requests.put,
+            'args': {
+                'required': ['params'],
+                'optional': [],
+            }
+        },
+        'get': {
+            'path': "/users/%s.json",
+            'method': requests.get,
+            'args': {
+                'required': [],
+                'optional': [],
+            },
+        },
+        'activate': {
+            'path': "/admin/users/%s/activate",
+            'method': requests.put,
+            'args': {
+                'required': [],
+                'optional': [],
+            },
+        },
+        'set_email': {
+            'path': "/users/%s/preferences/email",
+            'method': requests.put,
+            'args': {
+                'required': ['email'],
+                'optional': [],
+            },
+        },
+        'suspend': {
+            'path': "/admin/users/%s/suspend",
+            'method': requests.put,
+            'args': {
+                'required': ['duration', 'reason'],
+                'optional': [],
+            },
+        },
+        'unsuspend': {
+            'path': "/admin/users/%s/unsuspend",
+            'method': requests.put,
+            'args': {
+                'required': [],
+                'optional': [],
+            },
+        },
+        'logout': {
+            'path': "/admin/users/%s/log_out",
+            'method': requests.post,
+            'args': {
+                'required': [],
+                'optional': [],
+            },
+        },
+        'external': {
+            'path': "/users/by-external/%s.json",
+            'method': requests.get,
+            'args': {
+                'required': [],
+                'optional': [],
+            },
+        },
+    },
+}
+
+
+class DiscourseManager:
+    def __init__(self):
+        pass
+
+    GROUP_CACHE_MAX_AGE = datetime.timedelta(minutes=30)
+    REVOKED_EMAIL = 'revoked@' + settings.DOMAIN
+    SUSPEND_DAYS = 99999
+    SUSPEND_REASON = "Disabled by auth."
+
+    @staticmethod
+    def __exc(endpoint, *args, **kwargs):
+        params = {
+            'api_key': settings.DISCOURSE_API_KEY,
+            'api_username': settings.DISCOURSE_API_USERNAME,
+        }
+        silent = kwargs.pop('silent', False)
+        if args:
+            endpoint['parsed_url'] = endpoint['path'] % args
+        else:
+            endpoint['parsed_url'] = endpoint['path']
+        data = {}
+        for arg in endpoint['args']['required']:
+            data[arg] = kwargs[arg]
+        for arg in endpoint['args']['optional']:
+            if arg in kwargs:
+                data[arg] = kwargs[arg]
+        for arg in kwargs:
+            if arg not in endpoint['args']['required'] and arg not in endpoint['args']['optional'] and not silent:
+                logger.warn("Received unrecognized kwarg %s for endpoint %s" % (arg, endpoint))
+        r = endpoint['method'](settings.DISCOURSE_URL + endpoint['parsed_url'], params=params, json=data)
+        try:
+            if 'errors' in r.json() and not silent:
+                logger.error("Discourse execution failed.\nEndpoint: %s\nErrors: %s" % (endpoint, r.json()['errors']))
+                raise DiscourseError(endpoint, r.json()['errors'])
+            if 'success' in r.json():
+                if not r.json()['success'] and not silent:
+                    raise DiscourseError(endpoint, None)
+            out = r.json()
+        except ValueError:
+            out = r.text
+        finally:
+            try:
+                r.raise_for_status()
+            except requests.exceptions.HTTPError as e:
+                raise DiscourseError(endpoint, e.response.status_code)
+        return out
+
+    @staticmethod
+    def __generate_random_pass():
+        return ''.join([random.choice(string.ascii_letters + string.digits) for n in range(16)])
+
+    @staticmethod
+    def __get_groups():
+        endpoint = ENDPOINTS['groups']['list']
+        data = DiscourseManager.__exc(endpoint)
+        return [g for g in data if not g['automatic']]
+
+    @staticmethod
+    def __update_group_cache():
+        GroupCache.objects.filter(service="discourse").delete()
+        cache = GroupCache.objects.create(service="discourse")
+        cache.groups = json.dumps(DiscourseManager.__get_groups())
+        cache.save()
+        return cache
+
+    @staticmethod
+    def __get_group_cache():
+        if not GroupCache.objects.filter(service="discourse").exists():
+            DiscourseManager.__update_group_cache()
+        cache = GroupCache.objects.get(service="discourse")
+        age = timezone.now() - cache.created
+        if age > DiscourseManager.GROUP_CACHE_MAX_AGE:
+            logger.debug("Group cache has expired. Triggering update.")
+            cache = DiscourseManager.__update_group_cache()
+        return json.loads(cache.groups)
+
+    @staticmethod
+    def __create_group(name):
+        endpoint = ENDPOINTS['groups']['create']
+        DiscourseManager.__exc(endpoint, name=name[:20], visible=True)
+        DiscourseManager.__update_group_cache()
+
+    @staticmethod
+    def __group_name_to_id(name):
+        cache = DiscourseManager.__get_group_cache()
+        for g in cache:
+            if g['name'] == name[0:20]:
+                return g['id']
+        logger.debug("Group %s not found on Discourse. Creating" % name)
+        DiscourseManager.__create_group(name)
+        return DiscourseManager.__group_name_to_id(name)
+
+    @staticmethod
+    def __group_id_to_name(id):
+        cache = DiscourseManager.__get_group_cache()
+        for g in cache:
+            if g['id'] == id:
+                return g['name']
+        raise KeyError("Group ID %s not found on Discourse" % id)
+
+    @staticmethod
+    def __add_user_to_group(id, username):
+        endpoint = ENDPOINTS['groups']['add_user']
+        DiscourseManager.__exc(endpoint, id, usernames=[username])
+
+    @staticmethod
+    def __remove_user_from_group(id, username):
+        endpoint = ENDPOINTS['groups']['remove_user']
+        DiscourseManager.__exc(endpoint, id, username=username)
+
+    @staticmethod
+    def __generate_group_dict(names):
+        group_dict = {}
+        for name in names:
+            group_dict[name] = DiscourseManager.__group_name_to_id(name)
+        return group_dict
+
+    @staticmethod
+    def __get_user_groups(username):
+        data = DiscourseManager.__get_user(username)
+        return [g['id'] for g in data['user']['groups'] if not g['automatic']]
+
+    @staticmethod
+    def __user_name_to_id(name, silent=False):
+        data = DiscourseManager.__get_user(name, silent=silent)
+        return data['user']['id']
+
+    @staticmethod
+    def __user_id_to_name(id):
+        raise NotImplementedError
+
+    @staticmethod
+    def __get_user(username, silent=False):
+        endpoint = ENDPOINTS['users']['get']
+        return DiscourseManager.__exc(endpoint, username, silent=silent)
+
+    @staticmethod
+    def __activate_user(username):
+        endpoint = ENDPOINTS['users']['activate']
+        id = DiscourseManager.__user_name_to_id(username)
+        DiscourseManager.__exc(endpoint, id)
+
+    @staticmethod
+    def __update_user(username, **kwargs):
+        endpoint = ENDPOINTS['users']['update']
+        id = DiscourseManager.__user_name_to_id(username)
+        DiscourseManager.__exc(endpoint, id, params=kwargs)
+
+    @staticmethod
+    def __create_user(username, email, password):
+        endpoint = ENDPOINTS['users']['create']
+        DiscourseManager.__exc(endpoint, name=username, username=username, email=email, password=password, active=True)
+
+    @staticmethod
+    def __check_if_user_exists(username):
+        try:
+            DiscourseManager.__user_name_to_id(username, silent=True)
+            return True
+        except:
+            return False
+
+    @staticmethod
+    def __suspend_user(username):
+        id = DiscourseManager.__user_name_to_id(username)
+        endpoint = ENDPOINTS['users']['suspend']
+        return DiscourseManager.__exc(endpoint, id, duration=DiscourseManager.SUSPEND_DAYS,
+                                      reason=DiscourseManager.SUSPEND_REASON)
+
+    @staticmethod
+    def __unsuspend(username):
+        id = DiscourseManager.__user_name_to_id(username)
+        endpoint = ENDPOINTS['users']['unsuspend']
+        return DiscourseManager.__exc(endpoint, id)
+
+    @staticmethod
+    def __set_email(username, email):
+        endpoint = ENDPOINTS['users']['set_email']
+        return DiscourseManager.__exc(endpoint, username, email=email)
+
+    @staticmethod
+    def __logout(id):
+        endpoint = ENDPOINTS['users']['logout']
+        return DiscourseManager.__exc(endpoint, id)
+
+    @staticmethod
+    def __get_user_by_external(id):
+        endpoint = ENDPOINTS['users']['external']
+        return DiscourseManager.__exc(endpoint, id)
+
+    @staticmethod
+    def __user_id_by_external_id(id):
+        data = DiscourseManager.__get_user_by_external(id)
+        return data['user']['id']
+
+    @staticmethod
+    def _sanitize_username(username):
+        sanitized = username.replace(" ", "_")
+        sanitized = sanitized.strip(' _')
+        sanitized = sanitized.replace("'", "")
+        return sanitized
+
+    @staticmethod
+    def _sanitize_groupname(name):
+        name = name.strip(' _')
+        name = re.sub('[^\w]', '', name)
+        if len(name) < 3:
+            name = name + "".join('_' for i in range(3-len(name)))
+        return name[:20]
+
+    @staticmethod
+    def update_groups(user):
+        groups = []
+        for g in user.groups.all():
+            groups.append(DiscourseManager._sanitize_groupname(str(g)[:20]))
+        logger.debug("Updating discourse user %s groups to %s" % (user, groups))
+        group_dict = DiscourseManager.__generate_group_dict(groups)
+        inv_group_dict = {v: k for k, v in group_dict.items()}
+        username = DiscourseManager.__get_user_by_external(user.pk)['user']['username']
+        user_groups = DiscourseManager.__get_user_groups(username)
+        add_groups = [group_dict[x] for x in group_dict if not group_dict[x] in user_groups]
+        rem_groups = [x for x in user_groups if not x in inv_group_dict]
+        if add_groups or rem_groups:
+            logger.info(
+                "Updating discourse user %s groups: adding %s, removing %s" % (username, add_groups, rem_groups))
+            for g in add_groups:
+                DiscourseManager.__add_user_to_group(g, username)
+            for g in rem_groups:
+                DiscourseManager.__remove_user_from_group(g, username)
+
+    @staticmethod
+    def disable_user(user):
+        logger.debug("Disabling user %s Discourse access." % user)
+        d_user = DiscourseManager.__get_user_by_external(user.pk)
+        DiscourseManager.__logout(d_user['user']['id'])
+        DiscourseManager.__suspend_user(d_user['user']['username'])
+        logger.info("Disabled user %s Discourse access." % user)
+        return True

services/modules/discourse/migrations/0001_initial.py

@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*-
+# Generated by Django 1.10.2 on 2016-12-12 03:15
+from __future__ import unicode_literals
+
+from django.conf import settings
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('auth', '0008_alter_user_username_max_length'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='DiscourseUser',
+            fields=[
+                ('user', models.OneToOneField(on_delete=django.db.models.deletion.CASCADE, primary_key=True, related_name='discourse', serialize=False, to=settings.AUTH_USER_MODEL)),
+                ('enabled', models.BooleanField()),
+            ],
+        ),
+    ]

services/modules/discourse/models.py

@@ -0,0 +1,15 @@
+from __future__ import unicode_literals
+from django.utils.encoding import python_2_unicode_compatible
+from django.contrib.auth.models import User
+from django.db import models
+
+
+class DiscourseUser(models.Model):
+    user = models.OneToOneField(User,
+                                primary_key=True,
+                                on_delete=models.CASCADE,
+                                related_name='discourse')
+    enabled = models.BooleanField()
+
+    def __str__(self):
+        return self.user.username

services/modules/discourse/tasks.py

@@ -0,0 +1,62 @@
+from __future__ import unicode_literals
+
+from alliance_auth.celeryapp import app
+from django.contrib.auth.models import User
+from django.core.exceptions import ObjectDoesNotExist
+from notifications import notify
+
+from services.tasks import only_one
+
+from .manager import DiscourseManager
+from .models import DiscourseUser
+
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+class DiscourseTasks:
+    def __init__(self):
+        pass
+
+    @classmethod
+    def delete_user(cls, user, notify_user=False):
+        if cls.has_account(user) and user.discourse.enabled:
+            logger.debug("User %s has a Discourse account. Disabling login." % user)
+            if DiscourseManager.disable_user(user):
+                user.discourse.delete()
+                if notify_user:
+                    notify(user, 'Discourse Account Disabled', level='danger')
+                return True
+        return False
+
+    @staticmethod
+    def has_account(user):
+        """
+        Check if the user has a discourse account
+        :param user: django.contrib.auth.models.User
+        :return: bool
+        """
+        try:
+            return user.discourse.enabled
+        except ObjectDoesNotExist:
+            return False
+
+    @staticmethod
+    @app.task(bind=True)
+    def update_groups(self, pk):
+        user = User.objects.get(pk=pk)
+        logger.debug("Updating discourse groups for user %s" % user)
+        try:
+            DiscourseManager.update_groups(user)
+        except:
+            logger.warn("Discourse group sync failed for %s, retrying in 10 mins" % user)
+            raise self.retry(countdown=60 * 10)
+        logger.debug("Updated user %s discourse groups." % user)
+
+    @staticmethod
+    @app.task
+    def update_all_groups():
+        logger.debug("Updating ALL discourse groups")
+        for discourse_user in DiscourseUser.objects.filter(enabled=True):
+            DiscourseTasks.update_groups.delay(discourse_user.user.pk)

services/modules/discourse/templates/registered/discourse_service_ctrl.html

@@ -0,0 +1,8 @@
+{% load i18n %}
+
+<td class="text-center">Discourse</td>
+<td class="text-center">{{ char.character_name }}</td>
+<td class="text-center"><a href="{{ DISCOURSE_URL }}">{{ DISCOURSE_URL }}</a></td>
+<td class="text-center">
+    <a class="btn btn-success" href="{{ DISCOURSE_URL }}"><span class="glyphicon glyphicon-arrow-right"></span></a>
+</td>

services/modules/discourse/tests.py

@@ -0,0 +1,135 @@
+from __future__ import unicode_literals
+
+try:
+    # Py3
+    from unittest import mock
+except ImportError:
+    # Py2
+    import mock
+
+from django.test import TestCase, RequestFactory
+from django.conf import settings
+from django.contrib.auth.models import User
+from django.core.exceptions import ObjectDoesNotExist
+
+from alliance_auth.tests.auth_utils import AuthUtils
+
+from .auth_hooks import DiscourseService
+from .models import DiscourseUser
+from .tasks import DiscourseTasks
+
+MODULE_PATH = 'services.modules.discourse'
+
+
+class DiscourseHooksTestCase(TestCase):
+    def setUp(self):
+        self.member = 'member_user'
+        member = AuthUtils.create_member(self.member)
+        DiscourseUser.objects.create(user=member, enabled=True)
+        self.blue = 'blue_user'
+        blue = AuthUtils.create_blue(self.blue)
+        DiscourseUser.objects.create(user=blue, enabled=True)
+        self.none_user = 'none_user'
+        none_user = AuthUtils.create_user(self.none_user)
+        self.service = DiscourseService
+
+    def test_has_account(self):
+        member = User.objects.get(username=self.member)
+        blue = User.objects.get(username=self.blue)
+        none_user = User.objects.get(username=self.none_user)
+        self.assertTrue(DiscourseTasks.has_account(member))
+        self.assertTrue(DiscourseTasks.has_account(blue))
+        self.assertFalse(DiscourseTasks.has_account(none_user))
+
+    def test_service_enabled(self):
+        service = self.service()
+        member = User.objects.get(username=self.member)
+        blue = User.objects.get(username=self.blue)
+        none_user = User.objects.get(username=self.none_user)
+        self.assertTrue(service.service_enabled_members())
+        self.assertTrue(service.service_enabled_blues())
+
+        self.assertEqual(service.service_active_for_user(member), settings.ENABLE_AUTH_DISCOURSE)
+        self.assertEqual(service.service_active_for_user(blue), settings.ENABLE_BLUE_DISCOURSE)
+        self.assertFalse(service.service_active_for_user(none_user))
+
+    @mock.patch(MODULE_PATH + '.tasks.DiscourseManager')
+    def test_update_all_groups(self, manager):
+        service = self.service()
+        service.update_all_groups()
+        # Check member and blue user have groups updated
+        self.assertTrue(manager.update_groups.called)
+        self.assertEqual(manager.update_groups.call_count, 2)
+
+    def test_update_groups(self):
+        # Check member has Member group updated
+        with mock.patch(MODULE_PATH + '.tasks.DiscourseManager') as manager:
+            service = self.service()
+            member = User.objects.get(username=self.member)
+            service.update_groups(member)
+            self.assertTrue(manager.update_groups.called)
+            args, kwargs = manager.update_groups.call_args
+            user, = args
+            self.assertEqual(user, member)
+
+        # Check none user does not have groups updated
+        with mock.patch(MODULE_PATH + '.tasks.DiscourseManager') as manager:
+            service = self.service()
+            none_user = User.objects.get(username=self.none_user)
+            service.update_groups(none_user)
+            self.assertFalse(manager.update_groups.called)
+
+    @mock.patch(MODULE_PATH + '.tasks.DiscourseManager')
+    def test_validate_user(self, manager):
+        service = self.service()
+        # Test member is not deleted
+        member = User.objects.get(username=self.member)
+        service.validate_user(member)
+        self.assertTrue(member.discourse)
+
+        # Test none user is deleted
+        none_user = User.objects.get(username=self.none_user)
+        DiscourseUser.objects.create(user=none_user, enabled=True)
+        service.validate_user(none_user)
+        self.assertTrue(manager.disable_user.called)
+        with self.assertRaises(ObjectDoesNotExist):
+            none_discourse = User.objects.get(username=self.none_user).discourse
+
+    @mock.patch(MODULE_PATH + '.tasks.DiscourseManager')
+    def test_delete_user(self, manager):
+        member = User.objects.get(username=self.member)
+
+        service = self.service()
+        result = service.delete_user(member)
+
+        self.assertTrue(result)
+        self.assertTrue(manager.disable_user.called)
+        with self.assertRaises(ObjectDoesNotExist):
+            discourse_user = User.objects.get(username=self.member).discourse
+
+    def test_render_services_ctrl(self):
+        service = self.service()
+        member = User.objects.get(username=self.member)
+        request = RequestFactory().get('/en/services/')
+        request.user = member
+
+        response = service.render_services_ctrl(request)
+        self.assertTemplateUsed(service.service_ctrl_template)
+        self.assertIn('href="%s"' % settings.DISCOURSE_URL, response)
+
+
+class DiscourseViewsTestCase(TestCase):
+    def setUp(self):
+        self.member = AuthUtils.create_member('auth_member')
+        self.member.set_password('password')
+        self.member.save()
+        AuthUtils.add_main_character(self.member, 'auth_member', '12345', corp_id='111', corp_name='Test Corporation')
+
+    @mock.patch(MODULE_PATH + '.tasks.DiscourseManager')
+    def test_sso_member(self, manager):
+        self.client.login(username=self.member.username, password='password')
+        data = {'sso': 'bm9uY2U9Y2I2ODI1MWVlZmI1MjExZTU4YzAwZmYxMzk1ZjBjMGI%3D%0A',
+                'sig': '2828aa29899722b35a2f191d34ef9b3ce695e0e6eeec47deb46d588d70c7cb56'}
+        response = self.client.get('/discourse/sso', data=data, follow=False)
+        self.assertEqual(response.status_code, 302)
+        self.assertEqual(response.url[:37], 'https://example.com/session/sso_login')

services/modules/discourse/urls.py

@@ -0,0 +1,9 @@
+from __future__ import unicode_literals
+from django.conf.urls import url
+
+from . import views
+
+urlpatterns = [
+    # Discourse Service Control
+    url(r'^discourse/sso$', views.discourse_sso, name='auth_discourse_sso'),
+]

services/modules/discourse/views.py

@@ -0,0 +1,119 @@
+from __future__ import unicode_literals
+
+from django.conf import settings
+from django.contrib import messages
+from django.contrib.auth.decorators import login_required
+from django.shortcuts import render, redirect
+from authentication.states import MEMBER_STATE, BLUE_STATE, NONE_STATE
+from eveonline.models import EveCharacter
+from eveonline.managers import EveManager
+from authentication.models import AuthServicesInfo
+
+from .manager import DiscourseManager
+from .tasks import DiscourseTasks
+from .models import DiscourseUser
+
+import base64
+import hmac
+import hashlib
+
+try:
+    from urllib import unquote, urlencode
+except ImportError: #py3
+    from urllib.parse import unquote, urlencode
+try:
+    from urlparse import parse_qs
+except ImportError: #py3
+    from urllib.parse import parse_qs
+
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+@login_required
+def discourse_sso(request):
+
+    ## Check if user has access
+
+    auth = AuthServicesInfo.objects.get(user=request.user)
+    if not request.user.is_superuser:
+        if not settings.ENABLE_AUTH_DISCOURSE and auth.state == MEMBER_STATE:
+            messages.error(request, 'Members are not authorized to access Discourse.')
+            return redirect('auth_dashboard')
+        elif not settings.ENABLE_BLUE_DISCOURSE and auth.state == BLUE_STATE:
+            messages.error(request, 'Blues are not authorized to access Discourse.')
+            return redirect('auth_dashboard')
+        elif auth.state == NONE_STATE:
+            messages.error(request, 'You are not authorized to access Discourse.')
+            return redirect('auth_dashboard')
+
+    if not auth.main_char_id:
+        messages.error(request, "You must have a main character set to access Discourse.")
+        return redirect('auth_characters')
+
+    main_char = EveManager.get_main_character(request.user)
+    if main_char is None:
+        messages.error(request, "Your main character is missing a database model. Please select a new one.")
+        return redirect('auth_characters')
+
+    payload = request.GET.get('sso')
+    signature = request.GET.get('sig')
+
+    if None in [payload, signature]:
+        messages.error(request, 'No SSO payload or signature. Please contact support if this problem persists.')
+        return redirect('auth_dashboard')
+
+    ## Validate the payload
+
+    try:
+        payload = unquote(payload).encode('utf-8')
+        decoded = base64.decodestring(payload).decode('utf-8')
+        assert 'nonce' in decoded
+        assert len(payload) > 0
+    except AssertionError:
+        messages.error(request, 'Invalid payload. Please contact support if this problem persists.')
+        return redirect('auth_dashboard')
+
+    key = str(settings.DISCOURSE_SSO_SECRET).encode('utf-8')
+    h = hmac.new(key, payload, digestmod=hashlib.sha256)
+    this_signature = h.hexdigest()
+
+    if this_signature != signature:
+        messages.error(request, 'Invalid payload. Please contact support if this problem persists.')
+        return redirect('auth_dashboard')
+
+    ## Build the return payload
+
+    username = DiscourseManager._sanitize_username(main_char.character_name)
+
+    qs = parse_qs(decoded)
+    params = {
+        'nonce': qs['nonce'][0],
+        'email': request.user.email,
+        'external_id': request.user.pk,
+        'username': username,
+        'name': username,
+    }
+
+    if auth.main_char_id:
+        params['avatar_url'] = 'https://image.eveonline.com/Character/%s_256.jpg' % auth.main_char_id
+
+    return_payload = base64.encodestring(urlencode(params).encode('utf-8'))
+    h = hmac.new(key, return_payload, digestmod=hashlib.sha256)
+    query_string = urlencode({'sso': return_payload, 'sig': h.hexdigest()})
+
+    ## Record activation and queue group sync
+
+    if not DiscourseTasks.has_account(request.user):
+        discourse_user = DiscourseUser()
+        discourse_user.user = request.user
+        discourse_user.enabled = True
+        discourse_user.save()
+        DiscourseTasks.update_groups.apply_async(args=[request.user.pk], countdown=30) # wait 30s for new user creation on Discourse
+
+    ## Redirect back to Discourse
+
+    url = '%s/session/sso_login' % settings.DISCOURSE_URL
+    return redirect('%s?%s' % (url, query_string))
+