DEV Community: Alexey Vasyukov

ezy – open-source gRPC client, alternative to Postman and Insomnia

Alexey Vasyukov — Wed, 08 Feb 2023 16:47:57 +0000

getezy / ezy

🔥 GUI client for gRPC/gRPC-Web

Fully-featured desktop gRPC/gRPC-Web client.

🚧 This project is in beta phase and can get breaking changes at any time until it goes to v1.

Features

✅ Tabs
✅ Shortcuts
✅ Environments
✅ Persisted collections

gRPC	gRPC-Web
Unary Calls	✅	✅
Server Streaming	✅	✅
Client Streaming	✅	❌ read
Bi-directional Streaming	✅	❌ read
Stream cancelation	✅	✅
Metadata	✅	✅ Browser Headers
TLS (Server-side/Mutual) with CA/Self-Signed certificates	✅	✅

Getting started

Install the latest version for your OS from release page.

Today you can update only by manually downloading new app version and reinstalling it. I'm working on automatic updates.

Shortcuts

Use ⌘+K (macOS) or Ctrl+K(Windows/Linux). Just try it.

Working with 64-bit integers

If you want to send 64-bit integers (int64, uint64, sint64, fixed64, sfixed64) just wrap values in quotes.

{
  "int64": "9223372036854775807"
  "uint64": "18446744073709551615

…

View on GitHub

In this release I have concentrated on user experience:

Full support of shortcuts
Reworked collections management
Notifications
Improved UX

gRPC clients I’ve worked with had drawbacks and didn’t fit my use-case in a way I was expecting, since I’ve started working with gRPC 3+ years ago.

Since then, I wanted a tool that fits any need in gRPC world. This is why I created ezy.

Compared to Insomnia and Postman, ezy offers better streams support, allows you to use Server-Side and Mutual TLS with custom TLS certificates, works with gRPC-Web and has a more slick UI/UX.

If you are looking for a gRPC/gRPC-Web client which fits your needs, give ezy a chance!

I’d love to hear your feedback and answer any questions regarding ezy.

ezy – open-source gRPC client, alternative to Postman and Insomnia

Alexey Vasyukov — Thu, 08 Dec 2022 21:28:12 +0000

https://github.com/getezy/ezy

In this release I have concentrated on user experience:

Full support of shortcuts
Reworked collections management
Notifications
Improved UX

gRPC clients I’ve worked with had drawbacks and didn’t fit my use-case in a way I was expecting, since I’ve started working with gRPC 3+ years ago.

Since then, I wanted a tool that fits any need in gRPC world. This is why I created ezy.

Compared to Insomnia and Postman, ezy offers better streams support, allows you to use Server-Side and Mutual TLS with custom TLS certificates, works with gRPC-Web and has a more slick UI/UX.

If you are looking for a gRPC/gRPC-Web client which fits your needs, give ezy a chance!

I’d love to hear your feedback and answer any questions regarding ezy.

How to setup and test TLS in gRPC/gRPC-Web

Alexey Vasyukov — Mon, 29 Aug 2022 19:54:41 +0000

This article has samples in Node.JS but can be helpful for other languages, so lets start. All working examples you can find here.

How TLS works?

I recommend to read the best comic-article about how TLS works.

gRPC connection types

There are three types for gRPC connections you can use:

Insecure — all data transmitted without encryption.
Server-Side TLS — browser like encryption, where only the server provides TLS certificate to the client.
Mutual TLS — most secure, both the server and the client provides there certificates to each other.

Creating Self-Signed certificates

This is optional step if you don’t have certificate from any CA’s or want to work with TLS on localhost.

Note that in production environment is mostly recommended to choose CA’s certificate for more security, for example you can get free certificate from Let’s Encrypt.

Preparation

Let’s start from implementing our gRPC service.

First, we will define our service Protocol Buffers file.

Second, we need to generate types, service and client definitions.
For TypeScript I prefer to use ts-proto, but you can choose any tool you like depends on your language.

protoc --plugin=./node_modules/.bin/protoc-gen-ts_proto --ts_proto_opt=env=node,outputServices=grpc-js --ts_proto_out=./src/generated ./proto/tls_service.proto

Now we can implement our server running on Node.js.

gRPC

We will use an official @grpc/grpc-js package both for server and client side here.

Server-Side TLS

Server-Side TLS requires only the server certificate and it’s private key.

Server

Client

Now we can implement the client side.

Note here that if your TLS certificate signed with CA (not Self-Signed) you don’t need to provide this certificate on the client, it should automatically works.

Mutual TLS

Mutual TLS requires the root certificate, server certificate and it’s private key.
Root certificate would be used here for checking that client certificate is signed and the server can trust to the client.

Server

Like in Server-Side section, changed only getServerCredentials function.

Client

Like in Server-Side section, changed only getChannelCredentials function.

Override SSL target name

@grpc/grpc-js package additionally provides some useful channel options that you can set. You can read about each of them here.

grpc.ssl_target_name_override — would be helpful for us when the actual server behind the proxy and CN don’t match.

To setup channel options you need to pass them into client constructor’s third argument.

gRPC-Web

Read the grpc.io blog post about the state of gRPC-Web.

TL;DR
The things you should know:

Working scheme:
Client ↔ Proxy [HTTP(S) gRPC-Web] ↔ Server (gRPC)
There are two implementations — official gRPC-Web and @improbable-eng/grpc-web.
Right now gRPC-Web supports only Unary and Server-Streaming requests over HTTP(S).

Additionally @improbable-eng/grpc-web supports client-side and bi-directional streaming with an experimental websocket transport. This is not part of the gRPC-Web spec, and is not recommended for production use.
There are two proxies — Envoy with gRPC-Web filter from official gRPC-Web and grpcwebproxy from @improbable-eng.
You can use either client with either proxy.
Clients have different communication transports.

Official gRPC-web supports only XMLHttpRequest.
@improbable-eng/grpc-web additionally support Fetch (using it if available) and can be extended with custom transport, for example Node.js.

In this example we will use Envoy proxy running in docker.

Server-Side TLS

Server

As you already noticed we need to start our gRPC service behind the proxy. So there is nothing to change, simply start service with Server-Side TLS we discuss earlier.

After that we need to setup envoy and start it.

docker-compose up envoy-server

That’s it. Your gRPC-Web proxy with Server-Side TLS will be available at https://0.0.0.0:8080.

Mutual TLS

Server

The hack here is to start gRPC service with Server-Side TLS but on envoy side check the client certificate signed by trusted CA.

docker-compose up envoy-mutual

Great! Your gRPC-Web proxy with Mutual TLS will be available at https://0.0.0.0:8080.

Testing both gRPC and gRPC-Web requests

Recently I released a multi-platform desktop gRPC / gRPC-Web client called ezy. I’m working with gRPC every day and there is no any fully featured, UI/UX-perfect clients for gRPC testing, so I tried to create one.

This client has fully featured support of gRPC / gRPC-Web. I would be appreciate if you try it.

🙏 If you have any feedback or ideas feel free to open discussion.

ezy - desktop gRPC client

Alexey Vasyukov — Sat, 13 Aug 2022 17:01:46 +0000

Hi! I just released new desktop gRPC client called ezy.

Why another one?
I'm working with gRPC every day and for my opinion all existed GUI clients do not well designed or do not have fully gRPC features support. And some of them like BloomRPC unfortunately are unmaintained.

ezy

Features

✅ Localy persisted collections.
✅ Multi-tabs.
✅ Environments.

gRPC

✅ Unary calls.
✅ Client/Server/Bidirectional streaming.
✅ Metadata support.
✅ TLS (Server-side/Mutual) support.
✅ Good errors output.

Plans

Actual roadmap available here.

If you are interested in this project, please share your feedback/ideas here or in discussions 🙏