Skip to main content

Dokumenty zawierające dane klientów, informacje finansowe czy tajemnice przedsiębiorstwa nie zawsze mogą być przesyłane do zewnętrznych systemów. Tymczasem proces ich podpisywania elektronicznego często wymaga integracji z platformą dostawcy usługi. Jak firmy mogą zachować pełną kontrolę nad dokumentami, nie rezygnując z wygody i automatyzacji e-podpisu? Odpowiedzią jest podpis elektroniczny headless, realizowany za pośrednictwem API. SIGNIUS oferuje wariant API Headless Hash, w którym do SIGNIUS przekazywany jest skrót dokumentu (tzw. hash), a sam plik pozostaje w firmie. Ten model integracji pozwala korzystać z funkcji podpisywania dokumentów bezpośrednio we własnych systemach, bez konieczności korzystania z gotowego interfejsu platformy SIGNIUS. Integracja ta pozwala zachować kontrolę nad obiegiem dokumentów i miejscem przetwarzania danych. Z dzisiejszego wpisu dowiesz się, czym jest podpis elektroniczny typu headless i jak działa podpisywanie hashy.

Spis treści

Czym jest podpis elektroniczny headless?

W modelu podpisu elektronicznego API headless użytkownik korzysta z interfejsu Twojej aplikacji, a usługa SIGNIUS odpowiada za operacje podpisywania. Mówiąc wprost: Twoja firma korzysta z technologii podpisu elektronicznego, ale cały proces obsługuje we własnym systemie, np. w systemie ERP, CRM, platformie do zarządzania dokumentami (DMS) czy autorskiej aplikacji biznesowej. Po Twojej stronie pozostaje obsługa użytkownika, wyświetlanie wezwania do działania i komunikacja związana z procesem.

Platforma do podpisywania dokumentów SIGNIUS oferuje dwa modele API headless:

  • API Headless PDF – przekazujesz do SIGNIUS dokument PDF, a po podpisaniu otrzymujesz gotowy, podpisany plik;
  • API Headless Hash – przekazujesz wyłącznie skrót dokumentu, a po otrzymaniu podpisanego hasha umieszczasz go w warstwie elektronicznej pliku.

W obu wariantach interfejs pozostaje po stronie Twojej aplikacji. Dodatkowo, model Hash pozwala podpisywać bez przesyłania całego dokumentu do SIGNIUS. Wybierając podpis elektroniczny API, warto więc konkretnie określić wymagania dotyczące UX i przepływu plików.

Kiedy wybrać API Headless Hash?

API Headless Hash odpowiada na potrzebę podpisywania dokumentów, które mają pozostać w infrastrukturze organizacji. Twoja aplikacja przekazuje do usługi skrót kryptograficzny dokumentu, czyli hash. Po podpisaniu odbiera wynik i odpowiada za jego umieszczenie w dokumencie.

Ten model warto rozważyć, jeśli:

  • dokumenty nie mogą być wysyłane poza organizację;
  • chcesz zachować cały interfejs podpisywania we własnej aplikacji;
  • dysponujesz własną warstwą obsługi dokumentów i podpisów.

Jeżeli pliki PDF mogą być przekazywane do SIGNIUS, a zależy Ci przede wszystkim na własnym interfejsie, odpowiedni może być API Headless PDF. Jego integracja jest prostsza niż wariantu Hash, ponieważ aplikacja otrzymuje gotowy, podpisany dokument.

Jak przebiega podpisywanie dokumentu, który pozostaje w firmie?

Model integracji API Headless Hash obejmuje obsługę użytkownika, przekazanie skrótu i przygotowanie podpisanego dokumentu po stronie aplikacji klienta. Przebiega następująco:

  1. Tworzysz użytkownika przez API RA i, jeśli jest to wymagane, przeprowadzasz weryfikację jego tożsamości.
  2. Następuje automatyczne logowanie użytkownika do SIGNIUS.
  3. Twoja aplikacja wysyła hash dokumentu do usługi.
  4. Wyświetlasz w aplikacji okno do wpisania kodu autoryzacyjnego — użytkownik zatwierdza podpisanie.
  5. Otrzymujesz podpisany hash.
  6. Umieszczasz go w warstwie elektronicznej dokumentu i prezentujesz wynik użytkownikowi.

