connect

README

connect

GRPC connections utils.

Basic usage

import (
  "libs.altipla.consulting/connect"
)

Documentation

Index

• func Insecure(address string, opts ...grpc.DialOption) (*grpc.ClientConn, error)
• func Internal(endpoint Endpoint, opts ...grpc.DialOption) (*grpc.ClientConn, error)
• func Local(address, clientID, clientSecret string, opts ...grpc.DialOption) (*grpc.ClientConn, error)
• func OAuthToken(address, clientID, clientSecret string, opts ...grpc.DialOption) (*grpc.ClientConn, error)
• func Remote(address RemoteAddress, opts ...grpc.DialOption) (*grpc.ClientConn, error)
• func WithBearer(bearer string) grpc.DialOption
• type Endpoint
• type RemoteAddress

Functions

func Insecure

func Insecure(address string, opts ...grpc.DialOption) (*grpc.ClientConn, error)

Insecure opens an insecure local connection to debug in the dev machines. Unsuitable for production because everything would have to be in the same Kubernetes cluster.

func Internal

func Internal(endpoint Endpoint, opts ...grpc.DialOption) (*grpc.ClientConn, error)

func Local

func Local(address, clientID, clientSecret string, opts ...grpc.DialOption) (*grpc.ClientConn, error)

Local opens a connection to the nearest endpoint. In development it uses an insecure local channel and in production it uses the client credentials to request an OAuth2 token from BeAuth.io and authenticates every request with it.

func OAuthToken

func OAuthToken(address, clientID, clientSecret string, opts ...grpc.DialOption) (*grpc.ClientConn, error)

OAuthToken opens a connection using OAuth2 tokens obtained from BeAuth.io users or clients.

func Remote

func Remote(address RemoteAddress, opts ...grpc.DialOption) (*grpc.ClientConn, error)

func WithBearer

func WithBearer(bearer string) grpc.DialOption

Types

type Endpoint

type Endpoint = services.Endpoint

type RemoteAddress

type RemoteAddress string