tenant

Overview ¶

Package tenant contains functions to determine for which tenant a request should be served.

As soon as an App is registered in d.velop cloud requests for ALL tenants which booked the app are routed to the App. So each App MUST be able to serve requests for multiple tenants concurrently.

Each request contains http headers (x-dv-tenant-id, x-dv-baseuri, x-dv-sig-1) which MUST be evaluated by the App to determine the tenant for which the request is meant.

The tenant-id is meant as a stable and unique identifier for a tenant which doesn't change over time. It can be used to store tenant specific data.

The systemBaseUri is the baseadress of the system for the particular tenant. It MUST be used if an App makes requests to other Apps on behalf of a tenant.

This package contains functions which read the tenant information from a request and put them in the context.

Example:

func main() {
	mux := http.NewServeMux()
	// NOTE: Each App gets it's own signature secret. So please change the following code accordingly and do not share your secret!
	mux.Handle("/hello", tenant.AddToCtx(os.Getenv("systemBaseUri"), base64.StdEncoding.DecodeString("U2VjcmV0"))(helloHandler()))
}

func helloHandler() http.Handler {
	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		// get systembaseuri from context
		systembaseuri,_ := tenant.SystemBaseUriFromCtx(r.Context())
		// get tenant id from context
		tenant,_ := tenant.IdFromCtx(r.Context())
	})
}