RSJ-Labelprinter - follow the QR-Code RSJ-Next Generation Label Printing System - makes workflow easier RSJ-Software, Company Logo

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

  1. 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
  2. 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

Contact

Contactez-nous pour plus d'informations:

Name
Company
Email
Phone
How can we help you?

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

© Copyright 2011-2023 by RSJ Software GmbH Germering. All rights reserved. - Version:1.12.0576