website/integrations: all general cleanup and updates

[dominic-r]

sdko/integration-batch-updates/a

What?

This is part A of the series of PRs to update all integration documentation and remove outdated elements.

Updating all integrations to use the new format for the "authentik configuration" section is a giant part of this. Most integrations use the old application/provider format, this needs to be updated to prepare for the 2025.2 release. Furthermore, some integrations were updated to include the "short" app/provider config. The long config is preferred to retain more information/make docs clearer.

Then, there's general cleanup here and there and matching the style guide.

Notable changes

Addition of IntegrationsMultilineCodeblock

Adds a IntegrationsMultilineCodeblock React component to easily render codeblocks containing <em> tags for example. It is more reusable than using <pre>s and <code>s everywhere. One drawback: All affected files will need to be renamed from .md to .mdx for the component to load correctly. Since @GirlBossRush and I are modifying integration documentation, this is going to be fun for one of us (Probably me) as the majority of the files will need to be renamed.

Needs styling fixes... badly

Usage

import IntegrationsMultilineCodeblock from "@site/src/components/Integrations/IntegrationsCodeblock"

<IntegrationsMultilineCodeblock>
{`
What has to be said
`}
</IntegrationsMultilineCodeblock>

Addition to style guide

• Usage for multiline codeblocks
• If need to specify env variable ex: ${OIDC_CLIENT_SECRET}, add $\{OIDC_CLIENT_SECRET} to not add build error.

OIDC configuration for Bookstack

Added configuration to log into Bookstack w/ OIDC instead of just SAML.

Rewriting the AWS integration documentation

This PR introduces a complete rewrite of the AWS documentation including a long awaited and needed restructuring.

Move React component imports to top of file

Moves all imports to react components / tab stuff to the top of the file to make it clearer and follow best-practices

Adding references

At least one reference has been added to each integration documentation page. It would be fun/ideal to require this for future documentation...!

Actual budget configure with env variables/json

You can also configure actual budget w/ env vars or the json file instead of playing around in the ui... interesting

A lot of cleanup

Yea

Internal links

• Ticket
• Tana, please check this after review
• Integrations included in PR

[netlify]

✅ Deploy Preview for authentik-storybook canceled.

Name	Link
🔨 Latest commit	d50846c
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-storybook/deploys/67b00bcf87b85700080b85ca

[netlify]

❌ Deploy Preview for authentik-docs failed. Why did it fail? →

Name	Link
🔨 Latest commit	d50846c
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-docs/deploys/67b00bcf87b85700080b85cc

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.75%. Comparing base (de20897) to head (d50846c).

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #12716      +/-   ##
==========================================
+ Coverage   92.69%   92.75%   +0.06%     
==========================================
  Files         785      785              
  Lines       39623    39623              
==========================================
+ Hits        36728    36753      +25     
+ Misses       2895     2870      -25     

Flag	Coverage Δ
e2e	48.48% <ø> (+0.08%)	⬆️
integration	24.54% <ø> (ø)
unit	90.43% <ø> (+<0.01%)	⬆️

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.

[tanberry]

Thank you @4d62 !

[dominic-r]

@tanberry I don't think this is ready for merge yet. I'll finish, if you don't mind, all of the section outlined in notion before merging. Just to not make too many of these

[kensternberg-authentik]

I had one request for change; I'm quite serious about not writing your own security code.

[dominic-r]

Ken, thanks for the review. Here's an updated version which should fix what was addressed here and on Slack. My dompurify implementation feels botched tho I have absolutely no idea how to make this JSDOM thing work and SSR and whatever else on Netlify. I've passed through the 7 stages of grief with coding