> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration Patterns

Lumos integration patterns for SaaS, on-premise, legacy, and custom systems.

# Introduction

Lumos integrates with SaaS applications, on-premise systems, legacy tools, and custom-built solutions. This guide describes each integration pattern so you can choose how to connect your systems to Lumos.

## Why Lumos?

* **Universal reach**: Connect to any system—cloud, hybrid, on-premise or custom.
* **Flexibility**: Supports standardized protocols, pre-built connectors, and custom integrations.
* **Scalability**: Handles high data volumes and complex architectures.
* **Security-first**: Applies security practices across all integrations.

This guide is for identity architects and administrators. It outlines each integration pattern, its capabilities, and example uses so you can design a solution that fits your requirements.

***

## Integration patterns overview

Lumos offers integration patterns for specific identity governance scenarios. The following table summarizes the available options.

| **Integration Strategy** | **Best Use Cases** | **Capabilities** | **Benefits** | **Considerations** |
| - | - | - | - | - |
| **[SaaS Integration](https://docs.lumos.com/docs/saas-integrations.md)** | Cloud-based applications like AWS, Office 365, GitHub, Salesforce | Full Lifecycle Management (R/W) | Pre-built connectors, real-time sync, minimal setup | Connectors require periodic updates |
| **[SCIM](https://docs.lumos.com/docs/scim-1.md)** | SCIM 2.0-supported applications | Full Lifecycle Management (R/W) | Standards-compliant, reduces custom development effort | Limited to SCIM-compatible systems |
| **[Directory Integration](https://docs.lumos.com/docs/directory-integration.md)** | Active Directory, LDAP | Full Lifecycle Management (R/W) | Real-time synchronization, hybrid identity support | Requires Lumos Agent deployment |
| **[Database Integration (JDBC)](https://docs.lumos.com/docs/database-integration-jdbc.md)** | JDBC-compatible databases | Full Lifecycle Management (R/W) | Direct SQL access, supports structured queries | Requires secure database credentials |
| **[Custom Connector SDK](https://docs.lumos.com/docs/custom-connector-sdk.md)** | Unique or proprietary systems | Full Lifecycle Management (R/W) | High flexibility, ideal for custom and legacy systems | Development expertise required |
| **[Flat File (CSV)](https://docs.lumos.com/docs/csv-import.md)** | Legacy systems, bulk updates | Ingestion (R) | Simple and cost-effective for non-API systems | Focused on ingestion |
| **[REST API](https://docs.lumos.com/docs/rest-api-1.md)** | Custom pipelines and integrations | Ingestion (R) | Supports programmatic uploads and automated workflows | Requires development of API integration |
| **[Webhooks](https://docs.lumos.com/integrations/webhooks-itsm-and-manual-tasks/webhooks.md)** | Event-driven workflows | Lifecycle Management (W) | Automates provisioning, integrates with custom workflows | Requires secure webhook implementation |
| **[Manual Tasks](https://docs.lumos.com/integrations/webhooks-itsm-and-manual-tasks/manual-tasks.md)** | Systems needing human intervention | Lifecycle Management (W) | Centralized task tracking, integrates approvals | Suitable for human-in-the-loop processes |
| **[ITSM Integration](https://docs.lumos.com/integrations/webhooks-itsm-and-manual-tasks/itsm-integration.md)** | ITSM-driven workflows (e.g., ServiceNow, Jira) | Lifecycle Management (W) | Automated ticketing, status updates, compliance alignment | Requires ITSM tool setup |

## Conclusion

Lumos integration patterns include automated SaaS connectors, standards-based SCIM endpoints, database integrations, manual tasks, and more. Choose the patterns that match your organization’s technical environment, compliance needs, and business objectives to manage user identities and their entitlements across your environment.
