Skip to content

The is an Golang library designed to interface with the UniFi Network Application dashboard, facilitating the automated generation and fetching of new vouchers for WiFi hotspot landing pages.

License

Notifications You must be signed in to change notification settings

jeremyforan/UnifiVoucherGenerator

Repository files navigation

UniFi Network Application - Go Voucher Generator

Origin Story

After setting up Ubiquiti access points at my place, I aimed to offer straightforward Guest Wi-Fi. I didn't want to use a PSK. However, I also needed to ensure that only people inside my home could use it, avoiding external access. To solve this, I introduced a button that generates a small voucher code upon being pressed.

Please note this does not work if MFA is enabled.

Overview

The is an open-source Golang library designed to interface with the UniFi Network Application dashboard, facilitating the automated generation and fetching of new vouchers for WiFi hotspot landing pages.

By enabling the programmatic generation of vouchers, this library hopes to broaden the scope for creating better guest Wi-Fi experiences.

Installation

go get -u github.com/jeremyforan/UnifiVoucherGenerator

Usage

A basic example of the library creating a basic voucher.

package main

import (
	"fmt"
	"github.com/jeremyforan/UnifiVoucherGenerator"
	"github.com/jeremyforan/UnifiVoucherGenerator/voucher"
	"log/slog"
	"net/url"
)

func main() {

	// URL of the Unifi controller.
	baseUrl, err := url.Parse("https://127.0.0.1:8443")
	if err != nil {
		panic(err)
	}

	// Create a new client with the username, password, and URL of the Unifi controller.
	client := UnifiVoucherGenerator.NewClient("user@email.com", "p455w0rd", baseUrl)

	// Login to the Unifi controller.
	err = client.Login()
	if err != nil {
		slog.Info("Failed to login to Unifi controller")
		panic(err)
	}

	// Create a new voucher with default settings.
	v := voucher.NewDefaultVoucher()

	// Add the Voucher to the Unifi controller.
	err = client.AddVoucher(v)
	if err != nil {
		slog.Error("unable to add voucher")
		panic(err)
	}

	fmt.Println(v.AccessCode())
}

Vouchers

The Voucher struct represents the same set of properties , as outlined in the new voucher prompt.

There are three types of vouchers:

Single-use

v := voucher.NewSingleUseVoucher()

Multi-use

# 5 use, Multi-use voucher.
v := voucher.NewMultiUseVoucher(5)

Unlimited

v := voucher.NewUnlimitedUseVoucher()

Default Voucher

A default voucher has the following criteria

v := voucher.NewDefaultVoucher()
Field Value
Name UUIDv4
Quota Single-use
Expiration 24 Hours
Data Limit unlimited
Download Limit unlimited
Upload Limit unlimited

Expiration

You can set the expiry of a voucher using the SetExpire method.

v := voucher.NewDefaultVoucher()

// Voucher will expire 7 days from the moment a guest enters it into the landing page.
v.SetExpire(7, voucher.Days)

// Voucher will expire 8 hours from the moment a guest enters it into the landing page.
v.SetExpire(8, voucher.Hours)

// Voucher will expire 59 minutes from the moment a guest enters it into the landing page.
v.SetExpire(59, voucher.Minutes)

Network Limits

You can set the network usage limits with the following:

v := voucher.NewDefaultVoucher()

// Set download to 10Mbps and upload to 2Mbps
v.SetDownloadLimitMbps(10)
v.SetUploadLimitMbps(2)

// Set data limit to 100MB
v.SetDataLimitMB(100)

Contributions

Pull requests are welcome. Feel free to...

  • Revise documentation
  • Add new features
  • Fix bugs
  • Suggest improvements

Limitations

Feedback

Pull requests are welcome. Feel free to...

  • Revise documentation
  • Add new features
  • Fix bugs
  • Suggest improvements

License

MIT

About

The is an Golang library designed to interface with the UniFi Network Application dashboard, facilitating the automated generation and fetching of new vouchers for WiFi hotspot landing pages.

Topics

Resources

License

Stars

Watchers

Forks

Languages