flutter_recaptcha_v2

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um plugin Flutter que integra o Google ReCaptcha V2 em aplicativos móveis, permitindo que desenvolvedores adicionem proteção contra bots a formulários e fluxos de login. Ele fornece uma interface simples para renderizar e verificar desafios reCAPTCHA em plataformas Android e iOS. O plugin gerencia a comunicação subjacente com o serviço de reCAPTCHA do Google, garantindo validação segura das interações do usuário. Projetado para facilitar o uso, oferece verificação assíncrona e retorna tokens para validação no lado do servidor.

Casos de uso

Protegendo formulários de login contra robôs
Protegendo envios de formulários de contato
Evitando a criação automática de contas
Melhorando a segurança nos fluxos de registro
Validando ações do usuário em operações sensíveis

Principais recursos

Integração simples com aplicativos Flutter
Suporta os tipos invisíveis e normais do reCAPTCHA V2
Retorna tokens de verificação para validação do servidor
Compatibilidade multiplataforma (Android e iOS)
Fluxo de trabalho de verificação assíncrona

Indicado para

Desenvolvedores construindo fluxos de autenticação seguros
Aplicativos que exigem proteção contra bots em formulários
Projetos que precisam estar em conformidade com medidas anti-abuso
Equipes integrando o serviço reCAPTCHA do Google no Flutter
Aplicativos móveis com alto risco de abuso automatizado

Considerações

Requer conexão com a internet para verificação do reCAPTCHA
A validação de token do lado do servidor é obrigatória
Pode afetar a experiência do usuário se não for implementado com cuidado
Depende da disponibilidade do serviço externo do Google
Limitado ao reCAPTCHA V2, não ao V3 ou versões mais recentes

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

A Flutter plugin for Google ReCaptcha V2.

Getting Started

This plugin requires Webview to use Google ReCaptcha. This plugin only supports Google ReCAPTCHA V2 (not V3)

Obtain your own key & secret here: https://www.google.com/recaptcha

!!! Remember to add this domain into the reCaptcha setting or add your own domain: recaptcha-flutter-plugin.firebaseapp.com

Then test your API KEY at: https://recaptcha-flutter-plugin.firebaseapp.com/?api_key=API_KEY

Put RecaptchaV2 widget into your widget tree (Usually inside Stack widget), make sure it's placed on top of the tree and block all the behind interactions:

You can change the plugin url for the captcha domain insde the RecaptchaV2 or leave it by default non adding the line:

pluginURL: "https://mypersonalurl.com"

if you have setted your own domain, specify the domain used

To show the Cancel Button with the captcha controller set the boolean to true:

visibleCancelBottom: true

otherwise it won't appear

Set the Text for the Cancel buttom or leave it by default:

textCancelButtom: "CANCEL CAPTCHA"

Example

RecaptchaV2Controller recaptchaV2Controller = RecaptchaV2Controller();
...
RecaptchaV2(
    apiKey: "YOUR_API_KEY", // for enabling the reCaptcha
    apiSecret: "YOUR_API_SECRET", // for verifying the responded token
    pluginURL: "https://mypersonalurl.com",
	visibleCancelBottom: true,
	textCancelButtom: "CUSTOM CANCEL CAPTCHA BUTTOM TEXT",
	controller: recaptchaV2Controller,
    onVerifiedError: (err){
        print(err);
    },
    onVerifiedSuccessfully: (success) {
        setState(() {
            if (success) {
                // You've been verified successfully.
            } else {
                // "Failed to verify.
            }
        });
    },
),

The RecaptchaV2 widget is hidden by default, you need to attach the RecaptchaV2Controller and call show() method when needed. Like this:

recaptchaV2Controller.show();

Manually hide it:

recaptchaV2Controller.hide();

That's it!

Buscar pacotes, repositórios e categorias de apps