Generowanie tokena
- Henryk Rybinski
- Dorota Bazan (Unlicensed)
Konieczność wygenerowania tokena wynika z potrzeby uwierzytelnienia roli importera do PBN. Jeżeli osoba upoważniona do importowania danych w PBN z systemu bazy wiedzy nie ma tokena, system PBN uniemożliwia przeprowadzenie operacji przekazania danych do PBN.
Token może być wygenerowany jedynie wówczas, gdy spełnione są określone warunki organizacyjne umożliwiające transfer do PBN. W szczególności należy
zapewnić rolę Menadżera Aplikacji w systemie PBN
pozyskać dane dostępowe do używania API PBN
X-App-Id – identyfikator zarejestrowanej aplikacji reprezentującej instytucję
X-App-Token – token dla aplikacji wystawiony podczas rejestracji
zapewnienie kilku osobom roli Importerów Publikacji w systemie PBN.
Jeżeli dane dostępowe do używania API są już w posiadaniu jednostki, to osoby posiadające w PBN rolę importera mogą pozyskać token użytkownika z poziomu systemu OMEGA-PSIR. Funkcja generowania tokena jest uruchamiana przez użycie przycisku Wygeneruj nowy token importera PBN. Użycie tego przycisku wyzwala następującą procedurę:
następuje przeniesienie do strony logowania PBN (o ile operator nie jest już zalogowany do PBN) - w ten sposób system PBN weryfikuje, czy dany użytkownik posiada rolę importera w PBN;
Jeżeli walidacja wypada pomyślnie, następuje powrót do ekranu OMEGA-PSIR, jednocześnie system OMEGA-PSIR otrzymuje token X-User-Token, który zostaje zapisany w rekordzie użytkownika. Otrzymany token jest indywidualnie przypisany tylko temu użytkownikowi (zalogowanemu do OMEGA-PSIR i do PBN) i po zapisaniu go w rekordzie przez system OMEGA-PSIR użytkownik uzyskuje dostęp do API PBN.
Generowanie tokena zwykle jest realizowane jednorazowo. Menedżer aplikacji może jednak w dowolnym momencie wygenerować nowy token aplikacji, pozbawiając dostępu do API PBN wszystkich importerów. W takim przypadku, o ile rola importera nie została użytkownikowi odebrana w PBN, zawsze jest możliwość ponownego wygenerowania tokena X-User-Token.
UWAGA: W przypadku gdy nie został zadeklarowany url powrotu z systemu PBN jako URL systemu bazy wiedzy, token nie zostaje zapisany w bazie wiedzy w rekordzie użytkownika, jedynie otwarte zostanie okno z błędnym URL. W oknie tym należy wyciąć zapis ott=<token> i wkleić do URL omega-psir: https://<url-bazy-wiedzy>/pbn-user-token?ott=<token otrzymany z PBN>
Instrukcje uzyskiwania tokenu dostępne są na stronach pomocy PBN:
https://pbn.nauka.gov.pl/centrum-pomocy/open-api-w-wersji-produkcyjnej-pbn/
https://pbn.nauka.gov.pl/centrum-pomocy/baza-wiedzy/uzyskanie-integracji-z-api-pbn/