idp-plugin-sdk

idp-plugin-sdk

This SDK enables building aserto idp plugins using Go.

Tools

• Git
• Go 1.17
• Mage

Building

Mage is used as a tool for building and testing etc.

List available mage targets:

mage -l

Check that your code is compiling:

mage build

Testing

mage test

Linting

mage deps
mage lint

Developing plugins

To start developing your own plugin, you need to implement PluginHandler and call plugin.Serve from your main func.

package main

import (
	"log"

	"github.com/aserto-dev/idp-plugin-sdk/examples/dummy/pkg/srv"
	"github.com/aserto-dev/idp-plugin-sdk/plugin"
)

func main() {

	dummyPlugin := srv.NewDummyPlugin()

	options := &plugin.PluginOptions{
		PluginHandler: dummyPlugin,
	}

	err := plugin.Serve(options)
	if err != nil {
		log.Println(err.Error())
	}
}

For a plugin example, check out aserto-idp-plugin-dummy

License

Apache 2.0 License