View on GitHub

peterhaneve.github.io

EVEMon for ESI - Configuring Client ID

Why do I have to do this?

You do not! As of version 4.0.9, EVEMon supports PKCE, and no developer registration is required. This page exists for the curious, users of older versions, or paranoid users who want their own client secret.

ESI requires a client ID and client secret to function, which are theoretically unique for each application which use it. These items are used to retrieve tokens used to access your API information; a particular access token (the new version of an API key) is only usable with a given client ID and secret. Thus, these two items are intended to be kept secret for a given application.

However, hard coding the client ID and client secret in EVEMon’s application code is not recommended, as it would then be available for nefarious spies to potentially see your top-secret information. Therefore, EVEMon requires that each user create their own client ID and client secret, which makes it difficult for another user (or me) to spy on you even if they obtain your tokens. The client ID and client secret can be reused across multiple accounts and multiple instances of EVEMon.

Creating your client ID

  1. Go to https://developers.eveonline.com/applications/create
  2. Log in with a valid EVE Online username and password. EVEMon will not see your password. This only must be done once even if you have multiple accounts.
  3. Enter an application name and description, these can be anything (EVEMon will not see these) Application Name
  4. Select Authentication & API Access API Access Mode
  5. Enter “esi” in the text box under Available Scopes List Enable Scopes

  6. Click once on all of the items which appear in the text box to move them to the right

    Scopes Set

    Paranoid? See the end of this document to manually select only the scopes that EVEMon actually uses.

  7. Enter http://localhost:4916/callback in the Callback URL field Set callback URL
  8. Select Create Application
  9. On the list that appears, select View Application on the newly created entry View Application
  10. Scroll down to the section which shows the Client ID and Client Secret Client ID and secret

Configuring EVEMon

  1. Open EVEMon. If old characters are left over from versions prior to 4.0.0, back up any important skill plans and reset settings (File > Reset Settings) Reset Settings
  2. Select File > Add API Key. If it is not already set up, you will be redirected to the Network Settings page Network Settings
  3. Enter the Client ID and Client Secret obtained in the previous section into the fields
  4. Select OK
  5. Select File > Add API Key again; follow the directions to add characters just like any other tool using ESI Add API key

For the paranoid, EVEMon actually requires the following scopes. Leaving out a scope may result in error messages if that particular section of EVEMon is used.