Runtime desktop
Le runtime desktop CaptchaLa est l'ensemble des bibliothèques natives pour Windows, macOS et Linux sur lequel reposent les SDK desktop. Version actuelle : 1.2.0.
Vous n'intégrez pas le runtime directement. Utilisez l'un de ces SDK ; ils embarquent ou récupèrent pour vous le runtime correspondant :
- SDK Electron (
@captcha-la/electron) : le paquet npm contient le runtime pour toutes les cibles prises en charge. - SDK Flutter (
captchala) : sous Windows et Linux, le plugin télécharge le runtime au moment de la compilation et le vérifie avec des empreintes SHA-256 épinglées.
Les applications macOS natives utilisent le SDK iOS / macOS.
Besoin d'une intégration directe ?
Si ni Electron ni Flutter ne conviennent à votre application, contactez-nous.
Plateformes
| Plateforme | Architectures | Fenêtre du captcha |
|---|---|---|
| Windows 10 1809+ et Windows Server | x64, arm64, x86 | Fenêtre native (Microsoft Edge WebView2 Runtime) |
| Linux, glibc 2.17+ | x64, arm64 | Fenêtre native : GTK 3 et WebKitGTK 4.1 (Ubuntu 22.04+, Debian 12+ ou équivalent) |
| macOS 11+ | arm64, x64 | Utilisé par le SDK Electron |
Depuis la 1.2.0, le runtime se charge aussi sur Windows Server, y compris Server Core et les serveurs de terminaux, sans installer de fonctionnalité Windows supplémentaire.
Sur les systèmes Linux antérieurs à Ubuntu 22.04 / Debian 12, la fenêtre native du captcha n'est pas disponible ; le SDK Electron affiche alors le captcha dans sa propre fenêtre.
Téléchargement et vérification
Les bibliothèques sont publiées sur le CDN de paquets versionné avec des checksums, pour les revues de sécurité ou pour les mettre en miroir dans votre réseau :
- URL de base :
https://pkg.captcha-pkg.net/desktop/1.2.0/(miroir :https://pkg.captcha-cdn.net/desktop/1.2.0/) SHA256SUMSliste chaque fichier avec son SHA-256 ; un dossier par cible :linux-x64,linux-arm64,win32-x64,win32-arm64,win32-ia32,darwin-arm64,darwin-x64
# Linux (use "shasum -a 256 -c -" on macOS)
BASE=https://pkg.captcha-pkg.net/desktop/1.2.0
TARGET=linux-x64
mkdir -p vendor/captchala/1.2.0 && cd vendor/captchala/1.2.0
curl -fsSLO "$BASE/SHA256SUMS"
for f in $(grep " $TARGET/" SHA256SUMS | awk '{print $2}'); do
mkdir -p "$(dirname "$f")" && curl -fsSL -o "$f" "$BASE/$f"
done
grep " $TARGET/" SHA256SUMS | sha256sum -c - # every line must say OKSous Windows, comparez Get-FileHash <file> -Algorithm SHA256 avec la ligne de SHA256SUMS. Pour compiler une application desktop Flutter depuis un miroir, faites pointer CAPTCHALA_LOCAL_PREBUILDS vers le dossier (voir Flutter : bibliothèques natives).
Prérequis
- Windows : Windows 10 1809+ ou Windows Server ; Microsoft Edge WebView2 Runtime pour la fenêtre du captcha.
- Linux : glibc 2.17+ et libcurl ; GTK 3 et WebKitGTK 4.1 (
webkit2gtk-4.1) pour la fenêtre du captcha. - macOS : macOS 11+.
Validation côté serveur
Quel que soit le SDK utilisé, envoyez le pass token à votre backend et validez-le avec POST https://verify.captcha.la/v1/validate. Voir la référence de l'API.