9 Commits

Author SHA1 Message Date
0a3f4ab5ef added dynamic hostname to helpHandler
All checks were successful
/ push_to_registry (push) Successful in 51s
2026-01-17 21:59:54 +01:00
36ce60aa28 container sized down to 500px width
All checks were successful
/ push_to_registry (push) Successful in 52s
2026-01-17 21:44:01 +01:00
Florian Walther
d21b959104 58er Zeichensatz hinzugefügt 2026-01-17 13:13:09 +01:00
Florian Walther
2b822af907 deleted deprecated workflow 2026-01-17 12:57:04 +01:00
Florian Walther
2aa636409a Screenshot aktualisiert 2026-01-17 12:47:28 +01:00
Florian Walther
819af38886 added link to code repository
All checks were successful
/ push_to_registry (push) Successful in 49s
2026-01-17 12:09:26 +01:00
Florian Walther
65fe245e9f updated README 2026-01-17 11:58:02 +01:00
Florian Walther
8ebde5ffbc reorganising, added docker-compose.traefik.yml, split README 2026-01-17 11:51:02 +01:00
Florian Walther
eef425d7b7 3rd try with registry_url non hard coded
All checks were successful
/ push_to_registry (push) Successful in 49s
2026-01-17 10:23:37 +01:00
8 changed files with 198 additions and 145 deletions

View File

@@ -1,29 +0,0 @@
name: Docker Build and Push
#on: [push]
on:
workflow_dispatch:
jobs:
build-and-push:
runs-on: docker
if: branch == 'main'
steps:
- name: Checkout Repository
uses: actions/checkout@v4
- name: Login to Registry
run: |
echo "${{ secrets.REGISTRY_PASSWORD }}" | docker login ${{ secrets.REGISTRY_URL }} -u "${{ secrets.REGISTRY_USERNAME }}" --password-stdin
- name: Build Docker Image
run: |
docker build -t ${{ secrets.REGISTRY_URL }}/FlorianWalther/password-generator:latest .
- name: Push Docker Image
run: |
docker push ${{ secrets.REGISTRY_URL }}/FlorianWalther/password-generator:latest
- name: Cleanup
run: |
docker system prune -f

View File

@@ -14,7 +14,7 @@ jobs:
- name: Login to Gitea
uses: docker/login-action@v3
with:
registry: ${{ REGISTRY_URL }} # gitea.scu.si
registry: ${{ secrets.REGISTRY_URL }} # gitea.scu.si
username: ${{ gitea.actor }}
password: ${{ secrets.REGISTRY_PASSWORD }}

View File

