christian/rmm2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

README: Alle Beispiele mit echten Zugangsdaten, alle 3 Agent-IDs dokumentiert

Browse Source
This commit is contained in:
cynfo3000 2026-02-28 11:28:22 +01:00
parent c10c311424
commit 62eeaf79e2
1 changed files with 48 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

70
README.md
View File

@ -233,7 +233,11 @@ curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" -X DELETE \
``` ```
Backend: https://192.168.85.13:8443 Backend: https://192.168.85.13:8443
API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9 API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9
Agent-ID: e92e87a684b20db15d8d2344583c5887 (OPN-REP.intra.weidenhaupt.net)
Agent-IDs:
6beb8dfd38ecf03eab6c0f21b4ac7bee OPN-PROD.intra.weidenhaupt.net (192.168.85.1, READ-ONLY)
e92e87a684b20db15d8d2344583c5887 OPN-REP.intra.weidenhaupt.net (192.168.85.33)
1697d28e57bc126534afc282b5de8ee0 OPN-TEST-UPDATE (192.168.85.19)
``` ```
### Agent-Beispiele ### Agent-Beispiele
@ -290,45 +294,63 @@ curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" -X POST \
4. `configctl wireguard configure` laedt die Aenderung 4. `configctl wireguard configure` laedt die Aenderung
5. Response enthaelt die komplette Client-Config (ready for import) 5. Response enthaelt die komplette Client-Config (ready for import)
**Beispiel:** **Beispiele:**
```bash ```bash
# Peer anlegen # Peer anlegen (erster Peer bekommt .2, zweiter .3, etc.)
curl -sk -H "X-API-Key: API_KEY" -X POST \ curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" -X POST \
https://BACKEND/api/v1/agents/AGENT_ID/wireguard/peers \ https://192.168.85.13:8443/api/v1/agents/6beb8dfd38ecf03eab6c0f21b4ac7bee/wireguard/peers \
-d '{"name":"VPN_MUELLER","allowed_ips":"0.0.0.0/0","dns":"10.172.100.210"}' -d '{"name":"VPN_MUELLER","allowed_ips":"0.0.0.0/0","dns":"10.172.100.210"}'
# Response enthaelt client_config: # Response:
# [Interface] # {
# PrivateKey = ... # "status": "ok",
# Address = 10.33.144.2/32 # "data": {
# DNS = 10.172.100.210 # "peer_uuid": "abc123...",
# # "name": "VPN_MUELLER",
# [Peer] # "client_ip": "10.33.144.2",
# PublicKey = ... # "endpoint": "79.238.149.26:8080",
# AllowedIPs = 0.0.0.0/0 # "client_config": "[Interface]\nPrivateKey = ...\nAddress = 10.33.144.2/32\n..."
# Endpoint = 79.238.149.26:8080 # }
# PersistentKeepalive = 25 # }
# Peers auflisten # Zweiten Peer anlegen (bekommt automatisch .3)
curl -sk -H "X-API-Key: API_KEY" \ curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" -X POST \
https://BACKEND/api/v1/agents/AGENT_ID/wireguard/peers https://192.168.85.13:8443/api/v1/agents/6beb8dfd38ecf03eab6c0f21b4ac7bee/wireguard/peers \
-d '{"name":"VPN_SCHMIDT","allowed_ips":"0.0.0.0/0","dns":"10.172.100.210"}'
# Peer loeschen # Peer mit eigenem Endpoint (z.B. DynDNS)
curl -sk -H "X-API-Key: API_KEY" -X DELETE \ curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" -X POST \
https://BACKEND/api/v1/agents/AGENT_ID/wireguard/peers/PEER_UUID https://192.168.85.13:8443/api/v1/agents/6beb8dfd38ecf03eab6c0f21b4ac7bee/wireguard/peers \
-d '{"name":"VPN_EXTERN","allowed_ips":"0.0.0.0/0","endpoint":"vpn.kunde.de:8080"}'
# Alle Peers auflisten
curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" \
https://192.168.85.13:8443/api/v1/agents/6beb8dfd38ecf03eab6c0f21b4ac7bee/wireguard/peers
# Peers einer bestimmten Instanz auflisten
curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" \
"https://192.168.85.13:8443/api/v1/agents/6beb8dfd38ecf03eab6c0f21b4ac7bee/wireguard/peers?server_name=ALWAYSON_VPN"
# Peer loeschen (UUID aus der List-Response)
curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" -X DELETE \
https://192.168.85.13:8443/api/v1/agents/6beb8dfd38ecf03eab6c0f21b4ac7bee/wireguard/peers/89c10e2d-148e-11f1-a7af-7c5a1c6c7b73
``` ```
### Backup-Beispiele ### Backup-Beispiele
```bash ```bash
# Backup ausloesen # Backup ausloesen (Produktion .1)
curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" -X POST \
https://192.168.85.13:8443/api/v1/agents/6beb8dfd38ecf03eab6c0f21b4ac7bee/backup
# Backup ausloesen (Test .33)
curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" -X POST \ curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" -X POST \
https://192.168.85.13:8443/api/v1/agents/e92e87a684b20db15d8d2344583c5887/backup https://192.168.85.13:8443/api/v1/agents/e92e87a684b20db15d8d2344583c5887/backup
# Alle Backups auflisten # Alle Backups auflisten
curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" \ curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" \
https://192.168.85.13:8443/api/v1/agents/e92e87a684b20db15d8d2344583c5887/backups https://192.168.85.13:8443/api/v1/agents/6beb8dfd38ecf03eab6c0f21b4ac7bee/backups
# Neuestes Backup als XML herunterladen # Neuestes Backup als XML herunterladen
curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" \ curl -sk -H "X-API-Key: 01532e5a7c9e70bf2757df77a2f5b9b9" \