sdp-api-client-go

README

Appgate SDP golang api client

this repository contains a Go API client for the Appgate API. The code is generated using openapi-generator and apigentools.

Installation

go get -u github.com/appgate/sdp-api-client-go/api/v20/openapi

Version compatibility matrix

Each appliance version has a minimum of compatibility with 2 API versions back.

Appliance Version	API Version
6.1.*	18
6.2.*	19
6.3.*	20
6.4.*	21

Getting started

Example usage

Example usage how to create the client and get auth token.

package main

import (
	"context"
	"crypto/tls"
	"fmt"
	"net"
	"net/http"
	"time"

	"github.com/appgate/sdp-api-client-go/api/v19/openapi"
	"github.com/google/uuid"
)

const (
	version  = 21
	timeout  = 10
	insecure = true
	provider = "local"
	username = "admin"
	password = "admin"
	address  = "https://controller.appgate.com/admin"
)

func main() {
	timeoutDuration := time.Duration(timeout)
	tr := &http.Transport{
		TLSClientConfig: &tls.Config{
			InsecureSkipVerify: insecure,
		},
		Dial: (&net.Dialer{
			Timeout: timeoutDuration * time.Second,
		}).Dial,
		TLSHandshakeTimeout: timeoutDuration * time.Second,
	}

	httpclient := &http.Client{
		Transport: tr,
		Timeout:   ((timeoutDuration * 2) * time.Second),
	}

	clientCfg := &openapi.Configuration{
		DefaultHeader: map[string]string{
			"Accept": fmt.Sprintf("application/vnd.appgate.peer-v%d+json", version),
		},
		Debug: true,
		Servers: []openapi.ServerConfiguration{
			{
				URL: address,
			},
		},
		HTTPClient: httpclient,
	}

	client := openapi.NewAPIClient(clientCfg)
	ctx := context.TODO()

	loginOpts := openapi.LoginRequest{
		ProviderName: provider,
		Username:     openapi.PtrString(username),
		Password:     openapi.PtrString(password),
		DeviceId:     uuid.New().String(),
	}

	loginResponse, _, err := client.LoginApi.LoginPost(ctx).LoginRequest(loginOpts).Execute()
	if err != nil {
		panic(err)
	}

	fmt.Printf("Bearer %s", *openapi.PtrString(*loginResponse.Token))
}

More examples can be seen in examples directory.

Code generation

Requirements

- go 1.20
- python
- [apigentools](https://github.com/DataDog/apigentools) v1.6.0
- docker (with userns enabled)

bash generate_spec.bash