PHPackages                             ometra/caronte-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. ometra/caronte-sdk

ActiveLibrary

ometra/caronte-sdk
==================

Caronte SDK

4.4.0(2w ago)0357↓16.7%2MITPHPPHP ^8.2

Since Feb 4Pushed 1w agoCompare

[ Source](https://github.com/Ometra-Nyx/mx.ometra.caronte-sdk)[ Packagist](https://packagist.org/packages/ometra/caronte-sdk)[ RSS](/packages/ometra-caronte-sdk/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (10)Dependencies (10)Versions (22)Used By (2)

README (Root of the Project)
============================

[](#readme-root-of-the-project)

This documentation follows the project's Coding Standards and PHPDoc Style Guide.

Project Overview
----------------

[](#project-overview)

ometra/caronte-sdk is a Laravel package that integrates a host Laravel application with a centralized Caronte authentication server.

Main capabilities:

- User authentication via Caronte (login, logout, 2FA, password recovery)
- User token validation and renewal middleware
- Management UI for users and role synchronization
- Suite access management for application groups with non-root role synchronization
- Application-to-application authentication middleware
- Protected API access token validation and scope checks
- Tenant-aware behavior for single-tenant and multi-tenant modes

Primary audience: internal development teams integrating Caronte into Laravel applications.

Project Type &amp; Tech Summary
-------------------------------

[](#project-type--tech-summary)

- Project type: Laravel package (library), not a standalone app
- PHP version: ^8.2
- Laravel version: ^12.0
- JWT stack: lcobucci/jwt ^5.3 and lcobucci/clock ^3.2
- HTTP integration: Laravel HTTP client via package support classes
- Database: uses host app database connection; publishes package migrations for local user cache tables
- Cache: host app cache (OIDC JWKS cache uses Laravel Cache)
- Queue: no package-owned queue workers required
- External services: Caronte server HTTP API, optional OIDC issuer endpoints

Quick Start (High-Level)
------------------------

[](#quick-start-high-level)

1. Install package dependencies in your host app with composer.
2. Publish package configuration and migrations.
3. Set required environment variables for CARONTE\_URL, CARONTE\_APP\_CN, and CARONTE\_APP\_SECRET.
4. Run migrations in the host application.
5. Add package middleware to protected host routes.
6. Synchronize configured roles and protected API scopes.
7. Verify authentication and management routes in a local environment.

Full steps: see doc/deployment-instructions.md.

Suite Access
------------

[](#suite-access)

Applications that belong to a Caronte `ApplicationGroup` can use the SDK to manage tenant user access across the suite after the server grants these Caronte platform permissions to the application:

- `groups.roles.read`
- `groups.users.read`
- `groups.user_roles.write`

The SDK exposes `Ometra\Caronte\Api\GroupApi` with:

- `showGroupRoles()`
- `showGroupUsers(string $search = '')`
- `syncGroupUserRoles(string $uriUser, string $appId, array $roleUris, ?string $actorToken = null)`

The management UI includes a "Suite access" mode that lists tenant users, groups roles by application, and prevents selecting roles marked as non-manageable such as `root`.

Documentation Index
-------------------

[](#documentation-index)

- [Deployment Instructions](doc/deployment-instructions.md)
- [API Documentation](doc/api-documentation.md)
- [Routes Documentation](doc/routes-documentation.md)
- [Artisan Commands](doc/artisan-commands.md)
- [Tests Documentation](doc/tests-documentation.md)
- [Middleware Documentation](doc/middleware.md)
- [Architecture Diagrams](doc/architecture-diagrams.md)
- [Monitoring](doc/monitoring.md)
- [Business Logic &amp; Core Processes](doc/business-logic-and-core-processes.md)
- [Open Questions &amp; Assumptions](doc/open-questions-and-assumptions.md)

Standards Note
--------------

[](#standards-note)

Examples and references in these docs follow the project instructions for coding conventions and PHPDoc style, using the package namespace and folder structure as the source of truth.

###  Health Score

49

—

FairBetter than 94% of packages

Maintenance98

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 67.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~5 days

Total

20

Last Release

16d ago

Major Versions

1.6.0 → 2.0.02026-04-13

2.1.0 → 3.0.02026-04-28

3.6.0 → 4.0.02026-05-14

PHP version history (2 changes)1.3.4PHP ^8.0

2.1.0PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/984800?v=4)[gruelas](/maintainers/gruelas)[@gruelas](https://github.com/gruelas)

---

Top Contributors

[![gruelasjr](https://avatars.githubusercontent.com/u/40619710?v=4)](https://github.com/gruelasjr "gruelasjr (82 commits)")[![omaar-es](https://avatars.githubusercontent.com/u/155184712?v=4)](https://github.com/omaar-es "omaar-es (35 commits)")[![vicario00](https://avatars.githubusercontent.com/u/101902535?v=4)](https://github.com/vicario00 "vicario00 (4 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ometra-caronte-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/ometra-caronte-sdk/health.svg)](https://phpackages.com/packages/ometra-caronte-sdk)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.5M901](/packages/statamic-cms)[laravel/octane

Supercharge your Laravel application's performance.

4.0k24.7M203](/packages/laravel-octane)[code16/sharp

Laravel Content Management Framework

78762.6k7](/packages/code16-sharp)[laravel/ai

The official AI SDK for Laravel.

9782.1M153](/packages/laravel-ai)[rapidez/core

Rapidez Core

1822.4k65](/packages/rapidez-core)[typicms/base

A modular multilingual CMS built with Laravel, enabling developers to manage structured content like pages, news, events, and more.

1.6k20.4k](/packages/typicms-base)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
