Utilizzo di un servizio Web SOAP per autenticarsi con un'applicazione
Per l'autenticazione della chiave API, inserire un codice di autorizzazione in una proprietà Credenziali statiche o definire un ID utente HTTP e una password. Il codice di autorizzazione o l'ID utente HTTP e la password vengono inviati al servizio Web, che scambia i dati. Il servizio Web si autentica quindi con l'applicazione e restituisce una risposta.
Per l'autenticazione della sessione, inserire le credenziali di autenticazione (ID utente e password) e altri valori in una serie di proprietà della richiesta di autenticazione. Il dispositivo di input o la notifica per prima cosa richiama un servizio Web SOAP per autenticarsi con l'applicazione. Una volta che l'autenticazione è avvenuta con successo, il servizio Web restituisce un token al dispositivo di input o alla notifica. Il token viene trasmesso nella chiamata al servizio Web che scambia i dati.
- Se l'applicazione consente una sessione per utente, configurare i dispositivi di input e le notifiche per chiamare i servizi Web con diversi ID utente e password.
- L'autenticazione della sessione avviene quando ogni servizio Web chiama e non è richiesta alcuna disconnessione. Verificare che la lunghezza della sessione per ciascuna serie di credenziali sia inferiore al tempo che intercorre tra le chiamate al servizio Web. Ad esempio, la sessione per un dispositivo di input termina dopo 10 minuti. Al momento della configurazione del dispositivo di input, specificare un intervallo di polling superiore a 10 minuti.
Per ottenere una chiave API o delle credenziali di autenticazione per un'applicazione, contattare la compagnia che ospita l'applicazione. Per i requisiti inerenti a formato e sintassi, fare riferimento alla documentazione dell'applicazione.
- Fare clic sulla scheda Autenticazione sul dispositivo di input o la notifica del servizio Web SOAP.
- Seguire le istruzioni per il tipo di autenticazione richiesto dall'applicazione:
- Per l'autenticazione della chiave API, specificare il codice di autenticazione come
valore della proprietà Credenziali statiche.
Lasciare vuote tutte le altre proprietà. La procedura risulta quindi completata.
- Per l'autenticazione della sessione, lasciare vuota la proprietà Credenziali statiche. Passare alla fase successiva e specificare le altre proprietà.
- Per l'autenticazione della chiave API, specificare il codice di autenticazione come
valore della proprietà Credenziali statiche.
- Configurare la proprietà URL richiesta di autenticazione sull'URL RICOH ProcessDirector usata per autenticarsi con l'applicazione.Se l'applicazione richiede le credenziali di autenticazione nell'URL, specificarle utilizzando la sintassi e il formato richiesti.
- Per il valore della proprietà Payload richiesta autenticazione, specificare il corpo della richiesta di servizi Web che il dispositivo di input
o la notifica inoltra all'applicazione per l'autenticazione.In questi esempi, il payload include tre elementi: <Credentials>, <Name>, e <Password>. Il valore dell'elemento <Password> è un simbolo che utilizza la proprietà Password richiesta autenticazione.
Questo esempio utilizza la proprietà Password richiesta autenticazione per i dispositivi di input:
<Credentials> <Name>myname</Name> <Password>${WebService.AuthRequestPwd}</Password> </Credentials>
Questo esempio utilizza la proprietà Password richiesta autenticazione per le notifiche:
<Credentials> <Name>myname</Name> <Password>${WSNotification.WebService.AuthRequestPwd}</Password> </Credentials>
Il simbolo si risolve all'invio della richiesta di autenticazione.
- Impostare la proprietà Richiesta SOAP autenticazione con la richiesta SOAP creata da RICOH ProcessDirector al momento dell'importazione del file WSDL.Ad esempio, si vuole utilizzare la richiesta SOAP AutenticaUtente. È stato anteposto PrintShop ai nomi delle richieste SOAP quando importate. Selezionare PrintShop-AuthenticateUser.
- Impostare la proprietà Attributo risposta autenticazione con l'espressione XPath che identifica le credenziali per la sessione nella risposta dal servizio Web.
- Impostare la proprietà Password richiesta autenticazione con la password dell'account dell'applicazione.La password è codificata quando archiviata in RICOH ProcessDirector.
- Per i dispositivi di input, la proprietà è WebService.Credenziali.
- Per le notifiche, la proprietà è WSNotifica.WebService.Credenziali.
Quando si specificano i valori sulla scheda Richiesta per un dispositivo di input o una notifica del servizio Web SOAP, dettagliare la proprietà WebService.Credential o WSNotification.WebService.Credential come simbolo.
RICOH ProcessDirector sostituisce il valore delle credenziali statiche o del token per il simbolo quando trasmette la richiesta al servizio Web.
- Preparazione per il recupero dell'input dei servizi Web SOAP.
- Preparazione per l'invio di uno stato ad un servizio Web SOAP.