Merge branch 'jlukawska-feature/603-bad-gateway'

Author: TomPallister

docs/features/errorcodes.rst

@@ -0,0 +1,13 @@
+Http Error Status Codes
+=======================
+
+Ocelot will return HTTP status error codes based on internal logic in certain siturations:
+- 401 if the authentication middleware runs and the user is not authenticated.
+- 403 if the authorisation middleware runs and the user is unauthenticated, claim value not authroised, scope not authorised, user doesnt have required claim or cannot find claim.
+- 503 if the downstream request times out.
+- 499 if the request is cancelled by the client.
+- 404 if unable to find a downstream route.
+- 502 if unable to connect to downstream service.
+- 500 if unable to complete the HTTP request downstream and the exception is not OperationCanceledException or HttpRequestException.
+- 404 if Ocelot is unable to map an internal error code to a HTTP status code.
+

docs/index.rst

@@ -42,6 +42,7 @@ Thanks for taking a look at the Ocelot documentation. Please use the left hand n
    features/loadbalancer
    features/delegatinghandlers
    features/raft
+   features/errorcodes
 
 .. toctree::
    :maxdepth: 2

src/Ocelot/Errors/OcelotErrorCode.cs

@@ -39,6 +39,7 @@ public enum OcelotErrorCode
         CannotAddPlaceholderError = 34,
         CannotRemovePlaceholderError = 35,
         QuotaExceededError = 36,
-        RequestCanceled = 37,
+        RequestCanceled = 37,
+        ConnectionToDownstreamServiceError = 38,
     }
 }

src/Ocelot/Requester/ConnectionToDownstreamServiceError.cs

@@ -0,0 +1,13 @@
+using Ocelot.Errors;
+using System;
+
+namespace Ocelot.Requester
+{
+    public class ConnectionToDownstreamServiceError : Error
+    {
+        public ConnectionToDownstreamServiceError(Exception exception)
+            : base($"Error connecting to downstream service, exception: {exception}", OcelotErrorCode.ConnectionToDownstreamServiceError)
+        {
+        }
+    }
+}

src/Ocelot/Requester/HttpExeptionToErrorMapper.cs

@@ -4,6 +4,7 @@ namespace Ocelot.Requester
     using Microsoft.Extensions.DependencyInjection;
     using System;
     using System.Collections.Generic;
+    using System.Net.Http;
 
     public class HttpExeptionToErrorMapper : IExceptionToErrorMapper
     {
@@ -28,6 +29,11 @@ public Error Map(Exception exception)
                 return new RequestCanceledError(exception.Message);
             }
 
+            if (type == typeof(HttpRequestException))
+            {
+                return new ConnectionToDownstreamServiceError(exception);
+            }
+
             return new UnableToCompleteRequestError(exception);
         }
     }

src/Ocelot/Responder/ErrorsToHttpStatusCodeMapper.cs

@@ -38,6 +38,11 @@ public int Map(List<Error> errors)
             if (errors.Any(e => e.Code == OcelotErrorCode.UnableToFindDownstreamRouteError))
             {
                 return 404;
+            }
+
+            if (errors.Any(e => e.Code == OcelotErrorCode.ConnectionToDownstreamServiceError))
+            {
+                return 502;
             }
 
             if (errors.Any(e => e.Code == OcelotErrorCode.UnableToCompleteRequestError))

src/Ocelot/Responder/IErrorsToHttpStatusCodeMapper.cs

@@ -1,8 +1,9 @@
-using Ocelot.Errors;
-using System.Collections.Generic;
+namespace Ocelot.Responder
+{
+    using System.Net;
+    using Ocelot.Errors;
+    using System.Collections.Generic;
 
-namespace Ocelot.Responder
-{
     /// <summary>
     /// Map a list OceoltErrors to a single appropriate HTTP status code
     /// </summary>

test/Ocelot.AcceptanceTests/HttpTests.cs

@@ -141,7 +141,7 @@ public void should_return_response_200_when_using_http_two_point_zero()
         }
 
         [Fact]
-        public void should_return_response_500_when_using_http_one_to_talk_to_server_running_http_two()
+        public void should_return_response_502_when_using_http_one_to_talk_to_server_running_http_two()
         {
             var port = RandomPortFinder.GetRandomPort();
 
@@ -177,7 +177,7 @@ public void should_return_response_500_when_using_http_one_to_talk_to_server_run
                 .And(x => _steps.GivenThereIsAConfiguration(configuration))
                 .And(x => _steps.GivenOcelotIsRunning())
                 .When(x => _steps.WhenIGetUrlOnTheApiGateway("/", httpContent))
-                .Then(x => _steps.ThenTheStatusCodeShouldBe(HttpStatusCode.InternalServerError))
+                .Then(x => _steps.ThenTheStatusCodeShouldBe(HttpStatusCode.BadGateway))
                 .BDDfy();
         }
 

test/Ocelot.AcceptanceTests/ReturnsErrorTests.cs

@@ -16,6 +16,38 @@ public ReturnsErrorTests()
         {
             _serviceHandler = new ServiceHandler();
             _steps = new Steps();
+        }
+
+        [Fact]
+        public void should_return_bad_gateway_error_if_downstream_service_doesnt_respond()
+        {
+            var configuration = new FileConfiguration
+            {
+                ReRoutes = new List<FileReRoute>
+                    {
+                        new FileReRoute
+                        {
+                            DownstreamPathTemplate = "/",
+                            UpstreamPathTemplate = "/",
+                            UpstreamHttpMethod = new List<string> { "Get" },
+                            DownstreamHostAndPorts = new List<FileHostAndPort>
+                            {
+                                new FileHostAndPort
+                                {
+                                    Host = "localhost",
+                                    Port = 53877,
+                                },
+                            },
+                            DownstreamScheme = "http",
+                        },
+                    },
+            };
+
+            this.Given(x => _steps.GivenThereIsAConfiguration(configuration))
+                .And(x => _steps.GivenOcelotIsRunning())
+                .When(x => _steps.WhenIGetUrlOnTheApiGateway("/"))
+                .Then(x => _steps.ThenTheStatusCodeShouldBe(HttpStatusCode.BadGateway))
+                .BDDfy();
         }
 
         [Fact]

test/Ocelot.AcceptanceTests/SslTests.cs

@@ -89,7 +89,7 @@ public void should_not_dangerous_accept_any_server_certificate_validator()
                 .And(x => _steps.GivenThereIsAConfiguration(configuration))
                 .And(x => _steps.GivenOcelotIsRunning())
                 .When(x => _steps.WhenIGetUrlOnTheApiGateway("/"))
-                .Then(x => _steps.ThenTheStatusCodeShouldBe(HttpStatusCode.InternalServerError))
+                .Then(x => _steps.ThenTheStatusCodeShouldBe(HttpStatusCode.BadGateway))
                 .BDDfy();
         }