provision

README

Mainflux Things and Channels Provisioning Tool

A simple utility to create a list of channels and things connected to these channels with possibility to create certificates for mTLS use case.

This tool is usefule for testing, and it creates a TOML format output (on stdout, can be redirected into the file of needed) that can be used by Mainflux MQTT benchmarking tool (mqtt-bench).

Usage

./provision --help
Tool for provisioning series of Mainflux channels and things and connecting them together.
Complete documentation is available at https://mainflux.readthedocs.io

Usage:
  provision [flags]

Flags:
      --ca string         CA for creating and signing things certificate (default "ca.crt")
      --cakey string      ca.key for creating and signing things certificate (default "ca.key")
  -h, --help              help for provision
      --host string       address for mainflux instance (default "https://localhost")
      --num int           number of channels and things to create and connect (default 10)
  -p, --password string   mainflux users password
      --ssl               create certificates for mTLS access
  -u, --username string   mainflux user

Example:

./provision -u mirkot@mainflux.com -p test1234 --host https://142.93.118.47

If you want to create a list of channels with certificates:

./provision --host http://localhost --num 10 -u test@mainflux.com -p test1234 --ssl true --ca ../../docker/ssl/certs/ca.crt --cakey ../../docker/ssl/certs/ca.key

ca.crt and ca.key are used for creating things certificate and for HTTPS, if you are provisioning on remote server you will have to get these files to your local

Example of output:

[[mainflux]]
  ChannelID = "42053920-439a-461f-bd81-dece1ef06089"
  ThingID = "49f3c38c-400e-4171-a954-24850150124b"
  ThingKey = "835d74ab-7232-49b7-bc6d-a1ca97c6eecc"
  MTLSCert = "-----BEGIN CERTIFICATE-----\nMIIFmDCCA4CgAwIBAgIQVvvHUH9XPYMGF2F/YzfxFzANBgkqhkiG9w0BAQsFADBX\nMRIwEAYDVQQDDAlsb2NhbGhvc3QxETAPBgNVBAoMCE1haW5mbHV4MQwwCgYDVQQL\nDANJb1QxIDAeBgkqhkiG9w0BCQEWEWluZm9AbWFpbmZsdXguY29tMB4XDTE5MDgw\nNzIwMzU0NVoXDTE5MDgwNzIwMzU0NVowVTERMA8GA1UEChMITWFpbmZsdXgxETAP\nBgNVBAsTCG1haW5mbHV4MS0wKwYDVQQDEyQ4MzVkNzRhYi03MjMyLTQ5YjctYmM2\nZC1hMWNhOTdjNmVlY2MwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDC\nhC/TAiiE2OKug73B5lWxUfzpUfukIIl+Ge8Xz6CIqzGlvPoggpCm5igZUC5YTpg4\neIC550kyq8pLDZzck/f7Qq0aJq3wBYLtA64XzfTrG84MI+yt3mniKYmZQInW1GXC\nStS+jzAnhTPr5urnMaPLm5g9UTlvMN6TwRMlf4kSlSCR0KN0kKH6yRU9MEEwvt+2\nTu5RWLN1LwZzG5ud0AAjT5CL08akloUpSEt1KLY2c7uf9l/1upkxBmhKoSs0sRW0\n25aX6c0qLOnKDRrsUKI8YbYkKAKsRtGRPl9q1j/Im4mE/9EwGgibdwVItz2Pmq/k\nOQjZ+f3tEKXwRD3yK9Aas1u/K5tf35aK5Eznr1f2FyM8uQ2SyEcXVikYA32hoI6W\nQRkTTlueG4K2H/KN2KL5MC+N7h17Bw5ZCS0201xnhDLjTaeGFr0SibFHJA8IVOeL\npTKohB4r1gAOKqzIQ3IYdJ/3jk31SxGw7Et3QBs+wxyUHLCalBFIk4R+GC276Buk\nFR3fFOIsm5+f5udZTYrikW0dWXHxhhSOFlTurQP5aS0K5HpdwnOkMWTKYMwmwHut\nxF9ycPc5gCjBC8wPGbrCkA9XJdKw+VTySg6tTgEnyLvkccdi07Fs13qQcT1MK2sv\nf9qEVdVBRnsB1i2vffHRF3j5RGK1hbKO1AX4fICJMQIDAQABo2IwYDAOBgNVHQ8B\nAf8EBAMCB4AwHQYDVR0lBBYwFAYIKwYBBQUHAwIGCCsGAQUFBwMBMA4GA1UdDgQH\nBAUBAgMEBjAfBgNVHSMEGDAWgBRs4xR91qEjNRGmw391xS7x6Tc+8jANBgkqhkiG\n9w0BAQsFAAOCAgEAcZjTZLAPOr9Xm7ASxieAj5pdoRKz5Q3y4kZ2oCJ/BtIfN25C\nTEuRvNLkLZHZo/ZeOU0XyNfpHiOqc0J4R2zgrpdncH0+viC22bhcec95+fNrES+G\nGpbw0BufFPcn0cDeJQbtg//4eeCiXaNZgui8Og9t2D4TgYPwPmi4l6tYXDpMUaT0\n5Vrr6VXezbHUpDtSaG2aoo4Z7nrEhtXKnYlpo8htEbCH8S3zxbmWx3bn8gS8Dsr9\nSyqSxiAMYjIBxwCmgTi6iaINmSHxtMhqU5mmPVBa1vZBiNBQlvW2Yslvl0aMdgVD\nLzz8JULXBuKwIdHAbmrDgXvQAtRRJ34X9q4X5QjzMZgCvHwoHrj2yg2VbUnuSnmv\npJojiwZI0Mj/7y9gPGa6aBl10chs9d7V5Kaqm2qSGd/1Zf6ndSiK8P5YubP4Bvc9\nFtPgO87rbrjMmg84Trrm4EnMakQodr8GIFcQA1XqgYTrTrhlgF80/zqisN+7p80u\nfftd34IEBCOsP8ANPpxOaqOCSU+G6NbW2K6l8NYj2jhrF/cXgze25X7mMXyWj3jf\nkF0yHX8PScts1DVlx5064rrGoVQfD147m01SjWa+uqE2tD3mr9mc5QnvNdZph1CO\n3ca2jOhC2wfvqSh8cwBtGMLc1nU7K8p9qmtn3+bfL4oedwfMvyLHsa4Ggrg=\n-----END CERTIFICATE-----\n"
  MTLSKey = "-----BEGIN RSA PRIVATE KEY-----\n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
  -----END RSA PRIVATE KEY-----"

Documentation

Index

• func Provision(conf Config)
• type Config
• type MfConn

Functions

func Provision

func Provision(conf Config)

Provision - function that does actual provisiong

Types

type Config

type Config struct {
	Host     string
	Username string
	Password string
	Num      int
	SSL      bool
	CA       string
	CAKey    string
	Prefix   string
}

Config - provisioning configuration

type MfConn

type MfConn struct {
	ChannelID string
	ThingID   string
	ThingKey  string
	MTLSCert  string
	MTLSKey   string
}

MfConn - structure describing Mainflux connection set