Skip to main content

Release 2021.10

Headline Changes

  • Flow Inspector

    To better understand how a flow works, and why things might not be working as intended, you can now launch Flows with an inspector enabled. This is simply triggered by adding a ?inspector to the URL. Currently, only superuser have the permission to access the Inspector.

    The inspector shows the current stage, previous stages, next planned stages, and the current flow context.

  • SMS Authenticator

    You can now use SMS-based TOTP authenticators. This new Stage supports both Twilio, and a generic API endpoint, if using another provider. This stage does not have to be used for authentication, it can simply be used during enrollment to verify your users phone numbers.

  • Sign in with Apple

    It is now possible to add an Apple OAuth Source, to allow your users to authenticate with their Apple ID.

A huge shoutout to all the people that contributed, helped test and also translated authentik. This is the first release that has as full French translation!

Minor changes

  • *: Squash Migrations (#1593)
  • admin: clear update notification when notification's version matches current version
  • cmd: prevent outposts from panicking when failing to get their config
  • core: add default for user's settings attribute
  • core: add settings serializer to user/me and update_self endpoints, saved in a key in attributes
  • core: improve detection for s3 settings to trigger backup
  • core: include group uuids in self serializer
  • core: make user's name field fully optional
  • flows: inspector (#1469)
  • internal: add internal healthchecking to prevent websocket errors
  • internal/proxyv2: improve error handling when configuring app
  • lifecycle: bump celery healthcheck to 5s timeout
  • lifecycle: only lock database when system migrations need to be applied, and during django migrations, and don't double unlock
  • lifecycle: only set prometheus_multiproc_dir in ak wrapper to prevent full disk on worker
  • managed: don't run managed reconciler in foreground on startup
  • outpost/proxy: fix missing negation for internal host ssl verification
  • outposts: add additional error checking for docker controller
  • outposts: Adding more flexibility to outposts in Kubernetes. (#1617)
  • outposts: allow disabling of docker controller port mapping
  • outposts: check ports of deployment in kubernetes outpost controller
  • outposts: don't always build permissions on outpost.user access, only in signals and tasks
  • outposts: fallback to known-good outpost image if configured image cannot be pulled
  • outposts: fix error when comparing ports in docker controller when port mapping is disabled
  • outposts: handle k8s 422 response code by recreating objects
  • outposts: rename docker_image_base to container_image_base, since its not docker specific
  • outposts/ldap: Support hard coded uidNumber and gidNumber. (#1582)
  • outposts/proxy: add new headers with unified naming
  • outposts/proxy: fix duplicate protocol in domain auth mode
  • outposts/proxy: show full error message when user is authenticated
  • policies: add additional filters to create flow charts on frontend
  • policies/password: add extra sub_text field in tests
  • providers/ldap: use RDN when using posixGroup's memberUid attribute (#1514)
  • providers/proxy: always check ingress secret in kubernetes controller
  • providers/proxy: update ingress controller to work with k8s 1.22
  • recovery: handle error when user doesn't exist
  • root: add docker-native healthcheck for web and celery
  • root: add translation for backend strings
  • root: coverage with toml support
  • root: fix error with sentry proxy
  • root: migrate docker images to netlify proxy (#1603)
  • root: remove redundant internal network from compose
  • root: remove structlog.processors.format_exc_info for new structlog version
  • root: Use fully qualified names for docker bases base images. (#1490)
  • sources/ldap: add support for Active Directory userAccountControl attribute
  • sources/ldap: don't sync ldap source when no property mappings are set
  • sources/ldap: fix logic error in Active Directory account disabled status
  • sources/oauth: add Sign in with Apple (#1635)
  • stages/authenticator_sms: add generic provider (#1595)
  • stages/authenticator_sms: Add SMS Authenticator Stage (#1577)
  • stages/authenticator_validate: create a default authenticator validate stage with sensible defaults
  • stages/email: add activate_user_on_success flag, add for all example flows
  • stages/prompt: add sub_text field to add HTML below prompt fields
  • stages/prompt: fix sub_text not allowing blank
  • stages/prompt: fix wrong field type of field_key
  • stages/user_login: add check for user.is_active and tests
  • stages/user_write: allow recursive writing to user.attributes
  • web: add locale detection
  • web: ensure fallback locale is loaded
  • web: fix rendering of token copy button in dark mode
  • web: fix strings not being translated at all when matching browser locale not found
  • web: make table pagination size user-configurable
  • web: new default flow background
  • web: Translate /web/src/locales/en.po in fr_FR (#1506)
  • web/admin: add fallback font for doughnut charts
  • web/admin: default to warning state for backup task
  • web/admin: don't require username nor name for activate/deactivate toggles
  • web/admin: fix description for flow import
  • web/admin: fix LDAP Source form not exposing syncParentGroup
  • web/admin: fix search group label
  • web/admin: fix SMS Authenticator stage not loading state correctly
  • web/admin: improve visibility of oauth rsa key
  • web/admin: only show outpost deployment info when not embedded
  • web/admin: truncate prompt label when too long
  • web/elements: fix initialLoad not being done when viewportCheck was disabled
  • web/elements: fix model form always loading when viewport check is disabled
  • web/elements: use dedicated button for search clear instead of webkit exclusive one
  • web/flows: adjust message for email stage
  • web/user: don't show managed tokens in user interface
  • web/user: initial optimisation for smaller screens
  • web/user: load interface settings from user settings

Fixed in 2021.10.1-rc2

  • core: add user flag to prevent users from changing their usernames
  • core: log user for http requests
  • flows: clear cache when deleting bindings
  • outpost/ldap: fix logging for mismatched provider
  • root: add cookie domain setting
  • sources/oauth: add choices to oauth provider_type
  • web: disable Sentry.showReportDialog
  • web/flows: showing of authentik logo in flow executor
  • web/flows: fix authenticator device selection not updating
  • web/flows: show cancel link when choosing authenticator challenge

Fixed in 2021.10.1-rc3

  • api: fix error when connection to websocket via secret_key
  • core: add toggle to completely disable backup mechanism
  • events: fix error when notification transport doesn't exist anymore
  • outposts: fix docker controller not using object_naming_template
  • providers/oauth2: fallback to uid if UPN was selected but isn't available
  • providers/oauth2: fix events being created from /application/o/authorize/
  • sources/ldap: prevent key users from being set as this is an M2M relation
  • sources/ldap: skip values which are of type bytes

Fixed in 2021.10.1

  • core: add API for all user-source connections
  • core: add API to list all authenticator devices
  • core: add created field to source connection
  • flows: optimise stage user_settings API
  • outposts: separate websocket re-connection logic to decrease requests on reconnect
  • root: pin node images to v16
  • root: update golang ldap server package
  • web/user: fix wrong device being selected in user's mfa update form
  • web/user: rework MFA Device UI to support multiple devices
  • web/user: update form to update mfa devices

Fixed in 2021.10.2

  • api: replace django sentry proxy with go proxy to prevent login issues
  • providers/proxy: allow configuring of additional scope mappings for proxy
  • providers/saml: fix error on missing AssertionConsumerServiceURL, fall back to default ACS
  • root: fix Detection of S3 settings for backups
  • root: fix postgres install on bullseye
  • root: update base images for outposts
  • root: update to buster
  • stages/identification: add show_source_labels option, to show labels for sources
  • stages/invitation: don't throw 404 error in stage
  • stages/invitation: remove invitation from plan context after deletion
  • stages/prompt: fix type in Prompt not having enum set
  • web/flows: fix invalid validation for static tokens
  • web/flows: fix sub_text not rendering for static fields
  • web/user: fix configureUrl not being passed to <ak-user-settings-password>

Fixed in 2021.10.3

  • admin: improve check to remove version notifications
  • cmd/server: improve cleanup on shutdown
  • core: add command to output full config
  • core: fix auth_method for tokens
  • core: include parent group name
  • core: make group membership lookup respect parent groups (upwards)
  • events: ignore creation/deletion of AuthenticatedSession objects
  • internal: start embedded outpost directly after backend is healthy instead of waiting
  • lifecycle: revert to non-h11 worker
  • outpost/ldap: don't cleanup user info as it is overwritten on bind
  • providers/*: include list of outposts
  • providers/ldap: add/squash migrations
  • providers/ldap: memory Query (#1681)
  • recovery: add create_admin_group management command
  • root: fix defaults for EMAIL_USE_TLS
  • root: improve compose detection, add anonymous stats
  • root: keep last 30 backups
  • sources/ldap: remove deprecated default
  • sources/oauth: set prompt=none for Discord provider
  • sources/plex: allow users to connect their plex account without login flow
  • sources/plex: use exception_to_string in tasks
  • stages/authenticator_*: add default name for authenticators
  • stages/identification: only allow limited challenges for login sources
  • stages/identification: use random sleep
  • stages/prompt: add text_read_only field
  • stages/prompt: default prompts to the current value of the context
  • stages/prompt: only set placeholder when in context
  • stages/prompt: set field placeholder based on plan context
  • stages/prompt: use initial instead of default
  • web: fix linting errors by adding a wrapper for next param
  • web/admin: only show flows with an invitation stage configured instead of all enrollment flows
  • web/admin: show warning on invitation list when no stage exists or is bound
  • web/admin: show warning on provider when not used with outpost
  • web/flows: fix authenticator_validate not allowing alphanumeric codes due to empty pattern
  • web/flows: improve display of static tokens
  • web/user: fix ak-user-settings-password getting wrong configureUrl
  • web/user: fix device type for static tokens
  • web/user: fix empty page when no sources to connect exist
  • web/user: fix redirect after starting configuration flow from user interface

Fixed in 2021.10.4

  • core: force lowercase emails for gravatar usage
  • outposts: fix MFA Challenges not working with outpost
  • outposts/ldap: fix logic error in cached ldap searcher
  • outposts/proxy: fix static files not being served in proxy mode
  • providers/proxy: return list of configured scope names so outpost requests custom scopes
  • root: use python slim-bullseye as base
  • sources/ldap: fix user/group sync overwriting attributes instead of merging them
  • sources/ldap: set connect/receive timeout (default to 15s)
  • stages/*: disable trim_whitespace on important fields
  • stages/authenticator_duo: fix devices created with name
  • stages/authenticator_validate: enable all device classes by default
  • web: write interfaces to different folders and remove custom chunk names
  • web/admin: fix display issues with flow execute buttons
  • web/admin: show warnings above tab bar
  • web/admin: use more natural default ordering for objects


This release does not introduce any new requirements.


Download the docker-compose file for 2021.10 from here. Afterwards, simply run docker-compose up -d.


Update your values to use the new images:

tag: 2021.10.1