Manual:Integrat/ANAF/oAuth2/Editare

Prin intermediul acestei ferestre se gestioneaza token-urile necesare pentru accesarea functiilor API oferite de ANAF.

• Tip* - se selecteaza site-ul anaf.ro si apoi se apasa pe aceasta eticheta; are ca efect completarea automata a rubricilor authorizare, token, revoke, callback si port
• Denumire - denumirea tokenului - se foloseste pentru a identifica token-ul in alte ferestre din aplicatie
• Client_ID* - identificatorul clientului OAuth2 utilizat pentru accesul la API
• Client_Secret* - credentialul secret asociat identificatorului clientului OAuth2
• Token - cheia de acces la functiile API
• Refresh - cheia de refresh a token-ului
• StartTime - data si ora la care a fost obtinut token-ul
• StopTime - data si ora la care va expira token-ul

Producatorul aplicatiei obtine de la ANAF credentialele Client_ID si Client_Secret si le pune la dispozitia utilizatorilor aplicatiei.

Utilizatorii folosesc aceste credentiale impreuna cu un certificat digital calificat cu acces la SPV pentru obtinerea token-ului de acces la functiile API.

Dupa apelarea functiei Adaugare se selecteaza la Tip* site-ul anaf.ro si apoi se apasa butonul din stanga al mouseului pe eticheta Tip* care are ca efect completarea credentialelor cu cele obtinute de producatorul aplicatiei si completarea automata a rubricilor authorizare, token, revoke, callback si port, apoi se Salveaza.

La salvare sunt obligatorii tipul conexiunii, denumirea si adresele serviciilor authorize si token. Adresa serviciului token este o rubrica distincta de cheia de acces Token.

Obtinere token acceseaza site-ul ANAF folosind credentialele Client_ID si Client_Secret iar pentru eliberarea tokenului site-ul ANAF cere prezentarea certificatului digital calificat cu drept de acces la SPV.

Revocare token anuleaza tokenul obtinut. Aplicatia nu va mai putea utiliza acel token pentru accesarea serviciilor API ANAF; pentru reluarea accesului este necesara o noua autorizare.

Aplicatia va putea accesa API-urile e-Factura si e-Transport ale tuturor persoanelor juridice sau fizice care au fost inrolate cu respectivul certificat.

Cum se folosesc token-urile?

In cadrul unei firme se pot adauga mai multe token-uri si fiecare token poate avea dreptul de acces la o entitate sau la mai multe entitati.

Daca exista un singur token pentru toate entitatile pe care le gestionati atunci acest token se va selecta la rubrica Token e-Factura si Token e-Transport din fereastra Speciale .

Daca fiecare entitate detine cate un token atunci token-ul se va selecta la rubrica Token e-Factura si Token e-Transport din fereastra Date despre firma .

Mediul de productie

In mod implicit aplicatia foloseste mediul de testare iar trecerea in mediul de productie se efectueaza prin bifarea rubricii Productie din pagina oAuth2 Token din cadrul ferestrei Date despre firma .

Verificare conexiune

Butonul foloseste datele salvate ale conexiunii selectate. Daca ati modificat credentialele sau tokenul, salvati conexiunea inainte de verificare.

Verificarea conexiunii se realizeaza prin apasarea butonului oAuth2 Hello. Daca conexiunea a fost realizata o sa primiti mesajul Legatura cu site-ul ANAF a fost realizata cu succes.

Certificatul digital si locul autorizarii

Rubrica Certificat instalat pe server stabileste, separat pentru fiecare conexiune, unde se deschide sesiunea de autorizare cu certificatul digital.

• Bifat - autorizarea are loc direct in sesiunea in care ruleaza Integrat.STS. In cazul unei sesiuni Remote Desktop, browserul si certificatul trebuie sa fie accesibile pe server, in sesiunea utilizatorului.
• Nebifat - in sesiune Remote Desktop, aplicatia foloseste mecanismul de autorizare prin calculatorul clientului (MyShortcut). Acesta trebuie sa fie activat si configurat. Pe un calculator local, daca executia pe client nu este activata, ramane autorizarea directa in sesiunea curenta.

