website/docs: add source property mappings, rework provider property mappings

[rissson]

Details

Docs for #8771 and #10650 and #10772

Needs #10810

---

If applicable

• The documentation has been updated
• The documentation has been formatted (make website)

[netlify]

✅ Deploy Preview for authentik-docs ready!

Name	Link
🔨 Latest commit	be3ffeb
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-docs/deploys/66b3c7072f090a000855dd42
😎 Deploy Preview	https://deploy-preview-10652--authentik-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[netlify]

✅ Deploy Preview for authentik-storybook canceled.

Name	Link
🔨 Latest commit	be3ffeb
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-storybook/deploys/66b3c707b99eb800082765a8

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 50.75%. Comparing base (9343e34) to head (be3ffeb).

❗ There is a different number of reports uploaded between BASE (9343e34) and HEAD (be3ffeb). Click for more details.

HEAD has 2 uploads less than BASE

Flag	BASE (9343e34)	HEAD (be3ffeb)
unit	2	0

Additional details and impacted files

@@             Coverage Diff             @@
##             main   #10652       +/-   ##
===========================================
- Coverage   92.62%   50.75%   -41.88%     
===========================================
  Files         734      732        -2     
  Lines       36039    35776      -263     
===========================================
- Hits        33381    18157    -15224     
- Misses       2658    17619    +14961     

Flag	Coverage Δ
e2e	49.41% <ø> (ø)
integration	25.18% <ø> (ø)
unit	?

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[github-actions]

authentik PR Installation instructions

Instructions for docker-compose

Add the following block to your .env file:

AUTHENTIK_IMAGE=ghcr.io/goauthentik/dev-server
AUTHENTIK_TAG=gh-be3ffeb7e5d2e3825048a20c5fafba3bccd7f2b7
AUTHENTIK_OUTPOSTS__CONTAINER_IMAGE_BASE=ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s

For arm64, use these values:

AUTHENTIK_IMAGE=ghcr.io/goauthentik/dev-server
AUTHENTIK_TAG=gh-be3ffeb7e5d2e3825048a20c5fafba3bccd7f2b7-arm64
AUTHENTIK_OUTPOSTS__CONTAINER_IMAGE_BASE=ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s

Afterwards, run the upgrade commands from the latest release notes.

Instructions for Kubernetes

Add the following block to your values.yml file:

authentik:
    outposts:
        container_image_base: ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s
global:
    image:
        repository: ghcr.io/goauthentik/dev-server
        tag: gh-be3ffeb7e5d2e3825048a20c5fafba3bccd7f2b7

For arm64, use these values:

authentik:
    outposts:
        container_image_base: ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s
global:
    image:
        repository: ghcr.io/goauthentik/dev-server
        tag: gh-be3ffeb7e5d2e3825048a20c5fafba3bccd7f2b7-arm64

Afterwards, run the upgrade commands from the latest release notes.

[tanberry]

Awesome docs! Thanks so much @rissson for doing all of these. It's a lot and it looks like you found every file that needed to be created or updated! I'm really grateful that you did these docs, not me, haha.

Sorry for the gazillion tiny edits about capitalization... our Style Guide is only recently mature enough to cover most things.

The two biggest take-aways are:

• Now that we have two types of property mappings (those we use with providers and those we use with sources) and expression-based mappings for both providers and sources, we just need to make sure that the titles are very very explicit.
• The original property mappings page should just be deleted. It only serves as a navigation aid now, and that benefit is outweighed by the disadvantage of having three topics about property mappings. ;-)

[rissson]

Ugh, a bunch of anchors are now broken due to the subtitle changes

[rissson]

Sorry for the gazillion tiny edits about capitalization... our Style Guide is only recently mature enough to cover most things.

No worries :D

The original property mappings page should just be deleted. It only serves as a navigation aid now, and that benefit is outweighed by the disadvantage of having three topics about property mappings.

Agreed. I didn't know what you wanted to do with it, so I left it as a stub to make it easier to find from the navigation bar (as it's also an item in the navigation bar in the product), but we can remove it.

[kensternberg-authentik]

Still that TODO, and I found one typo.

[tanberry]

Awesome docs, thanks so much!