authentik/website/docs/releases/v2022.12.md

---
title: Release 2022.12
slug: "2022.12"
---

## New features

-   Bundled GeoIP City database

    authentik now comes with a bundled MaxMind GeoLite2 City database. This allows everyone to take advantage of the extra data provided by GeoIP. The default docker-compose file removes the GeoIP update container as it is no longer needed. See more [here](../core/geoip)

-   Customisable Captcha stage

    The captcha stage now supports alternate compatible providers, like [hCaptcha](https://docs.hcaptcha.com/switch/) and [Turnstile](https://developers.cloudflare.com/turnstile/get-started/migrating-from-recaptcha/).

-   Preview for OAuth2 and SAML providers

    OAuth2 and SAML providers can now preview what the currently selected property/scope mappings's outcome will look like. This helps with seeing what data is sent to the client and implementing and testing custom mappings.

## Upgrading

This release does not introduce any new requirements.

### docker-compose

Download the docker-compose file for 2022.12 from [here](https://goauthentik.io/version/2022.12/docker-compose.yml). Afterwards, simply run `docker-compose up -d`.

### Kubernetes

Update your values to use the new images:

```yaml
image:
    repository: ghcr.io/goauthentik/server
    tag: 2022.12.0
```

## Minor changes/fixes

## API Changes

#### What's Changed

---

##### `GET` /stages/captcha/{stage_uuid}/

###### Return Type:

Changed response : **200 OK**

-   Changed content type : `application/json`

    -   Added property `js_url` (string)

    -   Added property `api_url` (string)

    -   Changed property `public_key` (string)
        > Public key, acquired your captcha Provider.

##### `PUT` /stages/captcha/{stage_uuid}/

###### Request:

Changed content type : `application/json`

-   Added property `js_url` (string)

-   Added property `api_url` (string)

-   Changed property `public_key` (string)

    > Public key, acquired your captcha Provider.

-   Changed property `private_key` (string)
    > Private key, acquired your captcha Provider.

###### Return Type:

Changed response : **200 OK**

-   Changed content type : `application/json`

    -   Added property `js_url` (string)

    -   Added property `api_url` (string)

    -   Changed property `public_key` (string)
        > Public key, acquired your captcha Provider.

##### `PATCH` /stages/captcha/{stage_uuid}/

###### Request:

Changed content type : `application/json`

-   Added property `js_url` (string)

-   Added property `api_url` (string)

-   Changed property `public_key` (string)

    > Public key, acquired your captcha Provider.

-   Changed property `private_key` (string)
    > Private key, acquired your captcha Provider.

###### Return Type:

Changed response : **200 OK**

-   Changed content type : `application/json`

    -   Added property `js_url` (string)

    -   Added property `api_url` (string)

    -   Changed property `public_key` (string)
        > Public key, acquired your captcha Provider.

##### `GET` /flows/executor/{flow_slug}/

###### Return Type:

Changed response : **200 OK**

-   Changed content type : `application/json`

    Updated `ak-stage-captcha` component:
    New required properties:

    -   `js_url`

    *   Added property `js_url` (string)

##### `POST` /flows/executor/{flow_slug}/

###### Return Type:

Changed response : **200 OK**

-   Changed content type : `application/json`

    Updated `ak-stage-captcha` component:
    New required properties:

    -   `js_url`

    *   Added property `js_url` (string)

##### `POST` /stages/captcha/

###### Request:

Changed content type : `application/json`

-   Added property `js_url` (string)

-   Added property `api_url` (string)

-   Changed property `public_key` (string)

    > Public key, acquired your captcha Provider.

-   Changed property `private_key` (string)
    > Private key, acquired your captcha Provider.

###### Return Type:

Changed response : **201 Created**

-   Changed content type : `application/json`

    -   Added property `js_url` (string)

    -   Added property `api_url` (string)

    -   Changed property `public_key` (string)
        > Public key, acquired your captcha Provider.

##### `GET` /stages/captcha/

###### Return Type:

Changed response : **200 OK**

-   Changed content type : `application/json`

    -   Changed property `results` (array)

        Changed items (object): > CaptchaStage Serializer

        -   Added property `js_url` (string)

        -   Added property `api_url` (string)

        -   Changed property `public_key` (string)
            > Public key, acquired your captcha Provider.