Integración de aplicaciones externas
Servicios web
RSJ LPSNG proporciona los siguientes servicios web:
- Enviar trabajo de impresión
Enviar trabajo de impression
| Parámetro | Valor |
| URL | /submit |
| Method | POST |
| Content-Type | multipart/form-data |
| title | Descripción del trabajo para mostrar |
| format | Id de diseño |
| data | Datos (en CSV, JSON, XML or Excel) |
| callback | opcional JSONP callback |
| oauth_token | token de acceso OAuth2 (si no se especifica en el encabezado HTTP de autorización en el esquema OAuth) |
Autenticación
RSJ LPSNG utiliza el protocolo estándar OAuth2 para integrar de forma segura múltiples aplicaciones externas independientes para una multitud de usuarios.
RSJ LPSNG utiliza esta autenticación como base para sus decisiones de enrutamiento.
Registro de aplicación externa
Los desarrolladores pueden registrar una aplicación externa con RSJ LPS NG en línea al proporcionar:
- Nombre de la aplicación
- Descripción de la aplicación
- Icono de aplicación
- URL de redireccionamiento de la aplicación
Recibirán:
- Identificador de aplicación
- Secreto de la aplicación
Autorización de aplicación externa
Los usuarios finales pueden autorizar en línea las aplicaciones externas para usar RSJ LPS NG en su nombre.
Vista de usuario final
- El usuario hace clic en un enlace en la aplicación externa, que los redirige al inicio de sesión RSJ LPSNG (si aún no lo ha hecho) y luego a la pantalla de autorización RSJ LPS NG
- Si el usuario acepta el enlace de la aplicación, se redirige de nuevo a la aplicación externa donde se almacena la información de autenticación.
Vista de aplicación externa
La aplicación externa proporciona la siguiente información con la redirección:
- Identificación de la aplicación (asignada durante el registro de la solicitud)
- URL de devolución de llamada (especificada durante el registro de la aplicación)
- Información de contexto opcional (para devolución de llamada)
| Parámetro | Valor |
| URL | /authorize |
| Method | GET |
| client_id | Identificación del cliente (desde el registro de la aplicación) |
| response_type | code |
| scope | full |
| redir_uri | Redirigir URI (debe coincidir con URI en el registro de la aplicación) |
| state | Información de contexto opcional para devolución de llamada |
Después de la autorización exitosa, la sesión del usuario final se redirige a la aplicación externa con los siguientes parámetros:
- Información de contexto (de redirección)
- Código de autorización temporal (válido por 10 minutos)
La aplicación externa llama a un servicio web para intercambiar la autorización temporal con el token de actualización permanente al proporcionar:
- Código de autorización temporal.
- Identificador de aplicación
- Secreto de la aplicación
- URL de devolución de llamada
La aplicación externa almacena permanentemente el token de actualización para el usuario final.
| Parámetro | Valor |
| URL | /auth |
| Method | POST |
| grant_type | refresh_token |
| refresh_token | Actualizar token (a partir de la autorización de la aplicación) |
| Devoluciones | Estructura JSON |
Solicitudes de Solicitud Externas
La aplicación externa debe intercambiar el token de actualización por un token de acceso válido temporalmente (60 minutos) antes de acceder a RSJ LPSNG para un usuario final. Llama a un servicio web con:
- Actualizar token
Recibe:
- Token de acceso temporal (60 minutos)
La aplicación externa incluye este token de acceso en sus solicitudes de servicio web (en el encabezado HTTP de Auth o como un parámetro)
RSJ LPSNG asocia el token de acceso con la aplicación externa y el usuario final.
El token de acceso puede dejar de ser válido en cualquier momento (incluso antes de que caduque). En este caso, se devuelve un error 401 y la aplicación externa debe recuperar un nuevo token de acceso antes de volver a intentar la solicitud fallida.
| Parámetro | Valor |
| URL | /auth |
| Method | POST |
| grant_type | authorization_code |
| code | Código de autorización (de redirección) |
| client_id | Identificación del cliente (desde el registro de la aplicación) |
| client_secret | Secreto del cliente (desde el registro de la aplicación) |
| refresh_token | Actualizar token (a partir de la autorización de la aplicación) |
| Devoluciones | Estructura JSON |
Casos de uso
- Caracteristicas
- Interfaces
- ESL
- Despliegue
- Presentación de diapositivas
Contacto
Contáctenos para más información:
Or contact us directly:
RSJ Software GmbH
Holzstrasse 4
82120 Germering
Germany
Phone: +49 89 89 41 42-0
Fax: +49 89 89 41 42-80
E-Mail: info@rsj.de
