<a id="msn-live-connect"></a>

# MSN Live Connect

<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                             |
|----------------|----------------------------------------|
| `live`         | `social_core.backends.live.LiveOAuth2` |

Live uses OAuth2 for its connect workflow, notice that it isn’t OAuth WRAP.

- Register a new application at [Live Connect Developer Center](https://account.live.com/developers/applications/create), set your site
  domain as redirect domain,
- Fill `Client Id` and `Client Secret` values in the settings:
  ```default
  SOCIAL_AUTH_LIVE_KEY = ''
  SOCIAL_AUTH_LIVE_SECRET = ''
  ```
- Also it’s possible to define extra permissions with:
  ```default
  SOCIAL_AUTH_LIVE_SCOPE = [...]
  ```

  Defaults are `wl.basic` and `wl.emails`. Latter one is necessary to
  retrieve user email.
- Ensure to have a valid `Redirect URL` (`http://your-domain/complete/live`)
  defined in the application if `Enhanced security redirection` is enabled.