@@ -4,52 +4,26 @@ _a web based password generator_
![App Screenshot](img/screenshot.png)
# Funktionsweise
## Features
* Passwortgenerierung: Die Anwendung generiert ein 32-stelliges Passwort mit Großbuchstaben, Kleinbuchstaben und Ziffern (entspricht dem Befehl `apg -a 1 -m 32 -n 1 -M NCL`).
* Zwischenablage: Mit dem Button "In Zwischenablage kopieren" wird das Passwort in die Zwischenablage kopiert.
* Docker: Der Container enthält nur die Go-Anwendung und keine zusätzliche Linux-Distribution.
* generates long and random, secure passwords (read about the [security considerations](SECURITY.md))
* copy to clipboard
* very small docker container, that only contains the application and has minimum attack surface
## Demo
# Baue die Go-Anwendung
There is a demo at [https://passwd.scu.si](https://passwd.scu.si)
## Usage
The follwoing example shows how to get up your own instance with `docker compose`.
```
go build -o password-generator ./
```
# Baue das Docker-Image
```
docker build -t password-generator .
```
# Starte den Docker Container
```
docker run -p 8080:8080 password-generator
```
## mit docker-compose
Ein `docker-compose.yml` wird mitgeliefert.
### initial pull
```
docker compose login gitea.scu.si
git clone https://gitea.scu.si/FlorianWalther/Web-Password.git
cd Web-Password
cp misc/docker-compose.yml ./
docker compose pull
```
### start up
```
docker compose up -d
```
### bring down
```
docker compose down
```
There are some more usage example in [misc/MoreUsage.md](misc/MoreUsage.md)

Binary file not shown.

Before

Width:  |  Height:  |  Size: 42 KiB

After

Width:  |  Height:  |  Size: 24 KiB

189
main.go
View File

@@ -9,8 +9,22 @@ import (
const (
passwordLength = 32
// Zeichensatz mit 62 möglichen Zeichen pro Position
chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"
//chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789!?$%&=#+<>-:,.;_*@"
// Zeichensatz mit 58 möglichen Zeichen pro Position
// Verwechslungsanfällige Zeichen (0, O, 1, l, I) sind nicht enthalten.
//
// ## Security Note: ################################################
// Der reduzierte Zeichensatz setzt den Keyspace von 10^57 auf 10^56 herab.
// Die Entropie wird von ~192.6 Bit auf ~190.6 Bit herabgesetzt.
// Solange die Passwortlänge von 32 Zeichen beibehalten wird ist der
// Sicherheitsverlust durch einen reduzierten Zeichensatz akzeptabel,
// weil der Keyspace immer noch so groß ist dass ein erraten praktisch
// unmöglich ist.
//
//const chars = "ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnpqrstuvwxyz23456789"
)
func generatePassword() string {
@@ -32,82 +46,95 @@ func passwordHandler(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, password)
}
// new help handler
func helpHandler(w http.ResponseWriter, r *http.Request) {
helpHTML := `
<!DOCTYPE html>
<html>
<head>
<title>Hilfe</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<style>
body {
font-family: 'Helvetica Neue', Arial, sans-serif;
display: flex;
justify-content: center;
align-items: center;
height: 100vh;
margin: 0;
background-color: #f5f5f5;
color: #333;
}
.help-container {
text-align: left;
background: white;
padding: 2rem;
border-radius: 8px;
box-shadow: 0 2px 10px rgba(0, 0, 0, 0.1);
max-width: 800px;
width: 90%;
min-width: 600px;
}
h1 {
font-size: 1.5rem;
margin-bottom: 1.5rem;
color: #444;
}
pre {
font-family: 'Courier New', Courier, monospace;
background: #f0f0f0;
padding: 0.8rem;
border-radius: 4px;
overflow-x: auto;
}
a {
color: #007BFF;
text-decoration: none;
}
a:hover {
text-decoration: underline;
}
</style>
</head>
<body>
<div class="help-container">
<h1>Hilfe: API-Endpunkt</h1>
<p>
Diese Anwendung bietet einen API-Endpunkt, um Passwörter direkt über die Kommandozeile abzurufen.
Der Endpunkt gibt das Passwort im Plain-Text-Format zurück.
</p>
<h2>Endpunkt:</h2>
<p><code>http://localhost:8080/api/password</code></p>
<h2>Beispiele:</h2>
<h3>Mac/Linux (Terminal):</h3>
<pre>echo $(curl -s http://localhost:8080/api/password)</pre>
<h3>Windows (PowerShell):</h3>
<pre>Invoke-RestMethod -Uri http://localhost:8080/api/password</pre>
<h3>Windows (cmd):</h3>
<pre>curl http://localhost:8080/api/password</pre>
<p>
<a href="/">Zurück zur Passwort-Generierung</a>
</p>
</div>
</body>
</html>
`
w.Header().Set("Content-Type", "text/html; charset=utf-8")
fmt.Fprint(w, helpHTML)
helpHTML := `
<!DOCTYPE html>
<html>
<head>
<title>Hilfe</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<style>
body {
font-family: 'Helvetica Neue', Arial, sans-serif;
display: flex;
justify-content: center;
align-items: center;
height: 100vh;
margin: 0;
background-color: #f5f5f5;
color: #333;
}
.help-container {
text-align: left;
background: white;
padding: 2rem;
border-radius: 8px;
box-shadow: 0 2px 10px rgba(0, 0, 0, 0.1);
max-width: 800px;
width: 90%;
min-width: 500px;
}
h1 {
font-size: 1.5rem;
margin-bottom: 1.5rem;
color: #444;
}
pre {
font-family: 'Courier New', Courier, monospace;
background: #f0f0f0;
padding: 0.8rem;
border-radius: 4px;
overflow-x: auto;
}
a {
color: #007BFF;
text-decoration: none;
}
a:hover {
text-decoration: underline;
}
</style>
</head>
<body>
<div class="help-container">
<h1>Hilfe: API-Endpunkt</h1>
<p>
Diese Anwendung bietet einen API-Endpunkt, um Passwörter direkt über die Kommandozeile abzurufen.
Der Endpunkt gibt das Passwort im Plain-Text-Format zurück.
</p>
<h2>Endpunkt:</h2>
<p><code id="api-endpoint"></code></p>
<h2>Beispiele:</h2>
<h3>Mac/Linux (Terminal):</h3>
<pre id="curl-example"></pre>
<h3>Windows (PowerShell):</h3>
<pre id="powershell-example"></pre>
<h3>Windows (cmd):</h3>
<pre id="cmd-example"></pre>
<p>
<a href="/">Zurück zur Passwort-Generierung</a>
</p>
</div>
<script>
// Dynamisch den aktuellen Hostnamen ermitteln
const currentHost = window.location.host;
const apiEndpoint = "http://" + currentHost + "/api/password";
// Hostnamen in die Beispiele eintragen
document.getElementById("api-endpoint").textContent = apiEndpoint;
document.getElementById("curl-example").textContent = "curl " + apiEndpoint;
document.getElementById("powershell-example").textContent = "Invoke-RestMethod -Uri " + apiEndpoint;
document.getElementById("cmd-example").textContent = "curl " + apiEndpoint;
</script>
</body>
</html>
`
w.Header().Set("Content-Type", "text/html; charset=utf-8")
fmt.Fprint(w, helpHTML)
}
func webHandler(w http.ResponseWriter, r *http.Request) {
password := generatePassword()
html := fmt.Sprintf(
@@ -134,7 +161,7 @@ html := fmt.Sprintf(
border-radius: 8px;
box-shadow: 0 2px 10px rgba(0, 0, 0, 0.1);
width: 90%%;
min-width: 600px;
min-width: 500px;
position: relative;
}
h1 {
@@ -182,6 +209,17 @@ html := fmt.Sprintf(
.renew-button:hover {
background: #0056b3;
}
.about-link {
position: absolute;
top: 1rem;
left: 1rem;
font-size: 1.2rem;
color: #999;
text-decoration: none;
}
.about-link:hover {
color: #444;
}
.help-link {
position: absolute;
top: 1rem;
@@ -218,6 +256,7 @@ html := fmt.Sprintf(
<body>
<div class="container">
<a href="/help" class="help-link">API</a>
<a class="about-link" href="https://gitea.scu.si/FlorianWalther/Web-Password">code</a>
<h1>Generiertes Passwort</h1>
<div id="password">%s</div>
<div class="buttons">

45
misc/MoreUsage.md Normal file
View File

@@ -0,0 +1,45 @@
# Baue die Go-Anwendung
```
go build -o password-generator ./
```
# Baue das Docker-Image
```
docker build -t password-generator .
```
# Starte den Docker Container
```
docker run -p 8080:8080 password-generator
```
## mit docker-compose
Ein `docker-compose.yml` wird mitgeliefert.
### initial pull
```
docker compose login gitea.scu.si
docker compose pull
```
### start up
```
docker compose up -d
```
### bring down
```
docker compose down
```

View File

@@ -0,0 +1,24 @@
services:
password-generator:
image: gitea.scu.si/florianwalther/password-generator:latest
container_name: password-generator
restart: always
expose:
- "8080:8080"
# Falls die Registry privat ist, muss der Host zuvor mit
# 'docker login gitea.scu.si' angemeldet worden sein.
labels:
- "traefik.enable=true"
- "traefik.docker.network=traefik_backend"
- "traefik.http.routers.webpass.rule=Host(`passwd.scu.si`)"
- "traefik.http.routers.webpass.entrypoints=web,websecure"
- "traefik.http.routers.webpass.tls=true"
- "traefik.http.routers.webpass.tls.certresolver=myresolver"
- "traefik.http.services.webpass.loadbalancer.server.port=8080"
networks:
- traefik_backend
networks:
traefik_backend:
external: true