dolibarr.netdiag/api/auth.php
Eduard Wisch f2a5958adb
All checks were successful
Deploy netdiag / deploy (push) Successful in 14s
Anmeldung ueber das zentrale Auth-Modul awlauth — v1.1.0 [deploy]
NetDiag war die letzte AWL-App mit eigenem Login: eigenes JWT, eigener Schluessel,
eigene Gueltigkeitsdauer, keine Moeglichkeit ein verlorenes Handy gezielt abzumelden.

- api/auth.php prueft das Passwort ueber awlauth_login(). Damit greifen dort auch die
  Brute-Force-Bremse (5 Fehlversuche je IP in 15 min, 10 je Benutzername in 30 min)
  und die einheitliche, nicht-verraeterische Fehlermeldung. Das Token kommt aus
  awlauth_issue_bearer() und legt eine Sitzungszeile an: das Geraet erscheint als
  "NetDiag-App · Android" in der awlauth-Geraeteliste und ist dort einzeln abmeldbar.
- netdiag_api_authenticate() prueft zuerst das awlauth-Token; ein widerrufenes Token
  fuehrt sofort zu 401, auch wenn die Signatur noch stimmt.
- Uebergangsweise gilt ein bereits ausgestelltes altes netdiag-JWT weiter, damit die
  Umstellung niemanden mitten im Einsatz aussperrt. Faellt weg, sobald alle Geraete
  einmal neu angemeldet sind.
- Ohne aktives awlauth laeuft das Modul unveraendert mit dem eigenen JWT weiter.

Die Antwortform von auth.php bleibt bewusst {token, expiresIn, user}: bereits
installierte APKs laufen nach einer einmaligen Neuanmeldung ohne Update weiter.
Haette man sie geaendert, waeren alle Geraete ausgesperrt — und die neue APK gibt es
nur ueber update.php, das Anmeldung verlangt.

CORS: Wildcard-Origin raus. Die API liefert Kundendaten aus; ein * erlaubt jeder
Webseite die Antwort auszulesen, sobald sie an ein Token kommt. Erlaubt sind jetzt nur
die App-Origins und der Vite-Dev-Server, dazu Vary: Origin. Anfragen ohne Origin
(nativer Client, APK-Downloader im Plugin, curl) sind unveraendert.

Lokal gegen das Test-Dolibarr geprueft: Login liefert awlauth-Token, Sitzungszeile
entsteht, orders.php mit Bearer = 200, falsches Passwort = 401, kein/manipuliertes
Token = 401, 4. Fehlversuch = 429 mit Wartezeit, Alt-Token = 200 (Fallback),
fremder Origin bekommt keinen CORS-Header. Anschliessend im Emulator durchgespielt.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-14 18:23:29 +02:00

138 lines
4.9 KiB
PHP

