Come si utilizza OAuth2 per l'SDK .NET e l'API REST?
Risposta:
A partire da DocuWare 7.11, l'autenticazione dei cookie nell'API sarà deprecata per aumentare ulteriormente la sicurezza di DocuWare. Per passare dall'autenticazione dei cookie a OAuth2, consultare i seguenti metodi per la conversione a OAuth2 con l'SDK .NET o l'API REST.
SDK .NET
- Per l'SDK .NET, assicurarsi che i pacchetti NuGet dei progetti siano stati aggiornati alla versione più recente, come indicato nel seguente riepilogo delle versioni: Riepilogo delle versioni | DocuWare SDK Documentation
*NOTA: Per OAuth2 è necessaria la versione 13.* e successive di DocuWare.Platform.ServerClient, utilizzata da DocuWare.Platform.ServerClient.Extensions versione 11.12.* e successive. - La connessione al servizio eseguirà l'autenticazione OAuth2 in background, il che significa che non sarà necessario apportare modifiche al codice.
API REST
La nostra Postman Collection è stata aggiornata per utilizzare l'autenticazione OAuth2 invece dell'autenticazione tramite cookie. Per effettuare l'autenticazione tramite OAuth2, è necessario effettuare la seguente sequenza di richieste.
- Get responsible Identity Service (Ottieni servizio di identità responsabile): consente direcuperare informazioni sul servizio di identità della piattaforma DocuWare.
- Get Identity Service Configuration - Questa chiamata recupera la configurazione OpenID per l'Identity Service.
- Utilizzare una delle seguenti richieste per ottenere un token di accesso da Identity Service per scopi di autenticazione e autorizzazione.
3.a Request Token w/ Username & Password
3.b Request Token w/ a DocuWare Token
3.c Request Token w/ Username & Password (Trusted User)
3.d.1 Obtain Windows Authorization (On-Premises Only)
3.d.2 Request Token /w a Windows Conto (On-Premises Only)
Per informazioni più dettagliate sulle Request coinvolte e sulla deprecazione della Cookie Authentication, fare riferimento a quanto segue;
- Requests involved, Documentazione sull'API Rest di DocuWare: https: //go.docuware.com/restsamples
- Deprecazione dell'autenticazione dei cookie: raccolta Postman aggiornata | Documentazione SDK di DocuWare Update
*NOTA: per i clienti On-premise, queste modifiche entreranno in vigore con DocuWare 7.11. È ancora possibile utilizzare l'autenticazione tramite cookie sui sistemi DocuWare 7.10 e successivi.
KBAapplicabile sia alle organizzazioni Cloud che a quelle On-premise.
Si prega di notare: Questo articolo è una traduzione dall'inglese. Le informazioni contenute in questo articolo si basano sulla versione originale in inglese del/i prodotto/i. Potrebbero esserci piccoli errori, ad esempio nella grammatica utilizzata nella versione tradotta dei nostri articoli. Sebbene non possiamo garantire la completa accuratezza della traduzione, nella maggior parte dei casi la troverete sufficientemente informativa. In caso di dubbi, si prega di fare riferimento alla versione inglese di questo articolo.