Integration architecture

For FreeIPA deployments, FreeSCIM consumes directory state through a bounded trust path and exposes it through SCIM without pretending that Okta or the web tier owns Linux enforcement. The expected pattern is:

  1. Read LDAP/IPA attributes through direct LDAPS or a controlled FreeIPA agent path.
  2. Normalize identity fields to SCIM canonical types in a deterministic mapper.
  3. Emit user lifecycle events and group visibility with idempotency keys and correlation context.
  4. Persist audit events for every connector write and reconcile response.

Attribute contract and mapping risk

The most common integration failure is inconsistent attribute projection between directory schema and SCIM extension fields.

Linux validation surface

The strongest FreeIPA value is not only directory mapping; it is evidence that identity state reaches the Linux estate correctly.

Trust and hardening controls

Okta SAML + SCIM intent --(governed boundary)--> FreeSCIM --(LDAPS / agent)--> FreeIPA --(SSSD / Kerberos / HBAC)--> Linux
Treat connector authentication, TLS policy, and audit sink as mandatory controls before high-impact writes.

Operational caveat

Do not mirror FreeIPA administrative groups into FreeSCIM managed groups unless there is an explicit change control owner. FreeSCIM should not auto-enroll hosts, bypass HBAC, or push password policy changes without an approved operational gate.

Deployment and validation checklist

FreeIPA mapping edge checks