Swipeguide: Autentificare unică (SSO)

Last updated: June 19, 2026

Utilizare generală​

Oferim o integrare de autentificare OAuth2 pentru platformă, care poate fi utilizată pentru autentificarea în Web CMS, aplicația Web Frontline, aplicațiile native SwipeGuide (iOS și Android) pentru acces offline și aplicația Abilități inteligente.

Acest lucru le permite utilizatorilor să se autentifice prin furnizorul OAuth2 administrat de compania dumneavoastră.

Rețineți că nivelurile de autorizare din cadrul platformei sunt în continuare gestionate în platformă, pentru a menține un sistem ușor de utilizat și de înțeles.

Oferim flexibilitatea de a configura diferite tipuri de metode de autentificare în CMS și în aplicațiile Frontline, în funcție de nevoile Spațiului de lucru, cum ar fi e-mailul și parola, precum și SSO. Alternativ, puteți solicita utilizatorilor să se autentifice DOAR prin SSO.

Dacă doriți să activați această funcție pe platforma dumneavoastră, asigurați-vă că contactați serviciul de asistență SwipeGuide înainte de a utiliza această documentație.

Condiții preliminare​

  1. Platforma dumneavoastră trebuie să aibă deja activate opțiunile de autentificare (spre deosebire de o platformă publică).
  2. Furnizorul OAuth2 pe care doriți să îl utilizați pentru autentificarea în SwipeGuide trebuie să fie deja administrat și configurat de echipele dumneavoastră IT, cu acreditări sau certificate valide. SwipeGuide trebuie să fie deja adăugat ca una dintre aplicațiile din sistemele dumneavoastră.

Configurare OAuth2​

Pentru documentația de bază, consultați site-ul OAuth. Pentru a configura platforma, avem nevoie ca anumite informații să fie transmise serviciului dumneavoastră de autentificare OAuth2 și avem nevoie de anumite informații pentru a conecta serviciile. Avem un URL de callback care trebuie configurat în cadrul serviciului de autentificare OAuth2 și vom avea nevoie de anumite tokenuri de autorizare OAuth2 de la serviciu. Acestea vor diferi în funcție de serviciu.

În prezent, acceptăm direct:

  • Microsoft Entra ID (cunoscut anterior ca Azure AD)
  • Google

Microsoft Entra ID​

Pentru ca configurarea Microsoft Entra ID (cunoscut anterior ca Azure AD) să funcționeze, avem nevoie de: clientID, clientSecret, resource și tenant. Pentru mai multe informații despre acestea, consultați documentația OAuth pentru Azure Entra ID.

URL de callback

https://[platform].swipeguide.com/sso/azureadoauth2/callback

Platforma din URL este domeniul principal al platformei care trebuie menționat. Rețineți că acest URL de callback va funcționa atât pentru platformele cu un singur domeniu, cât și pentru cele cu mai multe domenii, iar utilizatorul va fi redirecționat în mod corespunzător.

Google​

Pentru ca configurarea Google să funcționeze, avem nevoie de: clientID, clientSecret și hostedDomain. Pentru mai multe informații despre acestea, consultați documentația OAuth pentru Google.

URL de callback

https://[platform].swipeguide.com/sso/googleoauth2/callback

Platforma din URL este domeniul principal al platformei care trebuie menționat. Rețineți că acest URL de callback va funcționa atât pentru platformele cu un singur domeniu, cât și pentru cele cu mai multe domenii, iar utilizatorul va fi redirecționat în mod corespunzător.

Configurare SAML 2.0​

Pentru ca configurarea SAML să funcționeze, vom avea nevoie de fișierul dvs. de metadate sau de:

entryPoint: URL-ul serviciului SSO cert: Certificatul public de semnare utilizat pentru validarea semnăturilor răspunsurilor SAML primite, dacă este utilizat.

Atributele pe care trebuie să ni le trimiteți: displayName, ID, Email

URL-ul serviciului pentru consumatori de aserțiuni

https://[platform].swipeguide.com/sso/saml/consume

Metadate SAML

https://[platform].swipeguide.com/sso/saml/metadata

ID entitate: swipe-guide

Platforma din URL este domeniul principal al platformei la care trebuie să se facă referire. Rețineți că acest URL de callback va funcționa atât pentru platformele cu un singur domeniu, cât și pentru cele cu mai multe domenii, iar utilizatorul va fi redirecționat în mod corespunzător.

Expirarea automată a sesiunii​

Ca serviciu și configurare suplimentară a platformei, puteți solicita Managerului de Succes al Clienților ca sesiunile să expire automat după X minute de inactivitate (lipsa solicitărilor către server).

Întrebări frecvente

1. Aflați ce trebuie să faceți atunci când este afișată o eroare de autentificare SSO după încercarea de a vă autentifica în SwipeGuide

Este posibil să primiți o eroare de autentificare atunci când vă conectați la platformele SwipeGuide din cauza unei chei secrete expirate.

Conectarea unică (SSO) este o metodă de autentificare care permite utilizatorilor să se autentifice în siguranță în mai multe aplicații și site-uri web utilizând un singur set de acreditări.

În prezent, SSO este o funcție suplimentară care poate fi solicitată prin trimiterea unui tichet către echipa de asistență. Departamentul IT al companiei dumneavoastră trebuie să furnizeze informațiile solicitate, pe baza furnizorului de soluții dorit, echipei de inginerie SwipeGuide pentru a configura acest lucru. Nu gestionăm și nu întreținem noi cheile niciunuia dintre clienți.

Dacă considerați că cheia secretă a expirat sau este pe cale să expire, procedați după cum urmează:

  • Informați departamentul IT local despre acest lucru și solicitați din timp un certificat nou
  • Contactați echipa de asistență SwipeGuide cu noile detalii

Notă: Recomandăm cu tărie companiei dumneavoastră să seteze un memento la fiecare 2 ani pentru a preveni blocarea autentificării utilizatorilor și pentru a ne transmite noile acreditări.

2. Mai mulți utilizatori pe un dispozitiv partajat

Este posibil să vă confruntați cu o situație în care, să spunem, „Operatorul A și Operatorul B folosesc un dispozitiv partajat, Operatorul A se deconectează din aplicație, iar apoi Operatorul B se conectează în aplicație. Operatorul B vede acum Matricea Abilităților Operatorului A.”

De ce se întâmplă acest lucru?

Când un utilizator se autentifică în aplicație folosind SSO, verifică dacă există deja o sesiune SSO activă pe dispozitivul respectiv. Dacă Operatorul A se deconectează din aplicație, dar nu se deconectează complet și din contul SSO, următoarea persoană (Operatorul B) va fi recunoscută automat ca Operatorul A la autentificarea prin SSO. Acesta este un comportament obișnuit în multe aplicații care folosesc SSO sau servicii similare, deoarece se bazează pe starea curentă de autentificare a browserului sau a dispozitivului.
 
Pentru a vă asigura că fiecare utilizator trebuie să își introducă datele de autentificare atunci când folosește un dispozitiv partajat, urmați acești pași:
1. După utilizarea aplicației, deconectați-vă din APLICAȚIE ca de obicei.
2. De asemenea, deconectați-vă complet din contul SSO (Google, de exemplu) din browser sau de pe dispozitiv.
3. Următorul utilizator se poate autentifica apoi folosind propriile date de autentificare.
 
Alternativ, pentru a evita această recunoaștere automată SSO, utilizatorii se pot autentifica folosind adresa de e-mail și parola, în loc de SSO, pe dispozitivele partajate.