keygen webpage

Author: pierre-b

keygen_function/.gcloudignore

@@ -0,0 +1,56 @@
+# The .gcloudignore file for a Google Cloud Function deployment
+# This file specifies files to ignore when deploying
+
+# Binaries for programs and plugins
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binary, built with `go test -c`
+*.test
+
+# Output of the go coverage tool
+*.out
+
+# Dependency directories
+vendor/
+
+# Go workspace files
+go.work
+go.work.sum
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+*.log
+
+# Local development files
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Temporary files
+tmp/
+temp/
+
+# Documentation
+README.md
+*.md

keygen_function/README.md

@@ -0,0 +1,84 @@
+# PASETO v4 Key Generator - Google Cloud Function
+
+This Google Cloud Function serves a web page that generates PASETO v4 asymmetric key pairs. It provides both a user-friendly web interface and a REST API for key generation.
+
+## Features
+
+- **Web Interface**: Beautiful, responsive HTML page for generating keys
+- **REST API**: POST endpoint for programmatic key generation
+- **Secure**: Uses the same PASETO v4 library as the main application
+- **Copy to Clipboard**: Easy copying of generated keys
+- **Security Warnings**: Clear warnings about private key handling
+
+## Local Development
+
+1. Install dependencies:
+
+   ```bash
+   go mod tidy
+   ```
+
+2. Run locally using the Functions Framework:
+
+   ```bash
+   go run function.go
+   ```
+
+   Or install the Functions Framework CLI:
+
+   ```bash
+   go install github.com/GoogleCloudPlatform/functions-framework-go/funcframework/cmd/function@latest
+   function --target KeygenFunction --source .
+   ```
+
+3. Open http://localhost:8080 in your browser
+
+## Deployment
+
+Deploy to Google Cloud Functions:
+
+```bash
+gcloud functions deploy keygen-function \
+  --runtime go121 \
+  --trigger-http \
+  --entry-point KeygenFunction \
+  --allow-unauthenticated \
+  --source .
+```
+
+## API Usage
+
+### GET /
+
+Returns the HTML interface for key generation.
+
+### POST /
+
+Generates a new PASETO v4 key pair.
+
+**Response:**
+
+```json
+{
+  "privateKey": "base64-encoded-private-key",
+  "publicKey": "base64-encoded-public-key"
+}
+```
+
+**Example:**
+
+```bash
+curl -X POST https://your-function-url/
+```
+
+## Security Considerations
+
+- **Private Key Security**: The private key should be kept secret and stored securely
+- **HTTPS Only**: Always use HTTPS in production
+- **Access Control**: Consider adding authentication for production use
+- **Key Storage**: Never store private keys in client-side code or public repositories
+
+## Dependencies
+
+- `aidanwoods.dev/go-paseto` - PASETO implementation
+- `github.com/GoogleCloudPlatform/functions-framework-go` - Google Cloud Functions framework

keygen_function/deploy.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+
+# Deploy PASETO v4 Key Generator to Google Cloud Functions
+
+set -e
+
+# Configuration
+FUNCTION_NAME="keygen-function"
+REGION="europe-west1"  # Belgium region
+PROJECT_ID="notifusev3"
+RUNTIME="go123"
+ENTRY_POINT="KeygenFunction"
+
+echo "🚀 Deploying PASETO v4 Key Generator to Google Cloud Functions..."
+
+# Set the project
+echo "📋 Setting project to $PROJECT_ID..."
+gcloud config set project $PROJECT_ID
+
+# Deploy the function (2nd gen for Go 1.23 support)
+gcloud functions deploy $FUNCTION_NAME \
+  --gen2 \
+  --runtime $RUNTIME \
+  --trigger-http \
+  --entry-point $ENTRY_POINT \
+  --allow-unauthenticated \
+  --source . \
+  --region $REGION \
+  --project $PROJECT_ID \
+  --memory 128Mi \
+  --timeout 60s
+
+echo "✅ Deployment complete!"
+echo ""
+echo "🌐 Function URL:"
+gcloud functions describe $FUNCTION_NAME --region $REGION --gen2 --format="value(serviceConfig.uri)"
+echo ""
+echo "📝 To test the function:"
+echo "  curl \$(gcloud functions describe $FUNCTION_NAME --region $REGION --gen2 --format=\"value(serviceConfig.uri)\")"