<a id="microsoft-viva-engage"></a>

# Microsoft Viva Engage

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

## Backend classes

For Django, choose from these class paths for `AUTHENTICATION_BACKENDS`.
For other integrations, use the same class paths in the
framework-specific backend setting.

| Backend name     | Class path                                        |
|------------------|---------------------------------------------------|
| `yammer`         | `social_core.backends.yammer.YammerOAuth2`        |
| `yammer-staging` | `social_core.backends.yammer.YammerStagingOAuth2` |

Yammer users OAuth2 for their auth mechanism, this application supports Yammer
OAuth2 in production and staging modes.

<a id="production-mode"></a>

## Production Mode

In order to enable the backend, follow:

- Register an application at [Client Applications](https://www.yammer.com/client_applications),
  set the `Redirect URI` to `http://<your hostname>/complete/yammer/`
- Fill **Client Key** and **Client Secret** settings:
  ```default
  SOCIAL_AUTH_YAMMER_KEY = '...'
  SOCIAL_AUTH_YAMMER_SECRET = '...'
  ```

<a id="staging-mode"></a>

## Staging Mode

Staging mode is configured the same as `Production Mode`, but settings are
prefixed with:

```default
SOCIAL_AUTH_YAMMER_STAGING_*
```
