API Documentation and Authentication don't work together.

[SteveIves]

We now generate API documentation in all services, but as soon as authentication is enabled (either OAuth or custom) the usefulness of the documentation is degraded because the "Try it Out" functionality can no longer be used.

Swagger UI definitely has support for authentication, we used to enable it when manually generating the swagger file. I'm guessing there are some additional things we need to do in the Startup class to enable the functionality in the auto-generated API docs.

Also, our authentication endpoint is currently not appearing in the API docs, possibly because it is not an OData controller. Making it an OData controller broke other stuff. So we also need to figure out how to integrate the authentication endpoint with the rest of the OData and versioned environment.