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

title	slug
Release 2022.12	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

• Customisable Captcha stage

  The captcha stage now supports alternate compatible providers, like hCaptcha and Turnstile.

• 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. Afterwards, simply run docker-compose up -d.

Kubernetes

Update your values to use the new images:

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.