<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Janaina Ludwig on Medium]]></title>
        <description><![CDATA[Stories by Janaina Ludwig on Medium]]></description>
        <link>https://medium.com/@janainaludwig_45378?source=rss-4ef6fdf4daa0------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*qB8LbUj4K_zJPxLhhFaDag.jpeg</url>
            <title>Stories by Janaina Ludwig on Medium</title>
            <link>https://medium.com/@janainaludwig_45378?source=rss-4ef6fdf4daa0------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Fri, 20 Nov 2026 06:22:55 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@janainaludwig_45378/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Como adicionar o Google reCAPTCHA v3 em uma aplicação Laravel]]></title>
            <link>https://medium.com/togdesign/como-adicionar-o-google-recaptcha-v3-em-uma-aplicacao-laravel-b481bc07aa54?source=rss-4ef6fdf4daa0------2</link>
            <guid isPermaLink="false">https://medium.com/p/b481bc07aa54</guid>
            <category><![CDATA[spam]]></category>
            <category><![CDATA[recaptcha-v3]]></category>
            <category><![CDATA[recaptcha]]></category>
            <category><![CDATA[laravel]]></category>
            <category><![CDATA[web-development]]></category>
            <dc:creator><![CDATA[Janaina Ludwig]]></dc:creator>
            <pubDate>Thu, 31 Oct 2019 13:38:24 GMT</pubDate>
            <atom:updated>2019-10-31T13:38:24.361Z</atom:updated>
            <content:encoded><![CDATA[<h4>Usando o reCAPTCHA do Google para evitar spams sem prejudicar a experiência do usuário</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*fUntze6GCPqXic5Y" /><figcaption>Photo by <a href="https://unsplash.com/@agkdesign?utm_source=medium&amp;utm_medium=referral">Alex Knight</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>Na <a href="https://tog.design/">tog.design</a>, depois de testarmos algumas abordagens, decidimos implementar em nossos projetos o reCAPTCHA v3, visando melhorar a experiência de uso, evitando assim a submissão de spams. Neste artigo explicamos passo a passo como fizemos essa <a href="#f823">implementação</a>.</p><p>Um dos problemas mais comuns com formulários públicos são os spams feitos por bots. Existem diversas abordagens para evitar a submissão desses spams, como adicionar um campo invisível que somente os bots conseguem ver ou adicionar questões simples como “5 + 3?”, mas esses métodos nem sempre são eficientes.</p><p>Também há diversos sistemas de CAPTCHA (<em>Completely Automated Public Turing test to tell Computers and Humans Apart</em>) que, basicamente, são sistemas automatizados para diferenciar humanos de computadores ou bots. No entanto, vários desses sistemas prejudicam a experiência do usuário por necessitarem, por exemplo, que os usuários digitem caracteres difíceis de serem lidos (o que é bem chato):</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*VkAJevM5o5hmiu1LdB6_CA.jpeg" /></figure><p>No entanto, com a <strong>versão 3</strong> do Google reCAPTCHA o usuário não precisa responder campos adicionais, nem ler caracteres estranhos. Ele não precisa fazer nada.</p><h4>reCAPTCHA v3</h4><p>Nesta versão, o sistema do Google atribui um score<em> </em>ao usuário de 0 a 1, baseado nas interações com a página. Quanto mais próximo de 1, maior a chance de ser um humano. Então, você decide qual o score mínimo aceitável para permitir que o formulário seja enviado, e pode, por exemplo, fazer algum outro tipo de verificação à sua escolha para dar “outra chance” ao usuário se julgar necessário.</p><p><strong>Então vamos à implementação…</strong></p><h3>Como implementar o reCAPTCHA v3 no framework Laravel?</h3><ul><li>Primeiro, é necessário que você <a href="https://www.google.com/recaptcha/admin/create">registre seu site na página do reCAPTCHA</a>:</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/605/1*_ktupdQFW1gbuA2t-gD0_Q.png" /></figure><p><strong>Importante: Não esqueça de adicionar os domínios corretos do seu site ao registrá-lo.</strong></p><ul><li>Serão geradas duas chaves: Uma pública e outra privada (ou secreta).</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/798/1*TcHkXQZrB1JM8aCWsrRu0g.png" /><figcaption>A primeira chave é a pública e a segunda é a privada.</figcaption></figure><p>Adicione essas chaves no arquivo <strong><em>.env</em></strong> do seu projeto:</p><pre>GOOGLE_RECAPTCHA_PUBLIC_KEY=<strong><em>CHAVE_PUBLICA</em></strong><br>GOOGLE_RECAPTCHA_PRIVATE_KEY=<strong><em>CHAVE_PRIVADA</em></strong></pre><p>Lembre-se de <strong>não </strong>deixar exposta a chave privada. Ela será usada somente no servidor.</p><ul><li>No diretório <strong><em>config </em></strong>da <em>root </em>do projeto, crie um novo arquivo de configurações chamado <strong><em>recaptcha.php</em></strong>. Usaremos esse arquivo para as configurações do score mínimo aceitável e as chaves do reCAPTCHA (não é adequado acessá-las diretamente pelo <em>.env</em>). O arquivo ficará dessa forma:</li></ul><pre>&lt;?php<br>return [<br>    &#39;v3&#39; =&gt; [<br>        &#39;public_key&#39; =&gt; env(&#39;GOOGLE_RECAPTCHA_PUBLIC_KEY&#39;),<br>        &#39;private_key&#39; =&gt; env(&#39;GOOGLE_RECAPTCHA_PRIVATE_KEY&#39;),<br>        &#39;minimum_score&#39; =&gt; 0.6,<br>    ]<br>];</pre><p>O score<em> </em>mínimo que decidi usar ficou em 0.6, mas pode ser ajustado conforme a necessidade.</p><ul><li>Rode o comando <strong><em>php artisan config:cache</em></strong> para limpar e fazer um novo cache das configurações. Não esqueça de rodar esse comando sempre que alterar as configurações.</li></ul><p>A verificação do usuário é feita em duas etapas:</p><ol><li>Quando o usuário submeter o formulário, fazemos uma verificação pela api JavaScript fornecida pelo reCAPTCHA (logo vamos adicioná-la no projeto). Isso retornará um token que devemos enviar para o backend.</li><li>Enviaremos esse token para a api do Google para receber o score do usuário. Então, basta comparar com o score mínimo que definimos no arquivo de configuração para decidir se o formulário será enviado de fato.</li></ol><h4>Etapa 1: Frontend</h4><ul><li>Antes de tudo precisamos adicionar o arquivo do Google reCAPTCHA (api JS com a chave pública do site).</li><li>Também iremos colocar a chave pública em uma <em>meta tag</em> para poder acessá-la no arquivo JS.</li></ul><p>Para isso, adicione essas duas linhas na head do seu html:</p><pre>&lt;meta name=&quot;grecaptcha-key&quot; content=&quot;{{config(&#39;recaptcha.v3.public_key&#39;)}}&quot;&gt;</pre><pre>&lt;script src=&quot;https://www.google.com/recaptcha/api.js?render={{config(&#39;recaptcha.v3.public_key&#39;)}}&quot;&gt;&lt;/script&gt;</pre><ul><li>Agora no arquivo <strong>app.js </strong>iremos buscar os formulários que precisam da verificação do reCAPTCHA e, ao serem submetidos, será adicionado um input contendo o valor do token recebido da api.</li></ul><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/392554a5be96a339ff839ef72a5cb19d/href">https://medium.com/media/392554a5be96a339ff839ef72a5cb19d/href</a></iframe><p>Lembre-se que ao editar o arquivo JS é necessário rodar o Laravel Mix (como o comando <em>npm run watch</em>) para compilar os <em>assets</em>.</p><ul><li>Assim, ao criar um formulário só é necessário adicionar o atributo <strong>data-grecaptcha-action</strong> e definir a ação do formulário (a ação é uma forma de categorizar os requests por formulário, e será exibida no dashboard do reCAPTCHA). A tag do formulário ficará assim:</li></ul><pre>&lt;form action=&quot;{{route(&#39;message&#39;)}}&quot; <strong>data-grecaptcha-action=&quot;message&quot; </strong>method=&quot;POST&quot;&gt;<br>...<br>&lt;/form&gt;</pre><h4>Etapa 2: Backend</h4><p>No backend precisamos receber o score<em> </em>e compará-lo, e para isso criaremos uma regra de validação. Dessa forma, haverá apenas uma classe responsável por isso, e poderemos reutilizá-la sempre que necessário.</p><ul><li>Para criar a classe execute o comando <strong>php artisan make:rule ReCAPTCHAv3</strong>. Esse comando irá criar uma nova regra de validação no diretório <strong><em>app/Rules</em></strong>.</li><li>Agora, precisamos fazer um request para a api do reCAPTCHA. Para fazer esse request, instale o <a href="https://github.com/guzzle/guzzle">Guzzle</a> no projeto — <strong>composer require guzzlehttp/guzzle</strong> — caso ainda não tenha. O Guzzle facilita trabalhar com requests HTTP.</li></ul><p>A regra de validação ficará dessa forma:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/00be7bcc2a2cb1ca4b8e6c82bd8ebd89/href">https://medium.com/media/00be7bcc2a2cb1ca4b8e6c82bd8ebd89/href</a></iframe><p>O método <strong><em>passes</em> </strong>recebe o token do reCAPTCHA enviado pelo formulário. É nesse método que devemos validar se o request passa pela validação.</p><p>Para isso, é criado uma nova instância do Guzzle e feito um request com os dados necessários para a api do Google. Repare que é aqui que utilizamos a chave privada do reCAPTCHA. A variável <em>$value</em> contém o valor do token.</p><p>Para deixar o código mais limpo, criei um método <strong><em>getScore </em></strong>nesta mesma classe, que abstrai a extração do <em>score</em> do json recebido na <em>$response. </em>E a mensagem de erro é customizada no método <strong><em>message</em></strong>.</p><ul><li>Então basta usar a regra de validação:</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/478/1*HImKINhmGszhCWvJM_yROQ.png" /></figure><p>Lembre-se que o ideal é criar uma classe responsável pela validação (form request), mas esse não é o foco deste tutorial. Você pode ver mais sobre isso <a href="https://laravel.com/docs/6.x/validation#form-request-validation">neste link</a>.</p><p><strong>Em resumo:</strong></p><ul><li>Registre o site no reCAPTCHA para conseguir as chaves;</li><li>Armazene as chaves no <em>.env</em> e crie um arquivo de configurações para elas;</li><li>Importe a api JS do reCAPTCHA;</li><li>Defina o nome da ação do formulário;</li><li>Ao submeter um formulário, faça um request pelo token do reCAPTHA na api JS;</li><li>Envie esse token junto com o request para o backend;</li><li>Crie uma regra de validação que faça o request do score usando o token recebido e valide com o score mínimo que você definiu;</li><li>Utilize essa regra de validação para o token recebido do formulário.</li></ul><p><strong>Resultado final</strong></p><p>Com esses passos, quando um <strong>novo formulário</strong> precisar da validação do reCAPTCHA, basta adicionar o atributo <strong>data-grecaptcha-action=”acao”</strong><em> </em>no formulário e utilizar a regra de validação <strong>ReCAPTCHAv3</strong> no backend.</p><p>Você pode conferir o resultado final no <a href="https://github.com/JanainaLudwig/recaptchalaravel">GitHub</a>.</p><p><strong>Alguns artigos interessantes relacionados</strong> (em inglês):</p><p>tutsforweb: <a href="https://tutsforweb.com/google-recaptcha-laravel-application/">Google Recaptcha In Laravel Application</a></p><p>DZone: <a href="https://dzone.com/articles/adding-google-recaptcha-v3-to-your-laravel-app">Adding Google reCAPTCHA v3 to Your Laravel App</a></p><p>Welcm: <a href="https://medium.com/@welcm/adding-google-recaptcha-v3-to-your-laravel-forms-eb317684245">Adding Google reCAPTCHA v3 to your Laravel Forms</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b481bc07aa54" width="1" height="1" alt=""><hr><p><a href="https://medium.com/togdesign/como-adicionar-o-google-recaptcha-v3-em-uma-aplicacao-laravel-b481bc07aa54">Como adicionar o Google reCAPTCHA v3 em uma aplicação Laravel</a> was originally published in <a href="https://medium.com/togdesign">tog.design</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>