1// Copyright 2020 The gRPC Authors
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15// Local copy of Envoy xDS proto file, used for testing only.
16
17syntax = "proto3";
18
19package envoy.extensions.filters.network.http_connection_manager.v3;
20
21import "google/protobuf/any.proto";
22
23import "src/proto/grpc/testing/xds/v3/config_source.proto";
24import "src/proto/grpc/testing/xds/v3/protocol.proto";
25import "src/proto/grpc/testing/xds/v3/route.proto";
26
27// [#protodoc-title: HTTP connection manager]
28// HTTP connection manager :ref:`configuration overview <config_http_conn_man>`.
29// [#extension: envoy.filters.network.http_connection_manager]
30
31message HttpConnectionManager {
32  oneof route_specifier {
33    // The connection manager’s route table will be dynamically loaded via the RDS API.
34    Rds rds = 3;
35
36    // The route table for the connection manager is static and is specified in this property.
37    config.route.v3.RouteConfiguration route_config = 4;
38
39    // A route table will be dynamically assigned to each request based on request attributes
40    // (e.g., the value of a header). The "routing scopes" (i.e., route tables) and "scope keys" are
41    // specified in this message.
42    ScopedRoutes scoped_routes = 31;
43  }
44
45  // A list of individual HTTP filters that make up the filter chain for
46  // requests made to the connection manager. :ref:`Order matters <arch_overview_http_filters_ordering>`
47  // as the filters are processed sequentially as request events happen.
48  repeated HttpFilter http_filters = 5;
49
50  // Additional settings for HTTP requests handled by the connection manager. These will be
51  // applicable to both HTTP1 and HTTP2 requests.
52  config.core.v3.HttpProtocolOptions common_http_protocol_options = 35;
53}
54
55message Rds {
56  // Configuration source specifier for RDS.
57  config.core.v3.ConfigSource config_source = 1;
58
59  // The name of the route configuration. This name will be passed to the RDS
60  // API. This allows an Envoy configuration with multiple HTTP listeners (and
61  // associated HTTP connection manager filters) to use different route
62  // configurations.
63  string route_config_name = 2;
64}
65
66message ScopedRoutes {
67}
68
69message HttpFilter {
70  // The name of the filter configuration. The name is used as a fallback to
71  // select an extension if the type of the configuration proto is not
72  // sufficient. It also serves as a resource name in ExtensionConfigDS.
73  string name = 1;
74
75  oneof config_type {
76    // Filter specific configuration which depends on the filter being instantiated. See the supported
77    // filters for further documentation.
78    google.protobuf.Any typed_config = 4;
79  }
80
81  bool is_optional = 6;
82}
83