PDF Redaction
Widget na stronę internetową

Widget do osadzenia

Osadź anonimizację PDF bezpośrednio na swojej stronie internetowej za pomocą tagu script lub komponentu React.

Widget PDF Redaction pozwala osadzić proces przesłanie pliku → wykrycie danych PII → anonimizacja → pobranie bezpośrednio na Twojej stronie internetowej, bez przesyłania plików przez Twój własny backend. Działa w izolowanym (sandboxed) iframe hostowanym na pdf-redaction.com i jest autoryzowany dla poszczególnych domen za pomocą jednego z Twoich kluczy API. Korzysta z tego samego silnika OCR działającego w przeglądarce co główna aplikacja i obsługuje ponad 100 języków.

Osadzony widget w trybie pełnego edytora z panelem weryfikacji danych PII i wykrytymi encjami, takimi jak telefon, e-mail, lokalizacja, adres, kod pocztowy, URL, organizacja i twarz


1. Utwórz klucz API z obsługą widgetu

  1. Przejdź do https://pdf-redaction.com/apikeys/ i utwórz klucz API (lub użyj istniejącego).
  2. Kliknij ikonę widgetu obok klucza, aby otworzyć ustawienia Embeddable Widget Settings.
  3. Dodaj domeny, które mogą osadzać widget z tym kluczem (np. example.com). Pozostawienie tego pola pustego pozwala używać klucza na dowolnej domenie — nie jest to zalecane w środowisku produkcyjnym.
  4. Wybierz tryb domyślny:
    • Full editor (pełny edytor) — ten sam proces przesyłania, weryfikacji, anonimizacji i pobierania co na pdf-redaction.com.
    • Auto redact (automatyczna anonimizacja) — proces na jedno kliknięcie: upuszczasz plik, który jest automatycznie analizowany i anonimizowany, a następnie rozpoczyna się pobieranie.
  5. Skopiuj wygenerowany fragment kodu dla swojej integracji (poniżej).

2. Osadzenie za pomocą tagu script

Dodaj ten kod na dowolnej stronie w dozwolonej domenie:

<script src="https://pdf-redaction.com/widget.js"></script>
<div id="pdf-redaction-widget"></div>
<script>
  PdfRedactionWidget.init({
    key: 'YOUR_API_KEY',
    container: '#pdf-redaction-widget',
    mode: 'auto', // or 'full'; omit to use the key's default mode
    locale: 'pl',
    onRedactionComplete: function (fileName) {
      console.log('Redaction complete:', fileName)
    },
    onError: function (message) {
      console.error('Widget error:', message)
    },
  })
</script>

Widget jest wyświetlany jako responsywny iframe, który automatycznie dopasowuje wysokość do zawartości.


3. Osadzenie w React (w fazie rozwoju)

W aplikacjach React zainstaluj @stabrise/redaction-widget-react i użyj komponentu RedactionWidget — lekkiej nakładki na ten sam iframe, z którego korzysta loader skryptu:

import { RedactionWidget } from '@stabrise/redaction-widget-react'

function MyPage() {
  return (
    <RedactionWidget
      apiKey="YOUR_API_KEY"
      mode="auto"
      onRedactionComplete={(fileName) => console.log('done', fileName)}
      onError={(message) => console.error(message)}
    />
  )
}

Jak działa autoryzacja

Widget korzysta z Twojego istniejącego klucza API zamiast osobnych danych uwierzytelniających. Ponieważ klucz jest używany po stronie klienta (jest widoczny w kodzie źródłowym strony), autoryzacja opiera się na domenie, a nie na tajności klucza — podobnie jak klucz Google Maps™ czy publiczny klucz Stripe:

  • Podczas ładowania iframe widgetu Twój klucz oraz origin strony osadzającej są wysyłane do pdf-redaction.com w celu weryfikacji.
  • Jeśli dla klucza ustawiono dozwolone domeny, widget wyświetla się tylko wtedy, gdy origin strony osadzającej pasuje do jednej z nich.
  • Bez dozwolonych domen klucza można używać na dowolnej stronie — rób tak tylko podczas testów.

Tryby

TrybDziałanie
fullWyświetla pełny edytor anonimizacji: przesłanie pliku, automatyczne wykrywanie danych PII, ręczną weryfikację wykrytych elementów, a następnie pobranie.
autoPrzesyła plik, automatycznie wykrywa dane PII, anonimizuje wszystko, co wykryto, i rozpoczyna pobieranie bez ręcznej weryfikacji.

Zdarzenia postMessage

Zarówno loader skryptu, jak i komponent React komunikują się z osadzoną stroną za pomocą postMessage. Jeśli tworzysz własną integrację bezpośrednio z iframe, wartości type wiadomości są następujące:

  • pdf-redaction:widget:ready — iframe → strona nadrzędna, wysyłane po zamontowaniu.
  • pdf-redaction:widget:init — strona nadrzędna → iframe, wysyłane w odpowiedzi na ready.
  • pdf-redaction:widget:resize — iframe → strona nadrzędna, { height } w pikselach.
  • pdf-redaction:widget:redaction-complete — iframe → strona nadrzędna, { fileName }.
  • pdf-redaction:widget:error — iframe → strona nadrzędna, { message }.