Перайсці да змесціва

Як выбраць reCAPTCHA для формы і атрымаць ключы

reCAPTCHA абараняе формы сайта ад спам-ботаў. За 2025 год Google перанёс усе ключы reCAPTCHA ў Google Cloud, таму многія старыя інструкцыі састарэлі: ключы цяпер ствараюцца і мяняюцца ў кансолі Google Cloud, а ў бясплатнага выкарыстання ёсць штомесячны ліміт.

Разбіраю, чым адрозніваюцца тыпы reCAPTCHA і які выбраць для формы, дзе цяпер стварыць ключ, дзе знайсці сакрэтны ключ для плагіна і што будзе, калі перавысіць ліміт.


Шчыт з замком у акне браўзера, спіс крокаў і знак пытання — інструкцыя па выбары reCAPTCHA і атрыманні ключоў

Якія бываюць тыпы

  • Сцяжок «Я не робат» — раней v2 checkbox. Наведвальнік ставіць птушачку, часам вырашае заданне з карцінкамі. Зразумела і надзейна, але дадае лішні крок.
  • Ацэнка без задання — раней v3. Наведвальнік нічога не бачыць: reCAPTCHA ацэньвае паводзіны і вяртае бал ад 0,0 (хутчэй бот) да 1,0 (хутчэй чалавек). Што рабіць з нізкім балам, вырашае сайт.
  • Нябачная з заданнем пры падазрэнні — раней v2 invisible. Новыя ключы гэтага тыпу ў кансолі Google Cloud стварыць нельга, Google прапануе замест іх звычайны ключ для сайта.

Як выбраць

  • Звычайная форма заяўкі або зваротнай сувязі — пачніце з ацэнкі без задання: наведвальнік нічога не заўважае. Важна, каб сайт або плагін формы ўмеў правяраць бал і адкідаць заяўкі ніжэй за парог. Для пачатку Google прапануе парог 0,5.
  • Рэгістрацыя, уваход, формы, якія атакуюць актыўна — сцяжок надзейней: боту давядзецца прайсці заданне.
  • Плагін формы падтрымлівае толькі адзін тып — бярыце той, што падтрымлівае плагін. Ключы розных тыпаў не ўзаемазамяняльныя.

Крок 1. Стварыце ключ у Google Cloud

  1. Адкрыйце кансоль Google Cloud і выберыце або стварыце праект для сайта.
  2. Перайдзіце на старонку reCAPTCHA. Цяпер яна знаходзіцца ў раздзеле Fraud Defense, прамы адрас — console.cloud.google.com/security/recaptcha.
  3. Стварыце ключ: дайце яму зразумелую назву, выберыце платформу для сайтаў і дадайце дамены, на якіх будзе працаваць форма.
  4. Выберыце тып: са сцяжком або на аснове ацэнкі.

Ідэнтыфікатар ключа (Key ID) — гэта і ёсць ключ сайта, які ўстаўляецца ў форму.

Крок 2. Знайдзіце сакрэтны ключ для плагіна

Большасць плагінаў формаў і CMS просяць пару «ключ сайта + сакрэтны ключ». У кансолі Google Cloud сакрэтны ключ па змаўчанні не паказваецца. Каб яго атрымаць:

  1. Адкрыйце ключ на ўкладцы Keys і перайдзіце на ўкладку Integration.
  2. Націсніце Use Legacy Key, а калі ключ яшчэ не наладжаны для такога выкарыстання — Integrate with a third-party service or plugin.
  3. Скапіруйце сакрэтны ключ з акна, якое адкрылася. Захоўвайце яго як пароль: у код старонкі ён трапляць не павінен.

Назвы дадзены па англамоўным інтэрфейсе кансолі, на іншых мовах яны перакладзеныя.

Крок 3. Праверце форму

  • Адпраўце тэставую заяўку — яна павінна дайсці.
  • Пераканайцеся, што значок або сцяжок reCAPTCHA з’явіўся менавіта на форме.
  • Калі выкарыстоўваеце ацэнку, паглядзіце ў кансолі, якія балы атрымліваюць заяўкі, і пры неабходнасці папраўце парог.

Ліміт: 10 000 праверак у месяц

Без падключанай аплаты reCAPTCHA бясплатна выконвае 10 000 праверак у месяц. Невялікаму сайту з формай зваротнай сувязі гэтага звычайна хапае з запасам. Важная дэталь: калі ліміт вычарпаны, а аплата не падключана, стары спосаб праверкі (SiteVerify), якім карыстаецца большасць плагінаў, не блакуе заяўкі, а прапускае іх з балам 0,9. Абарона фактычна выключаецца, і спам ідзе зноў.

Калі ключ калісьці ствараў падрадчык

Пры аўтаматычным пераносе Google стварыў праекты Google Cloud і разаслаў запрашэнні ўладальнікам старых ключоў. Ключы працягваюць працаваць, нават калі запрашэнне не прынята, але мяняць іх можна толькі пасля прыняцця. Калі адміністратар ключа больш недаступны, вярнуць праект нельга — прасцей стварыць новы ключ у сваім праекце і замяніць яго ў форме.

Палітыка прыватнасці. reCAPTCHA адпраўляе ў Google даныя пра наведвальніка формы. Згадайце гэта ў палітыцы прыватнасці сайта і ўлічыце ў наладах cookie-банера.

Коратка

  1. Для звычайнай формы пачніце з ацэнкі без задання, для ўваходу і рэгістрацыі — са сцяжка.
  2. Ключы ствараюцца ў кансолі Google Cloud, на старонцы reCAPTCHA.
  3. Сакрэтны ключ для плагіна — ва ўкладцы Integration ключа.
  4. Бясплатна — 10 000 праверак у месяц; пры перавышэнні без аплаты абарона перастае працаваць.
  5. Калі стары ключ недаступны, стварыце новы ў сваім праекце.

Калі формы засыпаны спамам або капча перастала працаваць пасля пераезду ключоў, мы можам абараніць формы з дапамогай reCAPTCHA: падбярэм тып, аформім ключы ў вашым праекце, падключым і праверым заяўкі.