API RA służy do tworzenia użytkowników i weryfikacji tożsamości, jeśli wymaga jej wybrany proces. Model Headless Hash obsługuje podpisy zaawansowane, zaawansowane z KYC oraz kwalifikowany podpis elektroniczny.

Co uwzględnić przy wyborze modelu integracji?

Najważniejsze jest określenie poziomu kontroli, jakiej potrzebujesz. Ustal, czy Twoja aplikacja ma odbierać gotowy podpisany PDF, czy samodzielnie obsługiwać wynik podpisania hasha. Wariant Hash jest dedykowany organizacjom posiadającym własny system obiegu dokumentów i własny interfejs użytkownika, jak i mechanizm umieszczenia podpisanego skrótu w dokumencie.

Przed wdrożeniem ustal również wymagane rodzaje podpisów oraz metody identyfikacji użytkowników. Pozwoli to określić zakres integracji i zadania realizowane przez Twój system.

Jakie inne rozwiązania warto wziąć pod uwagę?

API Headless to obecnie najbardziej popularny i najchętniej wybierany model integracji podpisu elektronicznego SIGNIUS. Organizacje rozważające kwalifikowany podpis elektroniczny dla biznesu we własnym środowisku mogą rozważyć model wdrożenia rozwiązania w opcji on-premise. Z kolei podpisywanie dokumentów online w obsługiwanych aplikacjach desktopowych wspiera SIGNIUS Harmony.

Poza podpisami elektronicznymi SIGNIUS oferuje także masową kwalifikowaną pieczęć elektroniczną wydawaną na firmę. Usługa ta wspiera cyfryzację dokumentacji firmowej w obszarze pieczętowania. Ich zastosowanie należy omówić przy określaniu wymagań wdrożenia.

Skontaktuj się z nami i porozmawiaj o możliwościach integracji podpisów elektronicznych przez API w Twojej firmie.

SIGNIUS

Na blogu SIGNIUS dzielimy się wiedzą o podpisie elektronicznym, pieczęci elektronicznej, cyfrowej tożsamości i automatyzacji procesów biznesowych. Pokazujemy, jak firmy mogą bezpiecznie i zgodnie z regulacjami wdrażać rozwiązania e-podpisu i e-pieczętowania, redukować koszty operacyjne i przyspieszać obieg dokumentów. Nasze treści są praktyczne i oparte na realnych zastosowaniach w biznesie – od małych firm po duże organizacje.

 

FAQ – najczęściej zadawane pytania

Czym jest podpis elektroniczny headless?

Podpis elektroniczny headless to model integracji, w którym proces podpisywania dokumentów odbywa się bezpośrednio w systemie firmy, np. ERP, CRM lub DMS, bez konieczności korzystania z interfejsu zewnętrznej platformy. SIGNIUS realizuje operacje podpisywania za pośrednictwem API, a organizacja zachowuje kontrolę nad interfejsem użytkownika i obiegiem dokumentów.

Czym różni się API Headless Hash od API Headless PDF?

Główna różnica dotyczy sposobu przekazywania dokumentów. W modelu API Headless PDF do SIGNIUS wysyłany jest cały plik PDF, a po podpisaniu aplikacja otrzymuje gotowy dokument. Natomiast w API Headless Hash przekazywany jest wyłącznie skrót kryptograficzny dokumentu (hash). Sam plik pozostaje w infrastrukturze firmy, która odpowiada za umieszczenie podpisanego hasha w dokumencie.

Czy dokumenty firmowe muszą być przesyłane do zewnętrznej platformy podpisu?

Tak. API Headless Hash SIGNIUS umożliwia podpisywanie dokumentów bez przekazywania całych plików do zewnętrznej platformy. Do usługi wysyłany jest jedynie hash dokumentu, który następnie zostaje podpisany. Dzięki temu organizacja może zachować dokumenty we własnej infrastrukturze i jednocześnie korzystać z podpisów elektronicznych.

Jakie rodzaje podpisów elektronicznych obsługuje API Headless Hash SIGNIUS?

API Headless Hash SIGNIUS obsługuje podpisy elektroniczne zaawansowane, zaawansowane z weryfikacją tożsamości (KYC) oraz kwalifikowane podpisy elektroniczne. W zależności od wybranego rodzaju podpisu proces może wymagać identyfikacji użytkownika za pośrednictwem API RA. Pozwala to dostosować sposób podpisywania dokumentów do wymagań organizacji i realizowanych procesów biznesowych.