Skip to content

Commit 9f716d8

Browse files
committed
website/docs: Flesh out integrations copy changes.
1 parent 50e2f1c commit 9f716d8

File tree

2 files changed

+23
-33
lines changed

2 files changed

+23
-33
lines changed

website/integrations/index.mdx

+19-6
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,28 @@
11
---
22
title: Integrations overview
3+
sidebar_label: Overview
34
---
45

5-
There are two main types of integrations with authentik: **Applications** and **Sources**.
6+
## What is an integration?
67

7-
## Applications
8+
An integration is a how authentik connects to third-party applications, directories, and other identity providers.
9+
Integrations are categorized into two categories: **Applications** and **Sources**.
810

9-
authentik integrates with many applications. For a full list, and to learn more about adding documentation for a new application, refer to the [Applications](../integrations/services/index.mdx) documentation
1011

11-
## Sources
12+
### Applications
1213

13-
In addition to applications, authentik also integrates with external sources, including federated directories like Active Directory and through protocols such as LDAP, OAuth, SAML, and SCIM sources. Sources are a way for authentik to use external credentials for authentication and verification. Sources in authentik can also be used for social logins, using external providers such as Facebook, Twitter, etc.
14+
Applications include vendor tools such as Google Workspace, GitHub, Slack, or AWS. These applications can be integrated with authentik to provide single sign-on capabilities to
1415

15-
To learn more, refer to the [Sources](https://docs.goauthentik.io/docs/users-sources/sources/index) documentation.
16+
If you're looking to integrate an application that isn't listed, authentik can be configured to work with most applications that support authentication protocols such as [SAML](../docs/add-secure-apps/providers/saml/index.md), [OAuth and OpenID Connect](../docs/add-secure-apps/providers/oauth2/index.mdx).
17+
18+
To learn more, refer to the [Applications](../integrations/services/index.mdx) page.
19+
20+
21+
### Federated and social sources
22+
23+
Sources are a way for authentik to use external credentials for authentication, authentik also integrates with external sources, including federated directories like Active Directory and through protocols such as [LDAP](../docs/users-sources/sources/protocols/ldap/index.md), [SCIM](../docs/users-sources/sources/protocols/scim/index.md), [SAML](../docs/users-sources/sources/protocols/saml/index.md), and [OAuth and OpenID Connect](../docs/users-sources/sources/protocols/oauth/index.mdx)
24+
25+
26+
Sources in authentik can also be used for social logins, using external providers such as Facebook, Twitter, etc.
27+
28+
To learn more, refer to the [Sources](https://docs.goauthentik.io/docs/users-sources/sources/index) page.

website/integrations/services/index.mdx

+4-27
Original file line numberDiff line numberDiff line change
@@ -3,35 +3,12 @@ title: Integrate with Applications
33
sidebar_label: Applications
44
---
55

6-
# Applications
6+
import DocCardList from "@theme/DocCardList"
77

8-
import DocCardList from "@theme/DocCardList";
9-
import SupportBadge from "@site/src/components/SupportBadge";
8+
Most third-party services which support authentication protocols such as SAML, OAuth, and OpenID Connect can be integrated with authentik, allowing users to log in to these services using their authentik credentials.
109

11-
Below is a list of all applications that are known to work with authentik.
10+
If you don't see an application you're looking for, you can reach us on [GitHub](https://github.com/goauthentik/authentik), [Discord](https://discord.com/channels/809154715984199690/809154716507963434), or via email to [[email protected]](mailto:[email protected]).
1211

13-
:::info{title="Support Levels"}
14-
All app integrations will have one of these badges:
15-
16-
| | |
17-
| ----------------------------------- | ---------------------------------------------------------- |
18-
| <SupportBadge level="community" /> | The integration is community maintained. |
19-
| <SupportBadge level="vendor" /> | The integration is supported by the vendor. |
20-
| <SupportBadge level="authentik" /> | The integration is regularly tested by the authentik team. |
21-
| <SupportBadge level="deprecated" /> | The integration is deprecated and may be removed. |
22-
23-
:::
24-
25-
### Add a new application
26-
27-
To add documentation for a new application (with support level Community or Vendor), please use the integration template [`service.md`](https://github.com/goauthentik/authentik/blob/main/website/integrations/template/service.md) file from our GitHub repo. You can download the template file using the following command:
28-
29-
```shell
30-
wget https://raw.githubusercontent.com/goauthentik/authentik/main/website/integrations/template/service.md
31-
```
32-
33-
Don't forget to edit the `sidebarsIntegrations.js` file to add your new integration to the lefthand navigation bar.
34-
35-
## Integration categories
3612

3713
<DocCardList />
14+

0 commit comments

Comments
 (0)