Dupa modificarea acestei optiuni, salvati conexiunea inainte de utilizarea comenzilor de obtinere a tokenului. Comenzile Obtinere token, Revocare token si Reimprospatare token nu pot fi actionate din modul de editare.

Obtinere, reimprospatare si revocare

1. Selectati conexiunea dorita si verificati credentialele, certificatul si configurarea acesteia.
2. Pentru prima autorizare sau obtinerea unui token nou, folositi Obtinere token si urmati pasii de autorizare din browser.
3. Pentru reinnoirea unui token folositi Reimprospatare token. Operatia necesita o conexiune cu datele necesare reimprospatarii.
4. Pentru anularea accesului, folositi Revocare token. Dupa revocare, accesul care depinde de acel token trebuie autorizat din nou.
5. Verificati rezultatul prin oAuth2 Hello. Mesajul de succes confirma conectarea de test, nu executarea unei operatii e-Factura sau e-Transport.

Cand conexiunea ANAF selectata difera de conexiunea configurata la Date despre firma, aplicatia cere confirmare la Obtinere token si Reimprospatare token. Verificati ca ati ales certificatul corect inainte de continuare.

Reimprospatarea automata la pornire

La pornirea aplicatiei, dupa autentificare si alegerea firmei, este apelata o singura data verificarea pentru reimprospatarea automata a tokenurilor.

Sunt selectate conexiunile de tip anaf.ro care indeplinesc toate conditiile urmatoare:

• Nu sunt marcate Inactiv.
• Au completata cheia Refresh.
• Tokenul expira in cel mult 7 zile, este deja expirat sau nu are completata data expirarii.
• Nu au o incercare de reimprospatare inregistrata ca nereusita in ziua curenta.

Daca o incercare a esuat in ziua curenta, o noua pornire a aplicatiei in aceeasi zi nu repeta automat incercarea pentru acea conexiune. Verificati cauza erorii; daca este necesar, folositi Reimprospatare token manual sau reluati autorizarea.

Conexiunile blocate de alta sesiune sunt omise la verificarea curenta. Daca apare o eroare de procesare, parcurgerea automata se poate opri inainte de verificarea conexiunilor ramase.

Atentie: nu comunicati altor persoane datele Client_Secret, Token sau Refresh.

Mesaje de diagnostic la reimprospatare

Mesajele de mai jos ajuta la urmarirea verificarii automate de la pornire. Mesajele de succes, de omitere a unei conexiuni blocate si de eroare a procesarii automate includ denumirea conexiunii. Mesajele emise direct de reimprospatare pot avea alt format.

• OK - OAuth2: [denumire] - token valabil pana la ... - reimprospatarea s-a incheiat cu succes; este afisata data expirarii noului token.
• OAuth2 Refresh: ... - mesaj privind o eroare la reimprospatare, de exemplu date incomplete, un raspuns neacceptat sau o problema la procesarea raspunsului. Acest mesaj nu include obligatoriu denumirea conexiunii. Verificati datele si starea conexiunii in aceasta fereastra; daca este necesar, incercati Reimprospatare token manual.
• ATENTIE - OAuth2: [denumire] - conexiune blocata de alta sesiune; omisa - conexiunea este folosita de o alta sesiune, iar incercarea curenta este omisa.
• EROARE - OAuth2 automat: [denumire] - procesarea conexiunii a esuat - a aparut o eroare la procesarea automata a acelei conexiuni.

In cazul unei erori, verificati denumirea conexiunii, daca este afisata, si textul mesajului. Un esec al reimprospatarii unei conexiuni nu inseamna ca toate conexiunile oAuth2 au esuat. O eroare de procesare automata poate insa opri verificarea conexiunilor ramase.

Din motive de securitate, mesajele de diagnostic nu trebuie sa afiseze tokenurile, cheia de reimprospatare, secretul clientului sau continutul integral al raspunsului serviciului. Nu includeti aceste date in sesizarile trimise echipei de suport.