199 lines
4.5 KiB
Markdown
199 lines
4.5 KiB
Markdown
---
|
|
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.
|