# Authentik

Costfluent meldet deine Leute über Authentik per OpenID Connect an. Du legst in Authentik einen OAuth2/OpenID-Provider mit einer Anwendung an, und Costfluent vertraut den Adressen der Domains, die du bestätigst.

## Bevor du beginnst

- Du brauchst in Costfluent die Organisationsrolle Eigentümer und Administratorzugriff auf Authentik.
- Dein Authentik-Server ist aus dem Internet per HTTPS erreichbar, damit Costfluent sein Discovery-Dokument und seine Schlüssel lesen kann.
- Die Adressen deiner Leute liegen in einer Domain, für die du einen DNS-TXT-Eintrag veröffentlichen kannst.

<PlanAvailability feature="Sso" plan="Core" />

## Anwendung registrieren

<Stepper>

1. Lege in der Admin-Oberfläche von Authentik einen OAuth2/OpenID-Provider mit dem Client-Typ vertraulich (confidential) an.
2. Füge den Weiterleitungs-URI `https://app.costfluent.com/api/auth/sso/callback` mit strikter Übereinstimmung hinzu.
3. Behalte die Scopes `openid`, `email` und `profile` und einen RS256- oder ES256-Signaturschlüssel.
4. Lege eine Anwendung mit einem Slug deiner Wahl an, die diesen Provider nutzt, und binde die Benutzer oder Gruppen, die sich anmelden sollen.
5. Kopiere die Client-ID und das Client-Secret aus dem Provider.

</Stepper>

Deine Discovery-URL ist `https://<authentik-host>/application/o/<slug>/.well-known/openid-configuration`, mit dem Slug der Anwendung.

## Gruppen senden

Die Standard-Zuordnung des Scopes `profile` in Authentik sendet bereits einen Claim `groups` mit den Namen der Gruppen des Benutzers; es ist nichts hinzuzufügen.

Die **Gruppe beim Identitätsanbieter**, die du in Costfluent zuordnest, ist der Gruppenname, wie Authentik ihn zeigt.

## In Costfluent verbinden

<Stepper>

1. Öffne **Einstellungen**, dann **Single Sign-on**, und verbinde deinen Anbieter mit der Discovery-URL, der Client-ID und dem Client-Secret.
2. Füge der Verbindung deine E-Mail-Domains hinzu und bestätige jede mit ihrem DNS-TXT-Eintrag.
3. Ordne die Gruppen Teams zu und aktiviere dann die Verbindung.

</Stepper>

[Anmeldung und Sicherheit](/de/admin/sign-in-security) beschreibt jeden dieser Schritte, das Erzwingen und die Notfall-Eigentümer.

## So verhält es sich

Costfluent liest diese Claims aus dem ID-Token und, wo das ID-Token einen auslässt, vom Userinfo-Endpunkt:

- `iss`, der dem Aussteller gleichen muss, den dein Discovery-Dokument beim Verbinden nannte, `https://<authentik-host>/application/o/<slug>/`.
- `sub` als die Identität, die Costfluent speichert.
- `email`, die in einer der bestätigten Domains der Verbindung liegen muss, was auch immer `email_verified` sagt. Eine Adresse außerhalb aller bestätigten Domains wird abgelehnt, ebenso eine Anmeldung ohne Adresse.
- `name`, für den Namen eines Kontos, das Costfluent anlegt.
- `groups` oder ein anderer Claim-Name, den du an der Verbindung einstellst.

Costfluent lehnt außerdem ein Token ab, dessen Signatur, Zielgruppe, Nonce oder Gültigkeit nicht stimmt, und ein Discovery-Dokument, das plötzlich einen anderen Aussteller nennt.

## Verwandte Seiten

- [Anmeldung und Sicherheit](/de/admin/sign-in-security)
- [Benutzer, Teams und Rollen](/de/admin/users-teams-and-roles)