Update the tutorial for using OWIN middleware

[cosmin-ciuc]

Would it be possible to change the tutorial for usage of OWIN middleware so that instead of recommending to route all the requests through ASP.NET pipeline

<system.webServer>
        ...
        <modules runAllManagedModulesForAllRequests="true">
            ...

it would recommend to add the following three lines in web.config file:

<system.webServer>
     ...
    <handlers>
       ...
      <add name="SwaggerIndex" path="swagger/index.html" verb="*" type="NSwag.AspNet.Owin.SwaggerUiIndexMiddleware" />
      <add name="SwaggerGenerator" path="swagger/v1/swagger.json" verb="*" type="NSwag.AspNet.Owin.SwaggerMiddleware" />
      <add name="SwaggerRedirect" path="swagger" verb="*" type="NSwag.AspNet.Owin.RedirectMiddleware" />

?

[RicoSuter]

I agree with you that piping all request through .NET may be problematic...

[cosmin-ciuc]

I have tested the settings I've wrote above and they work. Of course, you have to register SwaggerUI on "/swagger" address like this:

                RouteTable.Routes.MapOwinPath(
                    "swagger",
                    app =>
                        {
                            app.UseSwaggerUi(
                                typeof(Global).Assembly,
                                new SwaggerUiOwinSettings
                                    {
                                        MiddlewareBasePath = "/swagger"

[RicoSuter]

Ok? https://github.com/NSwag/NSwag/wiki/OwinGlobalAsax

[cosmin-ciuc]

Perfect. Thank you.

[RicoSuter]

Thank you for helping here. Btw: You can also create a PR to change the wiki with your suggestions :-)...

[chucklu]

Hi @RSuter, @cosmin-ciuc ,
I can only work with the first configuration in modules level, when I try to use the second. Configured it in handler, it did not work.
Could you provided a sample for the second configuration?
By the way, I am working this tutorial : https://github.com/RSuter/NSwag/wiki/OWIN-Middleware