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.

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