allianceauth-graphql 0.3.0

GraphQL integration for AllianceAuth

allianceauth-graphql

GraphQL integration for AllianceAuth

Free software: GNU General Public License v3

This version is in alpha, please open an issue if you face any bug.

Setup

The following is assuming you have a functioning AllianceAuth installation.

Install plugin

1. pip install allianceauth-graphql.

2. Add the following apps to the bottom of your INSTALLED_APPS in the local.py settings file:

   'allianceauth_graphql',
   'graphene_django',
   

3. Add the following settings to your local.py file:

   from datetime import timedelta
   
   # ...
   
   GRAPHENE = {
       'SCHEMA': 'allianceauth_graphql.schema.schema',
       "MIDDLEWARE": [
           "graphql_jwt.middleware.JSONWebTokenMiddleware",
       ],
   }
   
   AUTHENTICATION_BACKENDS += [
       "graphql_jwt.backends.JSONWebTokenBackend",
   ]
   
   GRAPHQL_JWT = {
       "JWT_VERIFY_EXPIRATION": True,
       "JWT_EXPIRATION_DELTA": timedelta(days=1),
       "JWT_REFRESH_EXPIRATION_DELTA": timedelta(days=7),
   }
   

   Feel free to edit the expiration limits of your tokens.

4. Edit your projects url.py file:

   It should looks something like this

   from django.conf.urls import include, url
   from allianceauth import urls
   
   urlpatterns = [
       url(r'', include(urls)),
   ]
   
   handler500 = 'allianceauth.views.Generic500Redirect'
   handler404 = 'allianceauth.views.Generic404Redirect'
   handler403 = 'allianceauth.views.Generic403Redirect'
   handler400 = 'allianceauth.views.Generic400Redirect'
   

   After the edit:

   from django.conf.urls import include, url
   from allianceauth import urls
   from allianceauth_graphql import urls as aa_gql_urls
   
   urlpatterns = [
       url(r'', include(urls)),
       url(r'graphql/', include(aa_gql_urls)),
   ]
   
   handler500 = 'allianceauth.views.Generic500Redirect'
   handler404 = 'allianceauth.views.Generic404Redirect'
   handler403 = 'allianceauth.views.Generic403Redirect'
   handler400 = 'allianceauth.views.Generic400Redirect'
   

5. Restart AllianceAuth.

Settings

Setting	Default	Description
SHOW_GRAPHIQL	True	Shows the graphiql UI in the browser
GRAPHQL_LOGIN_SCOPES	['publicData']	Tokens needed. Unlike AllianceAuth pages, you need to login with the scopes you'll use, otherwise you won't be able to perform some queries

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

v0.2.2 (2022-04-05)

Implemented all the views in the authentication app:

• Change main character
• Add a character
• User's groups
• User's alts

v0.2.1 (2022-04-04)

• Updated history and readme, no change to the code.

v0.2.0 (2022-04-04)

• Working login with django-graphql-jwt.

v0.1.1 (2022-04-02)

• Working /graphql/ endpoint and updated requirements.

v0.1.0 (2022-03-18)

• First release on PyPI.