gproxy

README

gproxy

a library for creating lets-encrypt secured gRPC and http reverse proxies

go get -u github.com/graphikDB/gproxy

Documentation

Index

• type Middleware
• type Opt
  • func WithGRPCRoutes(router RouterFunc) Opt
  • func WithHTTPRoutes(router RouterFunc) Opt
  • func WithHostPolicy(policy autocert.HostPolicy) Opt
  • func WithInsecurePort(insecurePort int) Opt
  • func WithLogger(logger *logger.Logger) Opt
  • func WithMiddlewares(middlewares ...Middleware) Opt
  • func WithSecurePort(securePort int) Opt
  • func WithStreamInterceptors(sinterceptors ...grpc.StreamServerInterceptor) Opt
  • func WithUnaryInterceptors(uinterceptors ...grpc.UnaryServerInterceptor) Opt
• type Proxy
  • func New(ctx context.Context, opts ...Opt) (*Proxy, error)
  • func (p *Proxy) Serve(ctx context.Context) error
• type RouterFunc

Examples

• New

Types

type Middleware

type Middleware func(handler http.Handler) http.Handler

Middleware is an http middleware

type Opt

type Opt func(p *Proxy)

Opt is a function that configures a Proxy instance

func WithGRPCRoutes

func WithGRPCRoutes(router RouterFunc) Opt

WithGRPCRoutes sets the gRPC RouterFunc which takes a hostname and returns an endpoint to route to. either http routes, gRPC routes, or both are required.

func WithHTTPRoutes

func WithHTTPRoutes(router RouterFunc) Opt

WithHTTPRoutes sets the http RouterFunc which takes a hostname and returns an endpoint to route to either http routes, gRPC routes, or both are required.

func WithHostPolicy

func WithHostPolicy(policy autocert.HostPolicy) Opt

WithHostPolicy sets the host policy function on the proxy(required)

func WithInsecurePort

func WithInsecurePort(insecurePort int) Opt

WithInsecurePort sets the port that non-encrypted traffic will be served on(optional)

func WithLogger

func WithLogger(logger *logger.Logger) Opt

WithLogger sets the proxies logger instance(optional)

func WithMiddlewares

func WithMiddlewares(middlewares ...Middleware) Opt

WithMiddlewares sets the http middlewares on encrypted & non-encrypted traffic(optional)

func WithSecurePort

func WithSecurePort(securePort int) Opt

WithSecurePort sets the port that encrypted traffic will be served on(optional)

func WithStreamInterceptors

func WithStreamInterceptors(sinterceptors ...grpc.StreamServerInterceptor) Opt

WithStreamInterceptors adds gRPC stream interceptors to the proxy instance

func WithUnaryInterceptors

func WithUnaryInterceptors(uinterceptors ...grpc.UnaryServerInterceptor) Opt

WithUnaryInterceptors adds gRPC unary interceptors to the proxy instance

type Proxy

type Proxy struct {
	// contains filtered or unexported fields
}

Proxy is a secure(lets encrypt) gRPC & http reverse proxy

func New

func New(ctx context.Context, opts ...Opt) (*Proxy, error)

New creates a new proxy instance. A host policy & either http routes, gRPC routes, or both are required.

Example

package main

import (
	"context"
	"fmt"
	"github.com/graphikDB/gproxy"
	"net/http"
	"net/http/httptest"
	"time"
)

func main() {
	ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
	defer cancel()

	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		w.Write([]byte("hello world"))
	}))

	proxy, err := gproxy.New(ctx,
		gproxy.WithInsecurePort(8080),
		gproxy.WithHTTPRoutes(func(ctx context.Context, host string) string {
			return srv.URL
		}),
		gproxy.WithHostPolicy(func(ctx context.Context, host string) error {
			return nil
		}))
	if err != nil {
		fmt.Println(err.Error())
		return
	}
	if err := proxy.Serve(ctx); err != nil {
		fmt.Println(err.Error())
		return
	}
}

func (*Proxy) Serve

func (p *Proxy) Serve(ctx context.Context) error

Serve starts the gRPC(if grpc router was registered) & http proxy(if http router was registered)

type RouterFunc

type RouterFunc func(ctx context.Context, host string) string

RouterFunc takes a hostname and returns an endpoint to route to