# Mukautetun reCAPTCHA-sivun opas

## Edellytykset

{% hint style="warning" %}
Varmista, että Netacea on määrittänyt ja ottanut käyttöön CAPTCHA:n tilillesi. Varmista myös, että vakiomuotoinen CAPTCHA-sivu on testattu ja että sitä voidaan näyttää ennen mukautetun CAPTCHA-sivun käyttöönottoa.
{% endhint %}

Edellyttäen, että yllä mainitut edellytykset on täytetty, mukautettu CAPTCHA-sivu voidaan luoda seuraavasti:

## HTML-sivu

Luotaessa HTML-sivua CAPTCHA:n näyttämistä varten voi olla hyödyllistä aloittaa Netacea-mallipohjasta ennen mukautetun HTML-koodin lisäämistä. [Mallipohja](#netacea-captcha-template) löytyy tämän dokumentin lopusta.\
\
Mukautettu HTML-sivusi voidaan suunnitella erityisvaatimustesi ja/tai yrityksesi brändin mukaisesti, mutta sivun on sisällettävä seuraava koodi.\
\
**Seuraavien skriptien tulee olla dokumentin head-elementin sisällä (`<head>...</head>`):**

```html
<link rel="stylesheet" href="https://assets.ntcacdn.net/Mitigations/captcha-1.0.0.css">
<script src="https://www.recaptcha.net/recaptcha/api.js" async defer></script>
```

**Lisäksi lisää seuraava koodi jonnekin body-elementin sisälle (`<body>...</body>`):**

```html
<form id="frmCaptcha" action="" method="POST">
    <div class="g-recaptcha" data-sitekey="{{CAPTCHA_SITE_KEY}}" data-callback="showButton"></div>
    <br />
    <input type="submit" value="Submit" class="btn btnHidden">
    <input type="hidden" maxlength="40" id="hitid" name="hitid" value="{{TRACKING_ID}}">
</form>
```

**Alla olevat skriptit on myös lisättävä body-elementin loppuun, mutta kuitenkin sen sisälle (`<body>...</body>`):**

```html
<script src="https://assets.ntcacdn.net/Mitigations/fetch-polyfill-3.6.2.js"></script>
<script src="https://assets.ntcacdn.net/Mitigations/submit-captcha-2.0.2.js"></script>
```

{% hint style="warning" %}
Huomaa, että tietyt linkit CAPTCHA-sivulla eivät välttämättä toimi, jos ne ovat Netacea-suojauksen piirissä olevan sivuston takana.
{% endhint %}

### Netacea CAPTCHA -mallipohja

```html
<!DOCTYPE html>
<html lang="en">
<head runat="server">
    <meta name="viewport" content="initial-scale=1.0, width=device-width, maximum-scale=1.0" />
    <meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate" />
    <meta http-equiv="Pragma" content="no-cache" />
    <meta http-equiv="Expires" content="0" />
    <title>Captcha Page</title>
    <link rel="stylesheet" href="https://assets.ntcacdn.net/Mitigations/captcha-1.1.1.css">
    <script src="https://www.recaptcha.net/recaptcha/api.js" async defer></script>
</head>
<body>
    <div class="wrapper">
        <header>
            <!-- header content -->
            <h1>Help us verify real visitors</h1>
            <!-- End of header  content -->
        </header>
        
        <!-- statement content -->
        <p>Please complete to continue</p>
        <!-- End of statement content -->

        <!-- Captcha Form, Do not change-->
            <form id="frmCaptcha" action="" method="POST">
                <div class="g-recaptcha" data-sitekey="{{CAPTCHA_SITE_KEY}}" data-callback="showButton"></div>
                <br />
                <input type="submit" value="Submit" class="btn btnHidden">
                <input type="hidden" maxlength="40" id="hitid" name="hitid" value="{{TRACKING_ID}}">
            </form>
        <!-- End of captcha form -->

        <div class="wrapper-values"></div>
    </div>
    <!-- The following two scripts MUST be at the end of the body -->
    <script src="https://assets.ntcacdn.net/Mitigations/fetch-polyfill-3.6.2.js"></script>
    <script src="https://assets.ntcacdn.net/Mitigations/submit-captcha-2.3.0.js"></script>
    <!-- End of scripts at the end of body -->
</body>
</html>
```

*Kun mukautettu CAPTCHA-sivu on valmis, toimita valmis CAPTCHA HTML-sivu Netaecalle. Se ladataan palvelimillemme ja uutta sivua käytetään kaikilla Netacea Bot Management -ratkaisun näyttämillä CAPTCHA-sivuilla.*

### CAPTCHA:n automaattinen viimeistely

Netacea tarjoaa myös reCAPTCHA-sivumallin, jossa CAPTCHA-haaste viimeistellään automaattisesti, kun käyttäjä on suorittanut haasteen. Jos haluat käyttää tätä ratkaisua, käytä alla olevaa mallipohjaa

```html
<!DOCTYPE html>
<html lang="en">
<head runat="server">
    <meta name="viewport" content="initial-scale=1.0, width=device-width, maximum-scale=1.0" />
    <meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate" />
    <meta http-equiv="Pragma" content="no-cache" />
    <meta http-equiv="Expires" content="0" />
    <title>Auto-submit reCaptcha Custom Page</title>
    <link rel="stylesheet" href="https://assets.ntcacdn-uat.net/Mitigations/captcha-1.1.1.css">
    <script src="https://assets.ntcacdn-uat.net/Mitigations/fetch-polyfill-3.6.2.js"></script>
    <script src="https://www.recaptcha.net/recaptcha/api.js" async defer></script>
    <script src="https://assets.ntcacdn-uat.net/Mitigations/submit-captcha-2.3.0.js" async defer></script>
</head>
<body>
    <div class="wrapper">
        <header>
            <!-- header content -->
            <h1>Help us verify real visitors</h1>
            <!-- End of header  content -->
        </header>
        
        <!-- statement content -->
        <p>Please complete to continue</p>
        <!-- End of statement content -->

        <!-- Captcha Form, Do not change-->
        <form id="frmCaptcha" action="" method="POST" data-auto-submit>
            <div class="g-recaptcha" data-sitekey="{{CAPTCHA_SITE_KEY}}" data-callback="frmCaptchaCallback"></div><br /><input
                type="submit" value="Submit" class="btn btnHidden"><input type="hidden" maxlength="40" id="hitid"
                name="hitid" value="{{TRACKING_ID}}">
        </form>
    </div>
</body>
</html>
```
