GraphQL integration for AllianceAuth
Project description
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
-
pip install allianceauth-graphql
. -
Add the following apps to the bottom of your
INSTALLED_APPS
in the local.py settings file:'allianceauth_graphql', 'graphene_django', "graphql_jwt.refresh_token.apps.RefreshTokenConfig",
-
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_LONG_RUNNING_REFRESH_TOKEN": True, "JWT_EXPIRATION_DELTA": timedelta(days=1), "JWT_REFRESH_EXPIRATION_DELTA": timedelta(days=7), }
Feel free to edit the expiration limits of your tokens.
-
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'
-
Run migrations.
-
If you have
SHOW_GRAPHIQL
setting set toTrue
(see below), run collectstatics -
Restart AllianceAuth.
Community Creations Integration
Currently the package supports the integration with the following community packages:
- allianceauth-pve
To install the dependencies needed, run pip install allianceauth-graphql[package1,package2]
for all the packages you want to integrate.
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 |
REDIRECT_SITE | No default | The URL domain for redirecting after email verification. It has to have the protocol and not the slash at the end: http(s)://<yoursite> |
REDIRECT_PATH | /registration/callback/ |
Path to append to REDIRECT_SITE for building the redirect URL |
Credits
This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.
History
v0.5.3 (2022-04-11)
- Added running averages
v0.5.2 (2022-04-11)
- Support for allianceauth-pve v0.3.0
v0.5.1
- Fixed community creations dyncamic import.
- Added extras_requires in pip install.
v0.5.0 (2022-04-08)
- Added support for allianceauth-pve package.
v0.4.0 (2022-04-06)
- Implemented the 3 steps registration.
v0.3.1 (2022-04-05)
- Fixed wrong id reference in addCharacter mutation.
v0.3.0 (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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for allianceauth_graphql-0.5.5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | b09bd8469401bccd1d9ba8a344d31847f67e782dd8f703702062684e85432788 |
|
MD5 | 02b4b9ac05351a57e2fe1c4d25bbf5d1 |
|
BLAKE2b-256 | acc46c2082c07cabd82c7984675fc7c17838f4e2ce3ae4a9fabbc45e4b72f57c |
Hashes for allianceauth_graphql-0.5.5-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 08281b0e2cf544e3980d916fd9f32d230da09d23fe7dede6d43cf4f800b3c678 |
|
MD5 | 9c9a89ce370e133de48aad2667290046 |
|
BLAKE2b-256 | 9b9b2e68262dcb307d3fa8398a7037cccacd55357abef0e06dedaed0ae2bf77a |