EVE Connector¶
Overview¶
The EVE Online Connector is our base module for ESI. This adds characters, corporations, and alliance objects and the tasks to update them. It’s required by nearly other EVE Online package.
Quick Steps¶
To set up the django_eveonline_connector
package:
- Install it (varies, Docker vs Development)
- (Recommended) Load the default schedule (
python3 manage.py loaddata eveonline_default_schedule
) - Create a CCP Application (https://developers.eveonline.com/applications)
- Add all scopes, enter your callback url (e.g
http://<your_site>/eveonline/sso/callback
) - Create an EVE Online client in the Admin Panel (
http://<your_site>/admin
) - Input the
CLIENT ID
from your application - Input the
CLIENT_SECRET
from your application
Detailed Steps¶
1. Create an EVE Online application¶
- Navigate to https://developers.eveonline.com/applications
- Log in, create a new application
- Fill out a name. Recommended: [TICKER] - Krypted Platform
- Fill out a description.
- Under connection type, select Authentication & API Access.
- Add all scopes.
- Under callback URL, add
http://<your_site>/eveonline/sso/callback
(your_site
is your site domain). Save this for later. - Save the application.
- Copy the CLIENT ID. Save this for later.
- Copy the CLIENT SECRET. Save this for later.
2. Create an EVE Online client¶
- Navigate to your Admin Panel on the Krypted platform
- Click EVE Clients
- Create an EVE Client
- Fill out the CALLBACK URL from Step #1
- Fill out the CLIENT ID from Step #1
- Fill out the CLIENT SECRET from Step #1
(Optional) Modifying Scopes¶
At any time, if you need to modify scopes, you can navigate to EVE SCOPES in the Admin Panel and create (or delete) scopes.
Tasks¶
django_eveonline_connector.tasks.update_all_characters
This will update all character tokens and their affiliations.django_eveonline_connector.tasks.update_all_corporations
This will update all corporations and their affiliations.django_eveonline_connector.tasks.update_all_alliances
This will update all alliances and their affiliations.
Permissions¶
Permission | Action |
---|---|
Can view eve charcter | Ability to view eve character list |
Can view eve corporation | Ability to view eve corporation list |
Recommened Task Schedule¶
Command | Action | Interval |
---|---|---|
django_eveonline_connector.tasks.update_all_characters |
Update character details | Every 4 hours |
django_eveonline_connector.tasks.update_all_corporations |
Update corporation details | Every day |
django_eveonline_connector.tasks.update_all_alliances |
Update alliance details | Every day |