# Captcha

{% hint style="info" %}
Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach.
{% endhint %}

Komponent captchy jest widżetem googlowym, celem którego jest dopuszczenie do przesłania danych tylko wypełnionych przez człowieka.

![](https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/5XIDttualUtt5dKz32NV/Captcha_files/image2025-5-15_15-54-3.png)

## Właściwości komponentu

Na wniosku komponent można umieścić wiele razy, a wyświetlanie go można uzależnić od spełnienia warunku.

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2F9nKGbLFkTskXoe6eQzma%2Fimage2016-9-19%2012_59_8.png?alt=media&#x26;token=1b0c8952-daeb-4ffc-9729-16dfb36315b4" alt=""><figcaption><p align="center"><em><strong>Ilustracja 1.</strong> Komponent captchy wyświetlany na wniosku</em></p></figcaption></figure>

Podanie wartości captchy umieszczonej na wniosku jest zawsze obowiązkowe - weryfikacja będzie pozytywna wtedy, gdy zostanie zaznaczone pole "Nie jestem robotem" oraz opcjonalnie zostaną wykonane inne czynności (narzucone przez Google).

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2FLTDUFAwufh7eY7wWFl87%2Fimage.png?alt=media&#x26;token=beeb7c67-5af7-413c-b451-809fd4cb7b7a" alt=""><figcaption><p align="center"><em><strong>Ilustracja 2.</strong></em> <em>W przykładzie nie zostało zaznaczone pole "Nie jestem robotem", co spowodowało wyświetlenie komunikatu błędu walidacji</em></p></figcaption></figure>

Walidacja komponentu następuje po poprawnym zaznaczeniu grafiki. Komponent przechowuje 3 rodzaje stanów: zbyt długi czas oczekiwania po weryfikacji - "expired", weryfikacja pozytywna - "ok" lub negatywna - "noOk". Interakcje na wniosku mogą być zależne od stanu komponentu.

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2FQtUGPOXqd2MUu04lkWcp%2Fimage2016-9-20%208_0_3.png?alt=media&#x26;token=db3c5792-4b5c-483e-9e91-5c6d76a31b2e" alt=""><figcaption><p align="center"><em><strong>Ilustracja 3.</strong></em> <em>Komunikat po poprawnej weryfikacji</em></p></figcaption></figure>

## Rejestracja

Aby można było korzystać na wniosku z komponentu, należy zarejestrować w Google domenę oraz parę kluczy. Więcej na ten temat na stronie [Google](https://developers.google.com/recaptcha).

{% hint style="info" %}
Wniosek demo: demo2\_recaptcha
{% endhint %}