Login-IPs an das CraftAttack-Plugin melden #48

New Issue

2026-10-14T12:51:21Z

MineTec commented

2026-10-14 12:51:21 +00:00

Wann melden

Nach jeder erfolgreichen Anmeldung zum Projekt (event: "signup").
Fehlgeschlagene Versuche werden nicht gemeldet.

Wie melden

POST http://10.20.9.3:8080/api/loginlog/website
Content-Type: application/json

{
  "event": "signup",
  "uuid": "c291290d-cffc-4649-aeec-d6f4417896ea",
  "username": "MineTec",
  "ip": "203.0.113.7"
}

Feld	Pflicht	Inhalt
`event`	ja	`signup` oder `login`
`uuid`	ja	Minecraft-UUID des Accounts, mit Bindestrichen
`username`	ja	Minecraft-Name wie bei der Anmeldung
`ip`	ja	IP des Besuchers, IPv4 oder IPv6

Antwort (immer HTTP 200)

{"status":"SUCCESS"}: gespeichert.
{"status":"FAILURE","error":"Field 'uuid' is required"}: abgelehnt, nichts gespeichert.

Wichtig

Ohne UUID nicht melden. Der Endpunkt nimmt nur eindeutige Zuordnungen an. Ist die UUID noch unbekannt, z. B. bei einer Bedrock-Anmeldung, wird nichts gesendet.
Die echte Besucher-IP verwenden. Steht die Webseite hinter einem Reverse-Proxy, kommt die IP aus X-Forwarded-For bzw. X-Real-IP.
Die Meldung darf Anmeldung und Login nicht verzögern oder abbrechen. Asynchron oder mit kurzem Timeout (ca. 2 s) senden. Ist der Server nicht erreichbar oder antwortet mit FAILURE, nur ins Webseiten-Log schreiben, ohne Fehlermeldung an den Nutzer und ohne Wiederholungsschleife.
Für Nutzer unsichtbar. Keine Erwähnung in Oberfläche, Fehlermeldungen oder öffentlichem Code.
Erreichbarkeit: Der Endpunkt ist nur im internen Netz erreichbar und hat derzeit keine Authentifizierung. Bitte nur vom Webserver (10.20.9.2) aus aufrufen.

### Wann melden - Nach jeder **erfolgreichen Anmeldung** zum Projekt (`event: "signup"`). - Fehlgeschlagene Versuche werden nicht gemeldet. ### Wie melden ```http POST http://10.20.9.3:8080/api/loginlog/website Content-Type: application/json { "event": "signup", "uuid": "c291290d-cffc-4649-aeec-d6f4417896ea", "username": "MineTec", "ip": "203.0.113.7" } ``` | Feld | Pflicht | Inhalt | |---|---|---| | `event` | ja | `signup` oder `login` | | `uuid` | ja | Minecraft-UUID des Accounts, mit Bindestrichen | | `username` | ja | Minecraft-Name wie bei der Anmeldung | | `ip` | ja | IP des Besuchers, IPv4 oder IPv6 | ### Antwort (immer HTTP 200) - `{"status":"SUCCESS"}`: gespeichert. - `{"status":"FAILURE","error":"Field 'uuid' is required"}`: abgelehnt, nichts gespeichert. ### Wichtig - **Ohne UUID nicht melden.** Der Endpunkt nimmt nur eindeutige Zuordnungen an. Ist die UUID noch unbekannt, z. B. bei einer Bedrock-Anmeldung, wird nichts gesendet. - **Die echte Besucher-IP verwenden.** Steht die Webseite hinter einem Reverse-Proxy, kommt die IP aus `X-Forwarded-For` bzw. `X-Real-IP`. - **Die Meldung darf Anmeldung und Login nicht verzögern oder abbrechen.** Asynchron oder mit kurzem Timeout (ca. 2 s) senden. Ist der Server nicht erreichbar oder antwortet mit `FAILURE`, nur ins Webseiten-Log schreiben, ohne Fehlermeldung an den Nutzer und ohne Wiederholungsschleife. - **Für Nutzer unsichtbar.** Keine Erwähnung in Oberfläche, Fehlermeldungen oder öffentlichem Code. - **Erreichbarkeit:** Der Endpunkt ist nur im internen Netz erreichbar und hat derzeit keine Authentifizierung. Bitte nur vom Webserver (10.20.9.2) aus aufrufen.

bytedream commented

2026-10-29 13:43:05 +00:00

In Webhook Integriert, siehe README. Es wird X-Forwarded-For respected

bytedream closed this issue

2026-10-29 21:01:14 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: CraftAttack/website#48