gonnect

atlas-gonnect : An Atlassian Connect Framework written in Golang

Overview

Atlas-Gonnect is an Atlassian Connect Framework written in Golang, inspired by the Atlassian Connect Spring Boot Framework as well as the Atlassian Connect Express Framework. The implementation of Atlas-Gonnect is heavily inspired by the letter one.

This project is not associated with Atlassian.

Install

go get github.com/sumeet70/atlas-gonnect

Example

atlas-gonnect currently uses/depends on https://github.com/gorilla/mux, which serves as router for our webserver.

A minimal example looks like this:

// We need the config as well as the atlassian-connect-descriptor as an io.Reader
config, err := os.Open("config.json")
if err != nil {
        panic(err)
}
descriptor, err := os.Open("atlassian-connect.json")
if err != nil {
        panic(err)
}

// Now, we can initialize the addon.
addon, err := gonnect.NewAddon(config, descriptor)

// We create a new mux-router
router := mux.NewRouter()

// And insert the default request middleware - this middleware should be used on
// every request/route going to the server
router.Use(middleware.NewRequestMiddleware(addon, make(map[string]string)))

// Register the default routes of atlas-gonnect; note that routes is the package
// github.com/sumeet70/atlas-gonnect/routes
routes.RegisterRoutes(addon, router)

// To register an route secured by JWT Authentification, use the AuthentificationMiddleware
router.Handle(
        "/hello-world",
        // note that middleware is the package github.com/sumeet70/atlas-gonnect/middleware
        middleware.NewAuthenticationMiddleware(addon, false)(
                http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
                        // Do stuff here
                }),
        ),
)
http.ListenAndServe(":"+strconv.Itoa(addon.Config.Port), router)

For a full example, see my atlas-gonnect-confluence-example.

request context

The request middleware of gonnect is using context to expose some important values to the programmer.

The following keys are set (with the following types):

If the authentication-middleware was used (and successful), the following keys are set:

Usage:

hostBaseUrl, ok := r.Context().Value("hostBaseUrl").(*hostrequest.HostRequest)
if !ok {
    ...
}

Host-Request

I know that httpClient is in fact NO httpClient. It will be renamed in the future.

atlas-gonnect also to do requests to the confluence/jira instance. You can either act as addon, but it also supports user impersonation.

In a request, you can get the httpClient by calling hostRequest.FromRequest. Then, you create a new request using http.NewRequest and modify it, if you want to.

Then, you pass it into the httpClient, using AsAddon(request) or AsUser(request, userAccountId). The credentials as well the hostBaseUrl will be added.

Use the http.DefaultClient to execute an request.

httpClient, _ := hostrequest.FromRequest(r) // This is just an example; Normally, you should handle the second argument/error here
request, _ := http.NewRequest("GET", "/rest/api/content", http.NoBody)
httpClient.AsAddon(request) // returns pointer to request and an error/nil; should be handled
// OR
httpClient.AsUser(request, r.Context().Value("userAccountId").(string))
response, _ := http.DefaultClient.Do(request)
log.Println(response)

Author

Original Author Fabian Siegel Additions made by Sumeet Singh

License

Apache 2.0.