<a id="eve-online-single-sign-on-sso"></a>

# EVE Online Single Sign-On (SSO)

<a id="backend-class"></a>

## Backend class

For Django, add this class path to `AUTHENTICATION_BACKENDS`. For other
integrations, use the same class path in the framework-specific backend
setting.

| Backend name   | Class path                                       |
|----------------|--------------------------------------------------|
| `eveonline`    | `social_core.backends.eveonline.EVEOnlineOAuth2` |

The EVE Single Sign-On (SSO) works similar to GitHub (OAuth2).

- Register a new application at [EVE Developers](https://developers.eveonline.com/), set the callback URL to
  `http://example.com/complete/eveonline/` replacing `example.com` with your
  domain.
- Fill the `Client ID` and `Secret Key` values from EVE Developers in the settings:
  ```default
  SOCIAL_AUTH_EVEONLINE_KEY = ''
  SOCIAL_AUTH_EVEONLINE_SECRET = ''
  ```
- If you want to use EVE Character names as user names, use this setting:
  ```default
  SOCIAL_AUTH_CLEAN_USERNAMES = False
  ```
- If you want to access EVE Online’s CREST API, use:
  ```default
  SOCIAL_AUTH_EVEONLINE_SCOPE = ['publicData']
  ```
