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.

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

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.

Aplicatia dispune si de o procedura de reimprospatare automata pentru conexiunile active al caror token expira in cel mult 7 zile. Aceasta nu opereaza asupra conexiunilor marcate Inactiv; daca reimprospatarea esueaza, poate fi necesara verificarea sau autorizarea manuala.

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

Mesaje de diagnostic la reimprospatare

La pornirea aplicatiei, mecanismul de reimprospatare automata poate verifica tokenurile active care urmeaza sa expire. In consola este afisata denumirea conexiunii, astfel incat rezultatul sa poata fi identificat si atunci cand sunt configurate mai multe certificate.

• OK - OAuth2: [denumire] - token valabil pana la ... - reimprospatarea s-a incheiat cu succes; este afisata data expirarii noului token.
• EROARE - OAuth2: [denumire] - reimprospatarea tokenului a esuat - reimprospatarea conexiunii respective nu a reusit. 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 mai intai denumirea conexiunii afisate. Un esec nu inseamna ca toate conexiunile oAuth2 au esuat: fiecare conexiune se proceseaza separat.

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.