Intégration d'applications externes
Services Web
RSJ LPSNG fournit les services Web suivants:
- Soumettre un travail d'impression
Soumettre un travail d'impression
| Paramètre | Valeur | | --- | --- | | URL | / submit | | Méthode | POST | | Type de contenu | multipart / form-data | | titre | Description de l'emploi pour l'affichage | | format | ID de mise en page | | données | Données (au format CSV, JSON, XML ou Excel) | | rappel | callback JSONP optionnel | | oauth_token | Jeton d'accès OAuth2 (s'il n'est pas spécifié dans l'en-tête HTTP d'autorisation dans le schéma OAuth) |
Authentification
RSJ LPSNG utilise le protocole standard OAuth2 pour intégrer de manière sécurisée plusieurs applications externes indépendantes à une multitude d’utilisateurs.
RSJ LPSNG utilise cette authentification comme base pour ses décisions de routage
Enregistrement d'une application externe
Les développeurs peuvent enregistrer en ligne une application externe auprès de RSJ LPS NG en fournissant:
- Nom de l'application
- Description de l'application
- Icône d'application
- URL de redirection d'application
Ils recevront:
- ID d'application
- Secret d'application
Autorisation d'application externe
Les utilisateurs finaux peuvent en ligne autoriser des applications externes à utiliser RSJ LPS NG sur leur bannière.
Vue de l'utilisateur final
- L'utilisateur clique sur un lien dans l'application externe, qui le redirige vers la connexion RSJ LPSNG (s'il n'est pas déjà connecté), puis vers l'écran d'autorisation RSJ LPS NG
- Si l'utilisateur accepte le couplage d'application, il est redirigé vers l'application externe où les informations d'authentification sont stockées.
Vue d'application externe
L'application externe fournit les informations suivantes avec la redirection:
- Identifiant d'application (attribué lors de l'enregistrement de l'application)
- URL de rappel (spécifiée lors de l'enregistrement de l'application)
- Informations de contexte facultatives (pour le rappel)
| Paramètre | Valeur | | --- | --- | | URL | / autoriser | | Méthode | GET | | clientid | Identifiant client (à partir de l'enregistrement de l'application) | | typeréponse | code | | portée | complet | | redir_uri | Redirect URI (doit correspondre à l'URI lors de l'enregistrement de l'application) | | Etat | Informations de contexte facultatives pour le rappel |
Après autorisation, la session de l'utilisateur final est redirigée vers l'application externe avec les paramètres suivants:
- Informations de contexte (de la redirection)
- Code d'autorisation temporaire (valable 10 minutes)
L'application externe appelle un service Web pour échanger l'autorisation temporaire avec le jeton d'actualisation permanente en fournissant:
- Code d'autorisation temporaire
- ID d'application
- Secret d'application
- URL de rappel
L'application externe stocke en permanence le jeton d'actualisation pour l'utilisateur final
| Paramètre | Valeur | | --- | --- | | URL | / auth | | Méthode | POST | | granttype | refreshtoken | | refresh_token | Actualiser le jeton (à partir de l'autorisation de l'application) | | Retours | Structure JSON |
Demandes d'applications externes
L'application externe doit échanger le jeton d'actualisation contre un jeton d'accès valide temporairement (60 minutes) avant d'accéder à RSJ LPSNG pour un utilisateur final. Il appelle un service web avec:
- Actualiser le jeton
Il reçoit:
- Jeton d'accès temporaire (60 minutes)
L'application externe inclut ce jeton d'accès dans ses demandes de service Web (dans l'en-tête HTTP Auth ou en tant que paramètre)
RSJ LPSNG associe le jeton d'accès à l'application externe et à l'utilisateur final.
Le jeton d'accès peut devenir invalide à tout moment (même avant son expiration). Dans ce cas, une erreur 401 est renvoyée et l'application externe doit extraire un nouveau jeton d'accès avant de réessayer la demande en échec.
| Paramètre | Valeur | | --- | --- | | URL | / auth | | Méthode | POST | | granttype | autorisationcode | | code | Code d'autorisation (de redirection) | | clientid | Identifiant client (à partir de l'enregistrement de l'application) | | clientsecret | Client Secret (à partir de l'enregistrement de l'application) | | refresh_token | Actualiser le jeton (à partir de l'autorisation de l'application) | | Retours | Structure JSON |
Use Cases
- Caractéristiques
- Interfaces
- ESL
- Déploiement
- Diapositives de présentation
Contact
Contactez-nous pour plus d'informations:
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
