Preview of the SSO Provider Table component
Setup Requirements
Auth0 Configuration Required - Ensure your tenant is configured with the
My Organization API. View setup guide
→
Installation
Running the shadcn command also installs the @auth0/universal-components-core
dependency for shared utilities and Auth0 integration.
Quick Start
Full integration example
Full integration example
While this example uses a React SPA, the prop configurations (schema, customMessages, styling, etc.) apply equally to Next.js and shadcn setups.
Props
Core Props
Core props are fundamental to the component’s operation.SsoProviderTable requires both navigation actions to handle the typical provider management workflow.
createAction
Type:ComponentAction<void>
The createAction prop is required because it controls where to navigate when users click “Add Provider”. Without this, the table wouldn’t know how to initiate the provider creation flow.
Properties:
disabled- Disable the “Add Provider” buttononBefore()- Called before navigation. Returnfalseto cancel. Use for permission checks.onAfter()- Called to perform navigation. This is where you navigate to your create page.
editAction
Type:ComponentAction<IdentityProvider>
The editAction prop is required because it controls where to navigate when users click on a provider row. The callback receives the provider data so you can navigate to the correct edit page.
Properties:
disabled- Disable row click navigationonBefore(provider)- Called before navigation. Returnfalseto cancel.onAfter(provider)- Called to perform navigation with the selected provider.
Display Props
Display props control how the component renders without affecting its behavior. Use these to hide sections or enable read-only mode.| Prop | Type | Description |
|---|---|---|
readOnly | boolean | Disable all table actions. Default: false |
hideHeader | boolean | Hide the header section. Default: false |
Action Props
Action props handle user interactions beyond the core navigation. These control deletion, removal, and enable/disable operations.deleteAction
Type:ComponentAction<IdentityProvider>
Controls permanent deletion of an SSO provider. This is destructive - the provider is deleted from your Auth0 tenant entirely.
Properties:
disabled- Disable the delete optiononBefore(provider)- Called before deletion. Returnfalseto cancel. Recommended for confirmation.onAfter(provider)- Called after successful deletion.
deleteFromOrganizationAction
Type:ComponentAction<IdentityProvider>
Controls removing a provider from the organization without deleting it from the tenant. The provider remains available to be re-added later.
Properties:
disabled- Disable the remove optiononBefore(provider)- Called before removal. Returnfalseto cancel.onAfter(provider)- Called after successful removal.
enableProviderAction
Type:ComponentAction<IdentityProvider>
Controls the enable/disable toggle for providers. Disabled providers remain configured but users cannot authenticate through them.
Properties:
disabled- Disable the toggleonBefore(provider)- Called before toggle. Returnfalseto cancel.onAfter(provider)- Called after toggle completes.
Customization Props
Customization props let you adapt the component to your brand, locale, and validation requirements without modifying source code.schema
Set custom validation rules for confirmation dialogs (e.g., type provider name to confirm deletion).Available Schema Fields
Available Schema Fields
All schema fields support:
regex, errorMessagedelete.providerName - Confirmation for permanent deletion
remove.providerName - Confirmation for removal from organizationcustomMessages
Customize all text and translations. All fields are optional and use defaults if not provided.Available Messages
Available Messages
header - Component header
title,description,create_button_text
empty_messagecolumns.name,columns.strategy,columns.statusactions.edit_button_text,actions.delete_button_text,actions.remove_button_text
title,descriptionfield.label,field.placeholder,field.erroractions.cancel_button_text,actions.delete_button_text
title,descriptionactions.cancel_button_text,actions.remove_button_text
provider_delete_success,provider_delete_errorprovider_remove_success,provider_enable_success,provider_disable_success
styling
Customize appearance with CSS variables and class overrides. Supports theme-aware styling.Available Styling Options
Available Styling Options
Variables - CSS custom properties
common- Applied to all themeslight- Light theme onlydark- Dark theme only
SsoProviderTable-headerSsoProviderTable-tableSsoProviderTable-rowSsoProviderTable-deleteModalSsoProviderTable-removeModal
Advanced Customization
TheSsoProviderTable component is composed of smaller subcomponents and hooks. You can import them individually to build custom provider management workflows if you use shadcn.
Available Subcomponents
For advanced use cases, you can import individual subcomponents to build custom provider management interfaces. This is useful when you need to embed the table in a different layout or customize row rendering.| Component | Description |
|---|---|
ProviderRow | Individual provider row with actions |
ProviderDeleteModal | Confirmation modal for permanent deletion |
ProviderRemoveModal | Confirmation modal for organization removal |
ProviderStatusToggle | Enable/disable toggle component |
ProviderStrategyIcon | Strategy icon renderer (Okta, SAML, etc.) |
Available Hooks
These hooks provide the underlying logic without any UI. Use them to build completely custom interfaces while leveraging the Auth0 API integration.| Hook | Description |
|---|---|
useSsoProviderTable | Provider list fetching and management |
useSsoProviderTableLogic | UI interaction state + handlers (modals, actions) |