@x12i/xentra-identity

Identity provider adapter interface for Xentra. Syncs organizations, users, groups, and roles to an external IdP and verifies external tokens.

Install

npm install @x12i/xentra-identity

Usage

Implement XentraIdentityProviderAdapter for your IdP, or use a bundled adapter:

import type { XentraIdentityProviderAdapter, CreateUserInput } from "@x12i/xentra-identity";
import { NotImplementedIdentityAdapter } from "@x12i/xentra-identity";

// Stub for tests — all methods throw
const stub = new NotImplementedIdentityAdapter();

Adapter contract

| Area | Methods | |------|---------| | Organizations | createOrganization, updateOrganization, disableOrganization | | Users | createUser, updateUser, disableUser | | Groups | createGroup, updateGroup, deleteGroup | | Membership | addUserToOrganization, removeUserFromOrganization, addUserToGroup, removeUserFromGroup | | Roles | assignRole, removeRole | | Auth | verifyExternalToken → VerifiedExternalIdentity |

Input/output types (CreateOrganizationInput, VerifiedExternalIdentity, etc.) are exported from this package.

Related packages

• @x12i/xentra-identity-keycloak — Keycloak implementation
• @x12i/xentra-types — IdentityProviderRef on accounts and users

Development

npm run build -w @x12i/xentra-identity
npm test -w @x12i/xentra-identity

License

MIT