Meine verknüpften Identitäten auflisten

GET /fapi/v1/me/identities · wird vom Anmelde-Host der Umgebung aufgerufen

Listet die mit dem Konto des authentifizierten Benutzers verknüpften Identitäten auf (Passwort, Social, SAML, OIDC, Legacy), die älteste zuerst. Die externe Kennung (OIDC-sub, SAML-NameID), die E-Mail-Adresse des Identitätsanbieters und Verweise auf Zugangsdaten werden niemals zurückgegeben. Passkeys und Einmalcode-Methoden sind Authentifizierungsmittel und werden unter GET /fapi/v1/me/authenticators aufgelistet. Zum Lesen ist keine kürzlich bestätigte Sitzung erforderlich. Erforderlich ist der Cookie __Host-idp_session des authentifizierten Benutzers; fehlt der Cookie, ist er abgelaufen oder widerrufen, wird 401 unauthenticated zurückgegeben. Eine First-Party-Anwendung auf einem anderen Ursprung kann stattdessen ihr Front-API-Zugriffstoken senden (Authorization: DPoP <token> mit einem DPoP-Nachweis; siehe Front-API-Zugriffstoken).

Anfrage

Header:

Header Erforderlich Beschreibung
Idp-Client ja SDK-Kennung.

Kein Body.

Antwort

200 OK mit {"data": [...]}.

Jedes Element: id (idn_…), type (password, social, saml, oidc, legacy), connection_id (conn_…; null bei password), provider (Code des Social-Providers, etwa google; null bei anderen Typen), linked_via (wie die Identität verknüpft wurde: primary, auto_verified_email, user_confirmed, admin_api, import, jit, auto_domain, invite_proof, manual_link, scim_match), created_at.

Verwenden Sie die id mit DELETE /fapi/v1/me/identities/{identity_id}, um eine Identität zu entfernen.

Fehler

Status Code Wann
401 unauthenticated Kein gültiger Sitzungs-Cookie.

Beispiel

curl https://example.keenauth.app/fapi/v1/me/identities \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt
{
  "data": [
    {
      "id": "idn_01j9zzzzzzzzzzzzzzzzzzzzzz",
      "type": "social",
      "connection_id": "conn_01j9yyyyyyyyyyyyyyyyyyyyyy",
      "provider": "google",
      "linked_via": "manual_link",
      "created_at": "2026-10-01T09:00:00Z"
    }
  ]
}

Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: verknüpfte Identitäten. Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie keine besonderen Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung) in einem Feld.