Files
threshold/internal/proto/local/errors/v1/errors.proto
T
Jim 769416c2ff refactor (controller): Use a grpc server for the grpc-gateway (#1576)
* refactor (controller): Use a grpc server for the grpc-gateway

This starts a grpc server for the grpc-gateway.  The new gateway
server uses an in-memory listener which also supports "dialing", so
the http proxy can connect to the in-memory listener.

This change allows us to use all grpc server features and was in part
motivated by a need for an interceptor of inbound requests.  With that
said, having a "proper" grpc server for the gateway will provide a lot
more flexibility and capabilities moving forward.

The request context will still be verified via middleware in the
http proxy (see wrapHandlerWithCommonFuncs).  This verified context
will be serialized into a protobuf and sent along to the grpc-gateway
via metadata where an interceptor will add the verified request
info to the request's context (see requestCtxInterceptor).  The
interceptor will verify the serialized request info via a shared ticket
with it's companion in-memory http proxy.  FYI: the ticket is simply
random base62 string (see db.NewPrivateId).

This change also necessitated a minor change to services.  We need to
return an empty response instead of nil, nil when there are no errors
and the response is empty.

* refactor (handlers): Rename gRPC Gateway filter

Originally, this was called an OutgoingInterceptor, which is an
unfortunate name since it's not an interceptor.  Now that we're
refactoring the gateway stuff and have proper interceptors, renaming
this should remove ambiguity

* refactor: Rework how 204 with empty msg is handled

Recent changes to grpc gateway has necessitated a change to how
204s are handled by the gateway

* tests (bats): Check status codes for delete operations
2021-10-19 17:21:41 -04:00

41 lines
1.0 KiB
Protocol Buffer

syntax = "proto3";
package errors.v1;
option go_package = "github.com/hashicorp/boundary/internal/gen/errors;errors";
import "controller/api/v1/error.proto";
// Err is a protobuf representation of a domain error
message Err {
// code is the error's code, which can be used to get the error's
// errorCodeInfo, which contains the error's Kind and Message
uint32 code = 10;
// msg for the error
string msg = 20;
// op represents the operation raising/propagating an error and is optional.
string op = 30;
// wrapped represents an optionally wrapped error
oneof wrapped {
// err is a wrapped Err (aka a domain error)
Err err = 40;
// std_error is a wrapped std error
string std_error = 50;
// no error or err is wrapped
bool none = 60;
}
}
// ApiError is a protobuf representation of a controller ApiError
message ApiError {
// api_error is the controller ApiError
controller.api.v1.Error api_error = 10;
// status is the status code assocatiated with the api error
int32 status = 20;
}