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

Internal links

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

[netlify]

✅ Deploy Preview for authentik-storybook canceled.

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

[netlify]

✅ Deploy Preview for authentik-docs canceled.

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

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.67%. Comparing base (e4b6df3) to head (2dd7a8e).

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #12716      +/-   ##
==========================================
- Coverage   92.72%   92.67%   -0.06%     
==========================================
  Files         770      770              
  Lines       38945    38945              
==========================================
- Hits        36112    36091      -21     
- Misses       2833     2854      +21     

Flag	Coverage Δ
e2e	48.46% <ø> (-0.09%)	⬇️
integration	24.59% <ø> (ø)
unit	90.37% <ø> (+<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.

[dominic-r]

TODO: Needs clarification of where it can be found and how it's configured

[dominic-r]

TODO: Where is that no_permissions profile, what is it, how? IDK

[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

[dominic-r]

Hi @kensternberg-authentik , would it be possible to take a look at this react component I added + It's implementation when you have a second? Thanks in advance! The default codeblock in markdown ``` has some sort of copy button, I could mabye try piggy-backing on that?