<?php
/* Copyright (C) 2026 Eduard Wisch <data@data-it-solution.de>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
/**
* \file netdiag/api/auth.php
* \ingroup netdiag
* \brief API-Endpunkt: Anmeldung der mobilen App, liefert ein Token.
*
* POST {login, password} -> {token, expiresIn, user}
*
* Das Token stellt seit v1.4.0 das zentrale Auth-Modul awlauth aus (gleicher
* Schlüssel und gleiche Sitzungs-Registry wie alle anderen AWL-Apps, damit ein
* verlorenes Handy an EINER Stelle abgemeldet werden kann). Da die App im
* Capacitor-WebView auf einem eigenen Origin läuft, kann sie das SSO-Cookie
* nicht nutzen — sie bekommt denselben Token im Antwort-Body und schickt ihn
* als "Authorization: Bearer ..." zurück.
*
* Die ANTWORTFORM ist bewusst unverändert geblieben: bereits installierte
* APKs lesen {token, expiresIn, user} und laufen nach einer einmaligen
* Neuanmeldung ohne Update weiter.
*/
require_once __DIR__.'/netdiag_api.lib.php';
netdiag_api_bootstrap();
/** @var DoliDB $db */
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
netdiag_api_error('Nur POST erlaubt', 405);
}
$body = netdiag_api_read_body();
$login = isset($body['login']) ? trim((string) $body['login']) : '';
$password = isset($body['password']) ? (string) $body['password'] : '';
if ($login === '' || $password === '') {
netdiag_api_error('Login und Passwort erforderlich', 400);
}
require_once DOL_DOCUMENT_ROOT.'/core/lib/security2.lib.php';
require_once DOL_DOCUMENT_ROOT.'/user/class/user.class.php';
if (netdiag_awlauth_available()) {
// ---------------------------------------------------------------------
// Zentrale Anmeldung über awlauth (Rate-Limit, Passwortprüfung,
// SSO-Eignung) — dieselbe Prüfung wie in allen anderen AWL-Apps.
// ---------------------------------------------------------------------
$res = awlauth_login($login, $password);
if (empty($res['success'])) {
netdiag_api_error($res['error'], (int) $res['http']);
}
$user = $res['user'];
if (!$user->hasRight('netdiag', 'protocol', 'read')) {
netdiag_api_error('Keine Berechtigung für NetDiag', 403);
}
// Gerätebezeichnung für die awlauth-Geräteliste. Ein WebView meldet sich
// als Chrome — ohne eigenen Namen wäre die App dort nicht wiederzuerkennen.
$ua = isset($_SERVER['HTTP_USER_AGENT']) ? (string) $_SERVER['HTTP_USER_AGENT'] : '';
$label = 'NetDiag-App';
if ($ua !== '' && function_exists('awlauth_device_label')) {
$parts = explode(' · ', awlauth_device_label($ua));
if (!empty($parts[0])) {
$label .= ' · '.$parts[0];
}
}
$issued = awlauth_issue_bearer($user, 0, 'password', $label);
if ($issued === null) {
netdiag_api_error('Anmeldung konnte nicht abgeschlossen werden', 500);
}
$token = $issued['token'];
$ttl = (int) $issued['expiresIn'];
} else {
// ---------------------------------------------------------------------
// Fallback ohne awlauth: modul-eigenes JWT (Alt-Verhalten).
// ---------------------------------------------------------------------
$entitytocheck = (int) $conf->entity;
$authmode = (getDolGlobalString('MAIN_AUTHENTICATION_MODE') ? getDolGlobalString('MAIN_AUTHENTICATION_MODE') : 'dolibarr');
$resultlogin = checkLoginPassEntity($login, $password, $entitytocheck, explode(',', $authmode));
if (empty($resultlogin)) {
// Kurze Verzögerung gegen Brute-Force
sleep(1);
netdiag_api_error('Login fehlgeschlagen', 401);
}
$user = new User($db);
if ($user->fetch('', $resultlogin, '', 0, $entitytocheck) <= 0 || empty($user->id)) {
netdiag_api_error('Benutzer nicht gefunden', 401);
}
if (!empty($user->statut) && $user->statut == 0) {
netdiag_api_error('Benutzer deaktiviert', 403);
}
$user->loadRights();
if (!$user->hasRight('netdiag', 'protocol', 'read')) {
netdiag_api_error('Keine Berechtigung für NetDiag', 403);
}
$ttl = (int) getDolGlobalString('NETDIAG_API_TOKEN_TTL', '604800');
if ($ttl < 60) {
$ttl = 604800;
}
$token = netdiag_jwt_encode(array(
'sub' => (int) $user->id,
'name' => $user->getFullName($langs),
), $ttl);
}
netdiag_api_respond(array(
'token' => $token,
'expiresIn' => $ttl,
'user' => array(
'id' => (int) $user->id,
'login' => $user->login,
'name' => $user->getFullName($langs),
'email' => $user->email,
'canWrite' => (bool) $user->hasRight('netdiag', 'protocol', 'write'),
),
));