Skip to content

Commit 7acab2e

Browse files
committed
website/docs: Flesh out integrations copy changes.
1 parent ce23209 commit 7acab2e

File tree

2 files changed

+18
-33
lines changed

2 files changed

+18
-33
lines changed

website/integrations/index.mdx

+16-6
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,25 @@
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
11+
### Applications
1012

11-
## Sources
13+
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
1214

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.
15+
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).
1416

15-
To learn more, refer to the [Sources](https://docs.goauthentik.io/docs/users-sources/sources/index) documentation.
17+
To learn more, refer to the [Applications](../integrations/services/index.mdx) page.
18+
19+
### Federated and social sources
20+
21+
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)
22+
23+
Sources in authentik can also be used for social logins, using external providers such as Facebook, Twitter, etc.
24+
25+
To learn more, refer to the [Sources](https://docs.goauthentik.io/docs/users-sources/sources/index) page.

website/integrations/services/index.mdx

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

6-
# Applications
7-
86
import DocCardList from "@theme/DocCardList";
9-
import SupportBadge from "@site/src/components/SupportBadge";
10-
11-
Below is a list of all applications that are known to work with authentik.
12-
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-
```
327

33-
Don't forget to edit the `sidebarsIntegrations.js` file to add your new integration to the lefthand navigation bar.
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.
349

35-
## Integration categories
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]).
3611

3712
<DocCardList />

0 commit comments

Comments
 (0)