Generating Required Keys

Before installing SuprSend, you need to generate three essential keys for your deployment. These keys ensure secure communication and encryption between different components of SuprSend.

Generate Deployment Secret Key

This key is a unique random string used to authenticate and secure your SuprSend installation. Run the following Python script to generate a strong secret key:

python3

Then, in the interactive shell:

import secrets
"".join(secrets.choice("abcdefghijklmnopqrstuvwxyz0123456789!@#$%^&*(-_=+)") for i in range(50))

This will output a 50-character random secret string --- copy and store it securely. Example output: x2#e9ahb!@1d3f_4g5jklmn6opq7rstuv8wxyz

Keep this key private. It should never be committed to version control or shared publicly.

Generate NATS NKey Pair

SuprSend uses NATS as its internal messaging backbone.
You’ll need to generate a public/private key pair for secure message signing and validation.

Install the nk CLI tool for generating NATS keys:

go install github.com/nats-io/nkeys/nk@latest

Generate a new user key pair:
nk -gen user -pubout

You’ll get two keys: - Private Key → starts with SU... - Public Key → starts with U... Example output: SUAGC2U8QYUZ7A... (Private Key) UAGB2UZJBNFJZ3... (Public Key)

Store the private key securely - it must not be exposed or shared.
The public key can be shared with your SuprSend deployment configuration.

Generate AES Cipher Secret and Vector

SuprSend uses AES encryption for sensitive payloads.
You’ll need to generate a shared AES key and an initialization vector (IV). Run the following Python script:

python3

Then, inside the interactive shell:

def aes_cipher():
    import os
    shared_secret = os.urandom(32)
    iv = os.urandom(16)
    print("Shared Secret (AES Key):", shared_secret.hex())
    print("Vector (IV):", iv.hex())

aes_cipher()

You’ll get two hex-encoded values:

Shared Secret (AES Key): `3f2a9e5b1d0a6c4d4e7f9b1c2d3a4b5c6d7e8f90123456789abcdef1234567890`
Vector (IV): `1a2b3c4d5e6f70819283746556473829`

Save both values safely. They’ll be required in your SuprSend configuration under encryption settings.

Getting Started

Installation

Post-Installation

CLI & Automation

Updates and Versioning

Generate Deployment Secret Key

Generate NATS NKey Pair

Generate AES Cipher Secret and Vector

​Generate Deployment Secret Key

​Generate NATS NKey Pair

​Generate AES Cipher Secret and Vector

Generate Deployment Secret Key

Generate NATS NKey Pair

Generate AES Cipher Secret and Vector