Skip to content

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 ​

PlateformeArchitecturesFenêtre du captcha
Windows 10 1809+ et Windows Serverx64, arm64, x86Fenêtre native (Microsoft Edge WebView2 Runtime)
Linux, glibc 2.17+x64, arm64Fenêtre native : GTK 3 et WebKitGTK 4.1 (Ubuntu 22.04+, Debian 12+ ou équivalent)
macOS 11+arm64, x64Utilisé 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/)
  • SHA256SUMS liste chaque fichier avec son SHA-256 ; un dossier par cible : linux-x64, linux-arm64, win32-x64, win32-arm64, win32-ia32, darwin-arm64, darwin-x64
bash
# 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 OK

Sous 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.

MIT-licensed examples · CaptchaLa is operated independently