GRPC-server basic usage
Gnetcli 'server' is a GRPC-server for interacting with non-Go projects and other automations.
The server supports basic auth for clients, executing commands in stream mode, upload and downloading.
Authentication on a device can be specified as a part of Exec()
RPC or using -dev*
arguments.
See GRPC-server calls description in server.proto.
Installation:
go install github.com/annetutil/gnetcli/cmd/gnetcli_server@latest
Starting:
server -debug -basic-auth mylogin:mysecret
Exec a command on a device using grpcurl
:
TOKEN=$(echo -n "$LOGIN:$PASSWORD" | base64)
grpcurl -H "Authorization: Basic $TOKEN" -plaintext -d '{"host": "hostname", "cmd": "dis clock", "host_params": {"device": "juniper", "credentials": {"login": "test", "password": "test"}}, "string_result": true}' localhost:50051 gnetcli.Gnetcli.Exec
Help
Usage of server:
-basic-auth string
Authenticate client using Basic auth
-cert-file string
The TLS cert file
-debug
set debug log level
-dev-enable-agent
Enable pubkey auth using ssh-agent
-dev-login string
Authenticate password
-dev-password string
Authorization password
-key-file string
The TLS key file
-port int
The server port (default 50051)
-tls
Connection uses TLS if true, else plain TCP