[HowTo] Setup SSO and ESI Fetching

Testing before new release
Post Reply
User avatar
Salvoxia
Developer
Posts: 1464
Joined: Wed Feb 22, 2012 12:11

[HowTo] Setup SSO and ESI Fetching

Post by Salvoxia » Sat Apr 14, 2018 20:56

Hi guys,

this thread is intended as a how-to for setting up Single-Sign-On for your killboard and ESI killmail fetching.

Quick links to each paragraph: Best Regards,
Salvoxia

User avatar
Salvoxia
Developer
Posts: 1464
Joined: Wed Feb 22, 2012 12:11

Re: [HowTo] Setup SSO and ESI Fetching

Post by Salvoxia » Sat Apr 14, 2018 20:58

1. Register your account as a developer (required for setting up SSO)

With the old XML API, you needed API keys for all pilots/corporations you wanted to fetch killmails for. Now, pilots or corporation directors have to register themselves using CCP's SingleSignOn (SSO) at your EDK and grant it access to character or corporation killmails via ESI.
To enable SSO for your killboard installation, you need to register it with CCP.
If you click the new "SSO Registration" link in your top menu, you will be greeted by a page like this:
Image


Enter your Admin Control Panel and select "SSO Keys" on the right-hand menu:
Image

Follow the link to EVE's developer page:
Image

There, click the "Manage applications" button:
Image

Log in with the account you'd like to register this EDK installation with:
Image

After logging in, you wil be directed back to the main Developers page. Again, select "Manage applications":
Image

If you have an valid account, you need to view and accept CCP's developer license:
Image

Read the license, and if you accept it, click the "I agree" button:
Image

User avatar
Salvoxia
Developer
Posts: 1464
Joined: Wed Feb 22, 2012 12:11

Re: [HowTo] Setup SSO and ESI Fetching

Post by Salvoxia » Sat Apr 14, 2018 21:08

2. Register your EDK installation

After completing step 1, you will see an overview over all registered applications. Select "Create new application":
Image

Enter a name and description for the killboard. This information will be displayed to anyone who will register for killmail fetching at your EDK installation.
For "Connection type", choose "Authentication & API Access".
In the "Permissions" section, search for "esi-killmails" in the left textbox, which will yield two results. Add them to the list of requested scopes by clicking on each.
Image

For the "Callback URL" section, switch back to your browser tab showing your EDK Admin Control panel.
There, you can see the callback URL you need to insert in the Developer Application Registration:
Attention: If you switch to simple URLs (ACP -> Configuration -> Use simple URLs) or back, you'll have to update this callback URL in your application registration at CCP![/b]
Image

Copy that link and paste it into the "Callback URL" text field in the Developer Application Registration:
Image

Finally, hit the "Create Application" button at the bottom of the page:
Image

User avatar
Salvoxia
Developer
Posts: 1464
Joined: Wed Feb 22, 2012 12:11

Re: [HowTo] Setup SSO and ESI Fetching

Post by Salvoxia » Sat Apr 14, 2018 21:09

3. Enter client ID and secret in EDK

After completing step 2, you will be redirected to your application overview, which now contains your newly registered EDK installation. Click the "View Application" button:
Image

The application has been assigned a client ID and a client secret. Do NOT reveal the client secret to anyone!
Copy each value over to the tab with your EDK Admin Control Panel:
Image
Image
Confirm by clicking the "Save" button.

User avatar
Salvoxia
Developer
Posts: 1464
Joined: Wed Feb 22, 2012 12:11

Re: [HowTo] Setup SSO and ESI Fetching

Post by Salvoxia » Sat Apr 14, 2018 21:10

4. Registering a character with your EDK installation

Assume you want your killboard to fetch your character's killmails. In order to do that, select "SSO Registration" in your EDK top menu:
Image

Select "Pilot" and click the "Login with EVE Online" button:
Image

Now log in with the account containing the character you want to register:
Image

Select the character from the drop down menu, then click the "Authorize" button
Image

You will be redirected back to the SSO registration page of your EDK installation, where a success message should be displayed:
Image

Now, log back in to your Admin Control Panel and navigate to the SSO Keys page. It now will show the registered character along with information about that access token.

User avatar
Salvoxia
Developer
Posts: 1464
Joined: Wed Feb 22, 2012 12:11

Re: [HowTo] Setup SSO and ESI Fetching

Post by Salvoxia » Sat Apr 14, 2018 21:11

5. ESI Fetch configuration and cron job

In ACP -> SSO Keys, there are a few preferences you can set.
  • Maximum processing time per ESI SSO key [s]:
    This setting restricts the amount of time EDK may spend processing kills for a single SSO key. This is useful if you cannot influence the maximum execution time of your PHP installation, to make sure that each registered SSO key is processed.
  • Ignore NPC only deaths?
    Like with the old API import, you can choose whether deaths to NPCs should not be imported.
As a replacement for the old cron_api.php CronJob, a new CronJob cron_esi.php was added. The recommended execution frequency is every five minutes.

Post Reply

Return to “Testing”

Who is online

Users browsing this forum: No registered users and 1 guest