Files
buening-website/altcha-lib.php
T

114 lines
3.8 KiB
PHP

<?php
/**
* ALTCHA v1-Protokoll: Challenge-Erstellung und Lösungsprüfung.
*
* Nachbau des offiziellen altcha-lib-php (MIT, github.com/altcha-org/altcha-lib-php,
* src/V1), auf das Nötigste reduziert und ohne Namensräume, damit das
* Kontaktformular ohne Composer/Abhängigkeiten auf dem Webspace läuft.
*
* Protokoll:
* - Server erzeugt salt (zufälliges Hex) und number (0..maxnumber) und
* daraus challenge = SHA-256(salt . number) sowie
* signature = HMAC-SHA256(challenge, hmac_key).
* - Der Client sucht per Brute-Force die Zahl n mit SHA-256(salt . n)
* == challenge und sendet sie base64-kodiert zurück.
* - Der Server rechnet beide Werte nach; ein Bot ohne Lösung der
* Proof-of-Work-Aufgabe kommt nicht durch.
*/
function altcha_hash_hex(string $algorithm, string $data): string
{
return match ($algorithm) {
'SHA-1' => sha1($data),
'SHA-512' => hash('sha512', $data),
default => hash('sha256', $data),
};
}
function altcha_hmac_hex(string $algorithm, string $data, string $key): string
{
return match ($algorithm) {
'SHA-1' => hash_hmac('sha1', $data, $key),
'SHA-512' => hash_hmac('sha512', $data, $key),
default => hash_hmac('sha256', $data, $key),
};
}
/**
* Erzeugt eine neue Challenge. Rückgabe: Array für die JSON-Antwort
* an das ALTCHA-Widget (algorithm, challenge, maxnumber, salt, signature).
*
* @param string $hmac_key Geheimer HMAC-Schlüssel.
* @param int $max_number Obergrenze für die zu suchende Zahl (Schwierigkeit).
* @param int|null $expires Unix-Zeitstempel, ab dem die Challenge ungültig wird.
*/
function altcha_create_challenge(string $hmac_key, int $max_number = 1000000, ?int $expires = null): array
{
$salt = bin2hex(random_bytes(12));
if ($expires !== null) {
$salt .= '?expires=' . $expires . '&';
} else {
// Abschluss-Zeichen gegen Parameter-Splicing, wie in der Referenzimplementierung
$salt .= '&';
}
$number = random_int(0, $max_number);
$challenge = altcha_hash_hex('SHA-256', $salt . $number);
$signature = altcha_hmac_hex('SHA-256', $challenge, $hmac_key);
return [
'algorithm' => 'SHA-256',
'challenge' => $challenge,
'maxnumber' => $max_number,
'salt' => $salt,
'signature' => $signature,
];
}
/**
* Prüft eine vom Widget gesendete Lösung (Base64-JSON mit algorithm,
* challenge, number, salt, signature).
*/
function altcha_verify_solution(string $hmac_key, string $payload_base64): bool
{
$decoded = base64_decode($payload_base64, true);
if ($decoded === false) {
return false;
}
$data = json_decode($decoded, true);
if (!is_array($data)) {
return false;
}
if (
!isset($data['algorithm'], $data['challenge'], $data['number'], $data['salt'], $data['signature'])
|| !is_string($data['algorithm'])
|| !is_string($data['challenge'])
|| !is_int($data['number'])
|| !is_string($data['salt'])
|| !is_string($data['signature'])
) {
return false;
}
// Ablauf der Challenge prüfen (im salt als Query-Parameter hinterlegt)
$salt = $data['salt'];
$questionPos = strpos($salt, '?');
if ($questionPos !== false) {
parse_str(substr($salt, $questionPos + 1), $params);
if (isset($params['expires']) && is_numeric($params['expires'])) {
if (time() > (int) $params['expires']) {
return false;
}
}
}
$expected_challenge = altcha_hash_hex($data['algorithm'], $salt . $data['number']);
if (!hash_equals($expected_challenge, $data['challenge'])) {
return false;
}
$expected_signature = altcha_hmac_hex($data['algorithm'], $data['challenge'], $hmac_key);
return hash_equals($expected_signature, $data['signature']);
}