Skocz do zawartości

Marcin Kasprzycki

InsERT
  • Liczba zawartości

    960
  • Rejestracja

  • Ostatnia wizyta

  • Wygrane w rankingu

    18

Posty dodane przez Marcin Kasprzycki

  1. 2 godziny temu, Michał Karlic napisał:

    Dlaczego jako partner nie mogę sobie wygenerować przedłużenia licencji ??

    Jeżeli chodzi o licencje szkoleniowo-testowe, to Partner może je zamawiać wyłącznie przez dział handlowy firmy InsERT. 

  2. W dniu 14.06.2023 o 11:08, Klaudia Szulc napisał:

    Witam, czy temat został już zrealizowany? Czy również jeżeli chce przenieść podmioty z mojego konta muszę pisać do Inserta?

    W takiej sytuacji należy z poziomu serwisu Konto InsERT zaprosić kolejnego użytkownika do firmy klienta i nadać mu uprawnienia administratora globalnego. Po tej operacji możliwe będzie odłączenie od firmy dotychczasowego użytkownika. W tym momencie nie ma możliwości odłączenia wszystkich użytkowników od firmy. Doprowadzenie do takiego stanu, oznaczałoby dla klienta konieczność przesyłania oświadczeń przed uzyskaniem pełnych uprawnień administracyjnych. 

  3. 51 minut temu, Marek Markowski napisał:

    Sprzedałem klientowi Subiekta123 i mam problem. Z INSERT. Klientowi leci czas usługi, konto insert ma aktywne, licencja przypisana ale nie może korzystać bo nie ma uprawnień.

    Po wygenerowaniu licencji z poziomu Serwisu dla Partnerów, do klienta wysyłana jest wiadomość o temacie "[InsERT] Aktywacja aplikacji Subiekt 123", w której dostępny jest link aktywujący użytkownikowi wszystkie wymagane uprawnienia. Zweryfikowałem, że taki link nie został wykorzystany przez klienta. Wiadomość została wysłana 6 lutego o 14:14, co powinno pomóc w jej odnalezieniu. 

  4. 4 minuty temu, Jacek Izydorczyk napisał:

    Jak mam się zalogować do Konta InsERT gdy utraciłem wszystkie metody weryfikacji?

    W takiej sytuacji należy przesłać zgłoszenie problemu i oczekiwać na kontakt z naszej strony. 

    Cytat

    Uwaga! W przypadku braku kodu odzyskiwania należy skontaktować się z firmą InsERT używając formularza kontaktowego. Odzyskanie dostępu do konta może zająć kilka dni, a w pewnych przypadkach może być niemożliwe ze względu na brak możliwości zweryfikowania użytkownika.

     

  5. 1 godzinę temu, Bartosz Roszewski napisał:

    Nie u wszystkich właśnie. Nie ma reguły. Mam kilkuset klientów. Rozwiązanie, żeby udostępnić wszystkim jeszcze raz jest mało trafne. Zresztą pewnie dostaliby maile z zaproszeniem do usługi a nie chcę wprowadzać zamieszania.

    Potwierdzam, że w momencie przedłużania licencji w marcu, nie dla wszystkich klientów wpisała się licencja udostępniona. W tej chwili wygenerowaliśmy licencje dla pozostałych klientów. Przepraszamy za niedogodności.

  6. Szanowni Państwo,

     

    Informujemy o udostępnieniu portalu dewelopera InsERT API, w ramach którego możliwe jest tworzenie integracji z aplikacjami webowymi firmy InsERT. Na początek w ramach InsERT API udostępniamy API aplikacji Subiekt 123 oraz Serwisu zleceń online. 

     

    Dostęp do portalu można uzyskać z poziomu oferty polecanych produktów w Koncie InsERT lub nadając wymagane uprawnienia z poziomu zarządzania użytkownikami firmy.

     

    Po uzyskaniu uprawnień, do portalu dewelopera można dostać się, wchodzą na stronę https://developers.insert.com.pl lub korzystając z menu posiadanych aplikacji zalogowanego użytkownika. 

     

    Wraz z uruchomieniem InsERT API, udostępniamy dedykowane forum, na którym zachęcamy do zgłaszania problemów i sugestii dotyczących nowego rozwiązania. 

     

    Zachęcamy również do zapoznania się z wprowadzeniem opisującym zasady tworzenia integracji z wykorzystaniem protokołu autoryzacji OAuth 2.0 oraz z przykładami, które zostały opublikowane na naszym GitHubie.

  7.  Wstęp

     

    W ramach portalu dewelopera InsERT API udostępniamy możliwość tworzenia integracji z aplikacjami webowymi firmy InsERT. Z jego poziomu dostępna jest specyfikacja interfejsów API poszczególnych produktów, możliwość subskrybowania wybranego API oraz rejestrowania tworzonego rozwiązania.
     

     

    Rejestracja aplikacji OAuth 2.0


    Autoryzacja użytkowników w tworzonych rozwiązaniach odbywa się przy użyciu standardowego protokołu autoryzacji OAuth 2.0. Przed przystąpieniem do procesu autoryzacji wymagane jest zarejestrowanie aplikacji w portalu dewelopera, które prowadzi do uzyskania danych niezbędnych do uwierzytelnienia aplikacji w InsERT API.
     

    W procesie rejestrowania aplikacji należy wprowadzić jej nazwę, opis oraz określić zakres wykorzystywanych API (scopes).
     

    app_dane.png.46a37d60d718bd9f46b937ce0e78141a.png

     

    Dodatkowo konieczne jest określenie adresu strony www autora integracji, adresu polityki prywatności oraz adresu powrotu, na który nastąpi przekierowanie po poprawnym przeprowadzeniu procesu uwierzytelnienia i autoryzacji użytkownika.
     

    app_adresy.png.72ca22cf8677e28e48123c0f9eded975.png

     

    Po zarejestrowaniu aplikacji uzyskiwany jest unikalny Client ID oraz Client Secret, które są niezbędne w procesie komunikacji w ramach protokołu OAuth 2.0.

     

     

    Autoryzacja użytkownika
     

    Proces autoryzacji użytkownika przy użyciu protokołu OAuth 2.0 realizowany jest z wykorzystaniem Authorization Code (with PKCE).

     

    W aplikacji, z której użytkownik inicjuje integrację z produktem webowym Insertu, zostaje umieszczony przez autora integracji odnośnik np. Połącz z Subiektem 123, będący odpowiednio przygotowanym adresem URL prowadzącym do serwisu, w którym nastąpi uwierzytelnienie oraz autoryzacja użytkownika.
     

    Przykład:

    https://kontoapi.insert.com.pl/connect/authorize
    	?response_type=code
    	&client_id=932...3804c
    	&state=fd9...16e97
    	&scope=openid%20profile%20email%20subiekt123%20offline_access
    	&redirect_uri=https%3A%2F%2Fprzykladowa-integracja.pl%2Fv1%2Fcallback
    	&code_challenge=odd...dWm3
    	&code_challenge_method=S256

    Parametry żądania:
    image.png.0853da9ea025891d1272c5b49a4bdca4.png

    Rodzaje scopów:
    image.png.ce496abd79ae5a4319e3f8284e3b76f6.png

     

    Po skorzystaniu z opcji Połączenia z Subiektem 123 użytkownik zostaje przekierowany na stronę logowania do Konta InsERT, na której potwierdza swoją tożsamość za pomocą konta wykorzystywanego podczas dostępu do aplikacji.

     

    logowanie.png.432b45f177e2cbc94092a7973a120333.png

     

    W kolejnym kroku użytkownik wyraża zgodę na dostęp do danych swojego Konta InsERT (dane profilowe, e-mail) oraz danych, które gromadzi w aplikacji Subiekt 123.
     

    zgody.png.098fcda5de946491013a9e10c761e108.png

     

    Po wyrażeniu zgody następuje przekierowanie na adres powrotu zdefiniowany podczas rejestrowania aplikacji przez jej autora. W odpowiedzi przekazany zostaje m.in. parametr code, który pozwala w okresie jego ważności (60 sekund) uzyskać token dostępowy (access_token).
     

    Przykład odpowiedzi:

    https://przykladowa-integracja.pl/v1/callback
    	?code=fa1...25d3d9
    	&state=fd9...16e97

     

     

    Pozyskiwania oraz odświeżanie tokenów dostępowych
     

    W oparciu o otrzymany po poprawnej autoryzacji użytkownika parametr code, aplikacja uzyskuje token wykonując żądanie HTTP z dołączonym nagłówkiem:

    POST https://kontoapi.insert.com.pl/connect/token
    

     

    Nagłówek:
    image.png.cb7dc11a7600e7e2678dde6a549c3ab6.png

    Parametry żądania:
    image.png.5e4225e914b6802aba154e200330be87.png

    Przykład odpowiedzi po poprawnym wykonaniu żądania:

    {
    	"id_token": "eyJ...TaNgITUw",
    	"access_token": "ey...16M9YA",
    	"expires_in": 3600,
    	"token_type": "Bearer",
    	"refresh_token": "78C...5F3A5",
    	"scope": "openid profile email subiekt123 offline_access"
    }

    Uzyskany token dostępowy (access_token) posiada ważność przez 60 minut. W celu uzyskania nowego tokena dostępowego należy posłużyć się tokenem odświeżającym (refresh_token), którego ważność została ustalona na 90 dni. Każde uzyskanie nowego tokena dostępowego, wydłuża ważność tokena odświeżającego. Maksymalny czas życia dla tokena odświeżającego został ustalony na 365 dni.
     

    Przykład żądania pozwalającego uzyskać nowy token dostępowy w oparciu o posiadany token odświeżający:

    POST https://kontoapi.insert.com.pl/connect/token
    

    Nagłówek:image.png.fb46b8806e80e5d3066ac7c2a22d44b1.png

    Parametry żądania:
    image.png.1752f2f181f0da89605a356cc8c4e975.png

    Przykład odpowiedzi po poprawnym wykonaniu żądania:

    {
    	"id_token": "eyJ...TaNgITUw",
    	"access_token": "ey...16M9YA",
    	"expires_in": 3600,
    	"token_type": "Bearer",
    	"refresh_token": "78C...5F3A5",
    	"scope": "openid profile email subiekt123 offline_access"
    }

     

     

    Subskrypcja API
     

    Korzystanie z API wymaga posiadania aktywnej subskrypcji dla wybranego produktu. W tym celu należy aktywować subskrypcję w portalu dewelopera InsERT API.
     

    Dla każdej subskrypcji generowane są dwa klucze, co pozwala zapewnić nieprzerwane działanie tworzonego rozwiązania na wypadek potrzeby unieważnienia/przegenerowania jednego z nich.

     

    Klucz subskrypcji należy przekazywać wraz z każdym żądaniem wysyłanym do API naszych produktów.

     

     

    Przykłady integracji
     

    Zapraszamy do zapoznania się z przykładami integracji, które zostały opublikowane w serwisie GitHub.

  8. 16 godzin temu, Łukasz Kierus napisał:

    Jak należy to naprawić? Insert poinformował, że widoczność licencji poprawi w najbliższych dniach, najwyraźniej jeszcze się to nie zadziało

    W przypadku Konta InsERT występuje tylko problem z zaprezentowaniem dwóch licencji np. Subiekta GT w jednej firmie. Licencje normalnie są zarejestrowane, ale nie są widoczne w serwisie. Nie powinno mieć to żadnego wpływu na działanie programu. Ten błąd został już poprawiony na naszym wewnętrznym środowisku i poprawka zostanie opublikowana wraz z porcją innych zmian w niedalekiej przyszłości. 

     

    Bardzo proszę o podesłanie w wiadomości prywatnej namiarów na Pana firmę oraz loginu Konta InsERT. Spróbujemy znaleźć przyczynę problemów w programie.  

  9. W dniu 5.02.2022 o 13:51, Lech Templin napisał:

    Tworzę nowy temat ponieważ nie potrafię zadać pytania w istniejących już tematach.

    Widzę jedynie możliwość udzielenia odpowiedzi na zadane przez innego użytkownika pytanie.

    Czy dobrze rozumiem, że istnieją tematy, w których nie posiada Pan dostępnej opcji

    image.png.a27a235052714e8c428233d873dfb199.png

    na końcu wątku?

  10. W ostatnim czasie przeprowadziliśmy wewnętrzne testy wyszukiwania, które wykazały szereg problemów podczas używania tej wyszukiwarki:

     

    image.png.9c26a61da7281d2e4a075be4835b4ce6.png

     

    Dlatego została podjęta decyzja o ukryciu jej na poziomie strony głównej oraz kategorii np. Sello. Wyszukiwarka jest dostępna tylko na poziomie forum, w którym aktualnie się znajdujemy. Wszystkie dodatkowe opcje dostępne w rozwijanym menu zostały ukryte, ponieważ tak jak wspominałem nie działały zbyt dobrze.

     

    Do ogólnego wyszukiwania treści zalecamy korzystanie z opcji dostępnej w głównym menu. W tym miejscu wyszukiwarka działa zdecydowanie lepiej:

     

    image.png.dc6e3476c734d13a2b7937e8a868506c.png

     

    Oczywiście wyszukiwarka kontekstowa powinna być dostępna w działach Pomocna dłoń oraz Dodatki i programy zewnętrzne. Jest to błąd, który poprawimy w najbliższym czasie. 

  11. W dniu 29.12.2021 o 16:58, Mirosław Gołębiowski napisał:

    Czy wiadomo kiedy będzie dostępne API do Subiekt123 lub na jakim etapie są prace?

    Na ten moment prace nadal trwają. Jesteśmy zmuszeni przesunąć termin udostępnienia API na 1-2 kwartał 2022.

  12. W dniu 25.10.2021 o 20:58, Karolina Sosińska napisał:

    Dobry wieczór, 

    aktywnych licencji w rachmistrzu mam ponad 100 a Subiekt123 linia GT pozwala mi się udostępnić tylko dla 1. Z czego to wynika?

    Ze względu na nasze wewnętrzne problemy nie wykonało się automatyczne ustalenie jednostek dla licencji Subiekta 123 InsERT GT. Procedura została już wykonana i limit udostępnień wynosi 100 podmiotów. 

     

    W dniu 25.10.2021 o 20:58, Karolina Sosińska napisał:

    Na próbę miałam aktywną licencję na Subiekt123 nie dla BR - w mailu dostałam informację, że nic nie muszę robić, a nadal mam w produktach 2 Subiekty z różnymi licencjami. Oczywiście sobie nie mogę już udostępnić Subiekta, bo udostępniłam klientowi :D

    Posiada Pani aktywną licencje demonstracyjną indywidualnego Subiekta 123 oraz licencję pozwalającą na udostępnianie aplikacji dla swoich klientów. W takiej sytuacji nic więcej nie musi Pani robić. Po wygaśnięciu miesięcznej licencji demonstracyjnej dostęp do usługi będzie nadal możliwy, ponieważ aktywowana została licencja Subiekta 123 dla GT. Nie ma potrzeby udostępniania na potrzeby własnego biura. 

  13. W tej konkretnej sytuacji to są trzy konta założone na różne adresy e-mail, którymi przynajmniej raz zalogowano się na forum. W związku z tym, że konta rozróżniamy po mailu, a wyświetlane imię i nazwisko nie może być unikalne, to niestety dochodzi do takich sytuacji. Zastanowimy się, czy da się tu wprowadzić jakieś dodatkowe rozróżnienie kont. 

  14. 1 godzinę temu, Katarzyna Kusak napisał:

    Dzień dobry, po zmianie interfejsu nie mogę udostępnić Subiekta123 dla klienta biura. Klient zarejestrowany  - ma konto Insert.
    Dane klienta aktualne, a opcja "przejdź dalej" pozostaje nieaktywna.

    Problem ujawnił się przy braku uzupełnionych wszystkich danych w firmie klienta. W najbliższych dniach opublikujemy poprawkę, która zapobiegnie podobnym przypadkom. 

×
×
  • Dodaj nową pozycję...