SDK y librerías

Auris proporciona librerías cliente oficiales para todas las plataformas y frameworks principales. Cada SDK envuelve el mismo flujo OAuth2 PKCE y la misma API REST subyacentes, con conveniencias específicas del framework añadidas encima.

Comparativa de SDK

La tabla a continuación resume qué capacidades están disponibles en cada paquete.

Característica	@auris/js	@auris/react	@auris/nextjs	auris/sdk (PHP)	auris-sso (WP)	@auris/cli
Autenticación	Sí	Sí	Sí	Sí	Sí	N/D
OAuth2 PKCE	Sí	Sí	Sí	Sí	Sí	N/D
Social Login	Sí	Sí	Sí	No	No	N/D
Magic Links	Sí	Sí	Sí	No	No	N/D
SMS OTP	Sí	Sí	Sí	No	No	N/D
Comprobación de permisos	Sí	Sí (hooks)	Sí (servidor)	No	No	No
Autorización de grano fino	Sí	Sí (hooks)	Sí (servidor)	No	No	No
API de gestión	Sí	No	Sí (servidor)	No	No	Sí
Verificación de webhooks	Sí	No	No	No	No	No
Verificación JWT	Sí	No	Sí (servidor)	No	No	No
Soporte SSR	Sí	No	Sí	Sí	N/D	N/D
Edge runtime	Sí	No	Sí (middleware)	No	N/D	N/D
Sin dependencias	Sí	No	No	Sí	No	No

¿Qué SDK elegir?

Usa este árbol de decisión para seleccionar el paquete adecuado para tu proyecto.

¿Construyendo una Single Page Application en el navegador (React, Vue, JS puro)? Usa @auris/js para código agnóstico de framework, o @auris/react para hooks y componentes específicos de React.

¿Construyendo una aplicación Next.js? Usa @auris/nextjs. Re-exporta @auris/react para Client Components y añade helpers del lado del servidor para Server Components, Route Handlers y Edge Middleware.

¿Construyendo una aplicación PHP o Laravel? Usa el paquete Composer auris/sdk. Es PHP puro sin dependencias externas y soporta PHP 7.4 en adelante.

¿Ejecutando un sitio WordPress? Usa el plugin de WordPress auris-sso. Gestiona el login SSO, el provisioning de usuarios just-in-time y el mapeo de roles a través de la UI de administración de WordPress.

¿Escribiendo scripts, pipelines CI/CD o automatizando la gestión de tenants? Usa @auris/cli. Instálalo globalmente y autentícate una vez — luego usa auris users list, auris logs y otros comandos en tus scripts.

¿Llamadas API servidor a servidor (sin usuario involucrado)? Usa @auris/js con el método getM2MToken(), o createManagementClient() en @auris/nextjs/server. Ambos usan el grant OAuth2 client_credentials.

Instalación


# JavaScript (navegador, Node.js, edge runtimes)
npm install @auris/js
 
# React
npm install @auris/react @auris/js
 
# Next.js (incluye los paquetes React y JS)
npm install @auris/nextjs @auris/react @auris/js
 
# PHP
composer require auris/sdk
 
# CLI (instalación global)
npm install -g @auris/cli

El plugin de WordPress se distribuye como un fichero .zip. Instálalo a través de Plugins → Añadir nuevo → Subir plugin en el administrador de WordPress.