Przy wdrażaniu podpisu elektronicznego w aplikacji firmowej warto rozważyć API do integracji. Podpisywanie dokumentów nie musi kończyć się na wysłaniu pliku mailem i czekaniu, aż ktoś go wydrukuje, podpisze i odeśle. Wręcz przeciwnie. Jeśli podpis elektroniczny ma być częścią większego procesu, warto pójść krok dalej i „wszyć” go bezpośrednio w aplikację, z której korzystają pracownicy lub klienci. API do podpisu elektronicznego pozwala połączyć własny system z usługą podpisu i uruchamiać cały proces bez przełączania się między narzędziami. Jak może wyglądać podpis elektroniczny dla firm od strony technicznej i co trzeba uwzględnić przy jego integracji?
Spis treści
- Od czego rozpocząć wdrożenie podpisu elektronicznego we własnej aplikacji?
- Trzy modele integracji API SIGNIUS – porównanie
- Jak przebiega podpisywanie w poszczególnych modelach?
- Jaką rolę pełni API RA?
- Jak wybrać model integracji do procesu biznesowego?
SIGNIUS oferuje trzy modele API: Professional, Headless PDF i Headless Hash. Różnią się one tym, gdzie odbywa się obsługa podpisu i jak dużą kontrolę nad procesem chcesz zachować. Z dzisiejszego wpisu dowiesz się, jak przygotować swoją firmę do integracji API i który model odpowiada potrzebom Twojego systemu.
Od czego rozpocząć wdrożenie podpisu elektronicznego we własnej aplikacji?
Wdrożenie podpisu elektronicznego warto zacząć nie od samego API, ale od określenia, jak podpis ma działać w Twojej aplikacji i jakiego poziomu kontroli potrzebujesz. Kluczowe będzie przede wszystkim to, gdzie ma znajdować się interfejs podpisywania, gdzie mają być przechowywane dokumenty oraz jak wygląda obecny obieg dokumentów. Korzystając z SIGNIUS można wykorzystać gotowy interfejs platformy albo obsługiwać podpisywanie we własnej aplikacji. Osobną kwestią jest ustalenie, czy dokumenty mogą opuszczać Twoją infrastrukturę, czy wysyłany będzie wyłącznie jego skrót kryptograficzny, czyli hash.
Przed wyborem rozwiązania należy określić:
- format dokumentów przekazywanych do podpisania;
- wymagane rodzaje podpisów;
- sposoby weryfikacji tożsamości użytkowników;
- miejsce podpisywania dokumentów (gotowy lub własny interfejs);
- sposób odbioru i dalszej obsługi podpisanych danych.
Takie ustalenia pozwalają dobrać oferowany przez SIGNIUS model integracji API do konkretnego procesu.
Trzy modele integracji API SIGNIUS – porównanie
Korzystając z integracji e-podpisu przez API w SIGNIUS możesz wykorzystywać interfejs platformy lub działać bez jej widocznego frontu. Wybierasz model API odpowiedni do tego, jak działa Twoja aplikacja i jakiej kontroli nad dokumentami potrzebujesz.
W przypadku SIGNIUS masz trzy możliwości:
- API Professional – jeśli zależy Ci przede wszystkim na szybkim wdrożeniu i możesz korzystać z gotowego interfejsu SIGNIUS.
- API Headless PDF – jeśli chcesz, żeby użytkownik cały czas pozostawał w Twojej aplikacji, a Ty zachowujesz kontrolę nad UX.
- API Headless Hash – jeśli dokumenty muszą pozostać w Twojej infrastrukturze i potrzebujesz maksymalnej kontroli nad ich obiegiem oraz warstwą podpisu.
Jak przebiega podpisywanie w poszczególnych modelach?
API Professional – podpisywanie w interfejsie SIGNIUS
W modelu API Professional aplikacja tworzy folder, dodaje dokument oraz wskazuje podpisujących i rodzaj podpisu. W przypadku podpisu kwalifikowanego użytkownik przechodzi wymaganą weryfikację tożsamości, a następnie podpisuje dokument na platformie SIGNIUS. Po zakończeniu procesu aplikacja pobiera podpisany plik.
API Professional pozwala wykorzystać gotowy interfejs podpisywania, z możliwością brandingu platformy. Dokumenty PDF i XML są przekazywane do SIGNIUS, a komunikacja z użytkownikiem może być prowadzona przez platformę lub klienta.
API Headless PDF – podpisywanie PDF we własnej aplikacji
W modelu API Headless PDF użytkownik korzysta z interfejsu aplikacji klienta. Proces rozpoczyna się od utworzenia użytkownika przez API RA i przeprowadzenia weryfikacji tożsamości, jeżeli jest wymagana. Następnie odbywa się automatyczne logowanie użytkownika do SIGNIUS.
Aplikacja przekazuje dokument PDF i wyświetla okno do wpisania kodu autoryzacyjnego. Po złożeniu podpisu otrzymuje gotowy, podpisany PDF. Po stronie klienta pozostaje obsługa interfejsu, wyświetlanie wezwania do działania oraz komunikacja z użytkownikiem. W porównaniu z modelem Hash integracja jest prostsza, ponieważ aplikacja odbiera już podpisany dokument.
API Headless Hash – dokument pozostaje w organizacji
W modelu API Headless Hash do SIGNIUS przekazywany jest skrót dokumentu. Sam plik pozostaje w infrastrukturze klienta. Podobnie jak w wariancie Headless PDF, proces obejmuje utworzenie użytkownika przez API RA, ewentualną weryfikację tożsamości oraz automatyczne logowanie do SIGNIUS.
Aplikacja klienta wyświetla okno do wpisania kodu autoryzacyjnego. Po otrzymaniu podpisanego hasha umieszcza go w warstwie elektronicznej dokumentu i prezentuje wynik użytkownikowi. Ten model wymaga własnej obsługi dokumentów i podpisów, a cały interfejs procesu pozostaje po stronie aplikacji klienta.
Jaką rolę pełni API RA?
API RA służy do tworzenia użytkowników i przeprowadzania weryfikacji ich tożsamości, jeśli wymaga tego wybrany proces podpisywania. Uzupełnia modele API Headless PDF oraz API Headless Hash. Jego zadania należy odróżnić od podpisywania dokumentu PDF lub jego skrótu.
W obu modelach Headless najpierw tworzony jest użytkownik, a w razie potrzeby przeprowadzana jest identyfikacja. Kolejne etapy obejmują automatyczne logowanie do SIGNIUS, przekazanie dokumentu lub hasha i autoryzację podpisu. Jeśli stosowany jest kwalifikowany podpis elektroniczny, proces musi uwzględniać wymaganą weryfikację tożsamości.
Wdrażając podpisy elektroniczne dla firm, należy więc zaplanować zarówno obsługę użytkownika, jak i przepływ dokumentacji. Istotnym elementem jest także zdefiniowanie wymaganych rodzajów podpisów elektronicznych.
Jak wybrać model integracji do procesu biznesowego?
Model integracji powinien odpowiadać wymaganiom dotyczącym interfejsu, przepływu dokumentów i zakresu prac po stronie aplikacji klienta. Jeśli liczy się szybkie uruchomienie podpisu i nie potrzebujesz własnego interfejsu, dobrym rozwiązaniem będzie API Professional. Gdy chcesz, aby cały proces podpisywania odbywał się w Twojej aplikacji i był spójny z jej UX, lepiej sprawdzi się API Headless PDF. Z kolei API Headless Hash warto rozważyć wtedy, gdy dokumenty muszą pozostać w Twojej infrastrukturze, a pełna kontrola nad ich obiegiem i warstwą podpisu jest istotnym wymaganiem.
W praktyce najważniejsza decyzja zapada więc jeszcze przed wdrożeniem: wybierasz model API odpowiedni do tego, jak działa Twoja aplikacja i jakiej kontroli nad dokumentami potrzebujesz.
Skontaktuj się z zespołem SIGNIUS, aby dobrać model API odpowiedni do procesu podpisywania w Twojej aplikacji.
FAQ – najczęściej zadawane pytania
Czy można wdrożyć podpis elektroniczny w istniejącej aplikacji firmowej?
Tak. Integracja podpisu elektronicznego przez API umożliwia rozszerzenie funkcjonalności istniejących aplikacji, np. systemów CRM, ERP czy platform SaaS, bez konieczności tworzenia własnej usługi podpisu. W zależności od wybranego modelu użytkownik może korzystać z gotowego interfejsu SIGNIUS lub podpisywać dokumenty bezpośrednio w aplikacji firmowej.
Czy integracja podpisu elektronicznego przez API wymaga przebudowy systemu?
Nie zawsze. Zakres prac programistycznych zależy od architektury aplikacji i wybranego modelu integracji. API Professional pozwala wykorzystać gotowy interfejs podpisywania, natomiast modele Headless wymagają większego zaangażowania po stronie klienta, m.in. w obsługę interfejsu użytkownika i procesu autoryzacji podpisu.
Czy dokumenty firmowe muszą być przesyłane do zewnętrznej platformy podpisu?
Nie. W modelu API Headless Hash dokument pozostaje w infrastrukturze organizacji, a do SIGNIUS przekazywany jest jedynie jego skrót kryptograficzny (hash). To rozwiązanie dla firm, które wymagają większej kontroli nad przepływem dokumentów i sposobem ich przetwarzania.
Czy API SIGNIUS umożliwia składanie kwalifikowanego podpisu elektronicznego?
Tak. API SIGNIUS może obsługiwać procesy wykorzystujące kwalifikowany podpis elektroniczny. W takim przypadku konieczne jest spełnienie wymagań dotyczących weryfikacji tożsamości osoby podpisującej. W modelach Headless proces tworzenia użytkowników i wymaganej identyfikacji wspiera API RA. Szczegółowy przebieg zależy od wybranego modelu integracji.