Initial Agrarmonitor connector

This commit is contained in:
2026-05-21 21:15:25 +02:00
commit b47cbc00a8
13 changed files with 1860 additions and 0 deletions
+392
View File
@@ -0,0 +1,392 @@
import axios, { type AxiosInstance, type AxiosRequestConfig, type AxiosResponse } from 'axios';
import { wrapper } from 'axios-cookiejar-support';
import { JSDOM } from 'jsdom';
import { CookieJar } from 'tough-cookie';
import type {
AgrarmonitorApiCustomer,
AgrarmonitorConnectorOptions,
AgrarmonitorConnectorResult,
AgrarmonitorDeviceRegistrationOptions,
AgrarmonitorDeviceRegistrationResult,
AgrarmonitorFetchCustomersOptions,
AgrarmonitorFreischaltungStatus,
AgrarmonitorLoginStrategy,
AgrarmonitorRegistrierungStatus,
Logger,
} from './types';
type RetryableAxiosRequestConfig = AxiosRequestConfig & {
_agrarmonitorRetry?: boolean;
};
export class AgrarmonitorConnector implements AgrarmonitorConnectorResult {
public http!: AxiosInstance;
private readonly baseUrl: string;
private readonly apiBaseUrl: string;
private readonly timeoutMs: number;
private readonly autoLogin: boolean;
private readonly autoRetry: boolean;
private readonly loginStrategy: AgrarmonitorLoginStrategy;
private readonly logger?: Logger;
private cookieJar!: CookieJar;
private loginInProgress: Promise<void> | null = null;
constructor(private readonly options: AgrarmonitorConnectorOptions) {
this.baseUrl = options.baseUrl ?? 'https://admin7.agrarmonitor.de';
this.apiBaseUrl = options.apiBaseUrl ?? 'https://api.agrarmonitor.de';
this.timeoutMs = options.timeoutMs ?? 15000;
this.autoLogin = options.autoLogin ?? true;
this.autoRetry = options.autoRetry ?? true;
this.loginStrategy = options.loginStrategy ?? 'auto';
this.logger = options.logger;
}
async init(): Promise<this> {
this.cookieJar = await this.options.cookieStore.load();
this.http = this.createHttpClient();
if (this.autoLogin) {
const valid = await this.isSessionValid();
if (!valid) {
await this.login();
}
}
return this;
}
async login(): Promise<void> {
if (this.loginInProgress) {
return this.loginInProgress;
}
this.loginInProgress = this.performLogin().finally(() => {
this.loginInProgress = null;
});
return this.loginInProgress;
}
async clearSession(): Promise<void> {
this.cookieJar = new CookieJar();
await this.options.cookieStore.clear();
this.http = this.createHttpClient();
}
async saveSession(): Promise<void> {
await this.options.cookieStore.save(this.cookieJar);
}
async getCookieCount(url = this.baseUrl): Promise<number> {
return this.cookieJar.getCookiesSync(url).length;
}
async checkFreigeschaltet(): Promise<AgrarmonitorFreischaltungStatus> {
const response = await this.http.get('/', {
maxRedirects: 0,
validateStatus: status => status >= 200 && status < 400,
});
await this.saveSession();
const redirectLocation = this.getHeader(response, 'location');
const redirected = response.status >= 300 && response.status < 400 && this.isFreischaltungUrl(redirectLocation);
return {
freigeschaltet: !redirected,
status: response.status,
redirected,
redirectLocation,
timestamp: new Date().toISOString(),
cookies: await this.getCookieCount(),
};
}
async checkRegistriert(): Promise<AgrarmonitorRegistrierungStatus> {
const response = await this.http.get('/', {
maxRedirects: 5,
validateStatus: status => status >= 200 && status < 500,
});
await this.saveSession();
const pageContent = typeof response.data === 'string' ? response.data : '';
const hasRegistrationText = pageContent.includes('Neues Gerät registrieren');
return {
registriert: !hasRegistrationText,
status: response.status,
hasRegistrationText,
timestamp: new Date().toISOString(),
cookies: await this.getCookieCount(),
};
}
async registerDevice(
registration: AgrarmonitorDeviceRegistrationOptions
): Promise<AgrarmonitorDeviceRegistrationResult> {
const agrarmonitorId = registration.agrarmonitorId.trim();
const pcName = registration.pcName.trim();
if (!agrarmonitorId || !pcName) {
throw new Error('AgrarmonitorID und PC-Name sind erforderlich');
}
const freischaltungResponse = await this.http.get('/freischaltung/');
const responseContent = typeof freischaltungResponse.data === 'string' ? freischaltungResponse.data : '';
const nonce = this.extractNonce(responseContent, '#nonce, input[name="nonce"]');
const registerResponse = await this.http.post(
'/freischaltung/api/register.php',
{
firma: agrarmonitorId,
name: pcName,
nonce,
},
{
headers: {
'Content-Type': 'application/json',
},
validateStatus: status => status >= 200 && status < 500,
}
);
await this.saveSession();
const success = registerResponse.status >= 200 && registerResponse.status < 300;
return {
success,
status: registerResponse.status,
message: success ? 'Registrierung erfolgreich' : 'Registrierung fehlgeschlagen',
data: {
agrarmonitorId,
pcName,
nonce: this.maskNonce(nonce),
},
timestamp: new Date().toISOString(),
cookies: await this.getCookieCount(),
};
}
async fetchCustomers(options: AgrarmonitorFetchCustomersOptions = {}): Promise<AgrarmonitorApiCustomer[]> {
const apiToken = options.apiToken ?? this.options.apiToken;
if (!apiToken) {
throw new Error('Agrarmonitor API-Token nicht konfiguriert');
}
const response = await this.http.get(`${this.apiBaseUrl}/v1/kunden`, {
params: {
per_page: options.perPage ?? 99999,
api_token: apiToken,
},
});
await this.saveSession();
const responseData = response.data as { data?: unknown };
if (!responseData || !Array.isArray(responseData.data)) {
throw new Error('Ungueltige Agrarmonitor API-Antwort');
}
return responseData.data as AgrarmonitorApiCustomer[];
}
private createHttpClient(): AxiosInstance {
const client = wrapper(
axios.create({
baseURL: this.baseUrl,
jar: this.cookieJar,
withCredentials: true,
timeout: this.timeoutMs,
headers: {
'User-Agent':
'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36',
},
maxRedirects: 5,
validateStatus: status => status >= 200 && status < 400,
})
);
client.interceptors.response.use(
async response => {
await this.options.cookieStore.save(this.cookieJar);
if (this.autoRetry && this.isLoginRequiredResponse(response)) {
return this.retryAfterLogin(response.config);
}
return response;
},
async error => {
const response = error.response as AxiosResponse | undefined;
if (this.autoRetry && response && this.isLoginRequiredResponse(response)) {
return this.retryAfterLogin(error.config);
}
throw error;
}
);
return client;
}
private async performLogin(): Promise<void> {
if (!this.options.username || !this.options.password) {
throw new Error('Agrarmonitor-Credentials nicht konfiguriert');
}
this.logger?.info?.('Fuehre Agrarmonitor-Login durch');
if (this.loginStrategy === 'auth') {
await this.performAuthLogin();
} else if (this.loginStrategy === 'legacy') {
await this.performLegacyLogin();
} else {
await this.performAutoLogin();
}
await this.options.cookieStore.save(this.cookieJar);
this.logger?.info?.('Agrarmonitor-Login erfolgreich');
}
private async performAutoLogin(): Promise<void> {
try {
await this.performAuthLogin();
} catch (authError) {
this.logger?.warn?.('Agrarmonitor-Login via /auth/login fehlgeschlagen, versuche Legacy-Login', authError);
await this.performLegacyLogin();
}
}
private async performAuthLogin(): Promise<void> {
await this.http.get('/auth/login');
const loginData = new URLSearchParams({
email: this.options.username,
password: this.options.password,
remember: 'on',
});
const response = await this.http.post('/auth/login', loginData, {
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
},
});
const responseText = typeof response.data === 'string' ? response.data : '';
if (responseText.includes('Anmeldung fehlgeschlagen')) {
throw new Error('Agrarmonitor-Login fehlgeschlagen');
}
}
private async performLegacyLogin(): Promise<void> {
const loginPageResponse = await this.http.get('/');
const loginPageText = typeof loginPageResponse.data === 'string' ? loginPageResponse.data : '';
if (!this.isLoginPageText(loginPageText)) {
return;
}
const nonce = this.extractNonce(loginPageText, 'input[name="nonce"]');
const loginData = new URLSearchParams({
username: this.options.username,
passwort: this.options.password,
nonce,
});
const response = await this.http.post('/redirect.php?id=benutzerverwaltung&action=login', loginData, {
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
},
});
const responseText = typeof response.data === 'string' ? response.data : '';
if (this.isLoginPageText(responseText)) {
throw new Error('Agrarmonitor-Legacy-Login fehlgeschlagen');
}
}
private async isSessionValid(): Promise<boolean> {
try {
const response = await this.http.get('/');
return !this.isLoginRequiredResponse(response);
} catch {
return false;
}
}
private isLoginRequiredResponse(response: AxiosResponse): boolean {
const responseUrl = this.getResponseUrl(response);
const responseText = typeof response.data === 'string' ? response.data : '';
return (
response.status === 401 ||
response.status === 403 ||
responseUrl.includes('/auth/login') ||
responseText.includes('/auth/login') ||
this.isLoginPageText(responseText) ||
responseText.includes('Anmeldung') ||
responseText.includes('Einloggen')
);
}
private async retryAfterLogin(config: RetryableAxiosRequestConfig): Promise<AxiosResponse> {
if (config._agrarmonitorRetry) {
throw new Error('Agrarmonitor-Request nach erneutem Login weiterhin nicht autorisiert');
}
config._agrarmonitorRetry = true;
this.logger?.info?.('Agrarmonitor-Session abgelaufen, erneuter Login wird ausgefuehrt');
await this.login();
return this.http.request(config);
}
private getResponseUrl(response: AxiosResponse): string {
const request = response.request as { res?: { responseUrl?: string } } | undefined;
return request?.res?.responseUrl ?? '';
}
private getHeader(response: AxiosResponse, header: string): string | null {
const value = response.headers[header.toLowerCase()];
if (Array.isArray(value)) {
return value[0] ?? null;
}
return typeof value === 'string' ? value : null;
}
private isFreischaltungUrl(value: string | null): boolean {
return Boolean(value?.includes('freischaltung'));
}
private isLoginPageText(responseText: string): boolean {
return responseText.includes('Anmeldung - AGRARMONITOR');
}
private extractNonce(html: string, selector: string): string {
const dom = new JSDOM(html);
const element = dom.window.document.querySelector<HTMLInputElement>(selector);
const nonce = element?.getAttribute('value') ?? element?.value ?? '';
if (!nonce) {
throw new Error('Nonce-Element nicht gefunden oder leer');
}
return nonce;
}
private maskNonce(nonce: string): string {
return nonce.length <= 10 ? nonce : `${nonce.slice(0, 10)}...`;
}
}