How to Redact Text in C# PDF with IronSecureDoc
En este artículo, discutiremos cómo redactar texto en un PDF usando IronSecureDoc. Esto permite que el servicio o proceso redacte rápidamente y con facilidad información sensible haciendo una simple POST solicitud con el PDF al servidor IronSecureDoc en funcionamiento. Demostraremos esto visualmente a través del uso de los documentos Swagger. La solicitud POST toma tanto parámetros obligatorios como opcionales y es altamente personalizable; la respuesta devuelve el PDF con el texto redactado.
Cómo redactar texto en PDF con IronSecureDoc
- Extraiga e inicie la imagen Docker de IronSecureDoc
- Prueba la API usando Swagger
- Especifica el texto que se desea redactar
- Ejecuta la llamada API con los detalles proporcionados
- Exporta el documento PDF redactado
Tire y arranque IronSecureDoc
Si aún no tienes IronSecureDoc funcionando, sigue los enlaces a continuación para configurarlo:
| Alojar localmente | Implementar en la nube |
|---|---|
La API de redacción de texto [POST]
El punto de acceso de la API Redactar Texto [POST] le permite ocultar texto sensible dentro de un documento PDF usando redacción. Esta funcionalidad es esencial para aplicaciones que manejan documentos confidenciales, como contratos legales, registros médicos o informes financieros. Usar esta API garantiza que el texto específico sea eliminado permanentemente, proporcionando mayor seguridad y asegurando el cumplimiento con los estándares de protección de datos.
Pavonearse
Swagger es una herramienta poderosa que permite a los desarrolladores interactuar con APIs RESTful a través de una interfaz web amigable para el usuario. Ya sea que esté usando lenguajes como Python, Java u otros, Swagger ofrece una forma conveniente de probar e implementar esta API.
Pasos para redactar texto con Swagger
- Acceder a la interfaz Swagger:
Si su servidor de API está ejecutándose localmente, puede acceder a Swagger navegando a http://localhost:8080/swagger/index.html en su navegador web.
- Ubique la API Redactar Texto [POST]:
Dentro de la interfaz de Swagger, encuentre el punto final POST /v1/document-services/pdfs/redact-text.
- Especifique las configuraciones:
En este ejemplo, estoy proporcionando tanto el archivo PDF como las palabras para redactar en la solicitud POST. Vamos a redactar la palabra "we" y superponer un cuadro negro sobre ella. Para esta demostración, usaremos el archivo 'sample.pdf' con las siguientes configuraciones:
draw_black_box:truematch_whole_word:truewords_to_redact: we
Suba un PDF de muestra:
En el cuerpo de la solicitud, cargue un archivo PDF de ejemplo donde desee aplicar la redacción. Asegúrese de que el archivo se agregue como
pdf_file.- Ejecutar la solicitud:
Haga clic en "Ejecutar" para ejecutar la solicitud. La respuesta incluirá el PDF redactado. Esta interacción con la interfaz de usuario de Swagger le permite probar fácilmente el proceso de redacción, proporcionando retroalimentación inmediata.
Utilice la solicitud CURL a través del símbolo del sistema
Alternativamente, podemos usar el Símbolo del sistema con una solicitud curl POST para lograr el mismo resultado.
curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' \
-H 'accept: */*' \
-H 'Content-Type: multipart/form-data' \
-F 'pdf_file=@sample.pdf;type=application/pdf' \
-F 'words_to_redact="we"' \
-F 'draw_black_box=true' \
-F 'match_whole_word=true'curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' \
-H 'accept: */*' \
-H 'Content-Type: multipart/form-data' \
-F 'pdf_file=@sample.pdf;type=application/pdf' \
-F 'words_to_redact="we"' \
-F 'draw_black_box=true' \
-F 'match_whole_word=true'curl como un alias para Invoke-WebRequest, un cmdlet incorporado de PowerShell. Intente usar curl.exe en lugar de curl.curl.exe --versioncurl.exe --version)}]
Parámetros obligatorios del cuerpo de la solicitud
| Nombre | Tipo de datos | Descripción |
|---|---|---|
archivo_pdf | application/pdf | El archivo PDF que desea manipular. |
palabras_a_redactar | array[string] | Este parámetro toma una lista de palabras y redacta el texto que coincide con la entrada. |
Parámetros opcionales del cuerpo de la solicitud
| Nombre | Tipo de datos | Descripción |
|---|---|---|
contraseña_de_usuario | cadena | Esto es necesario si el PDF de entrada tiene contraseña de usuario. La operación fallará si no se proporciona una contraseña para el PDF protegido. |
contraseña_del_propietario | cadena | Esto es necesario si el PDF de entrada tiene una contraseña de propietario. La operación fallará si no se proporciona una contraseña para el PDF protegido. |
páginas_específicas | array[int] | Te permite especificar en qué páginas redactar texto. Por defecto, el valor es null, lo que significa que la palabra proporcionada será redactada en todas las páginas. |
dibujar_caja_negra | boolean | Te permite especificar si se dibujará un cuadro negro sobre el texto redactado. Por defecto, este valor está establecido en True. |
emparejar_palabra_completa | boolean | Especifica si también se deben redactar coincidencias parciales dentro de las palabras. Por ejemplo, si la palabra proporcionada es "are", cualquier palabra que contenga "are", como "hare", también tendrá redactado "are". Por defecto, esto está establecido en True. |
match_case | boolean | Especifica si la palabra proporcionada debe coincidir exactamente en términos de mayúsculas y minúsculas. Por defecto, este valor es null. Nota: Configurar esto en True significa que las cadenas en minúsculas y mayúsculas no se considerarán coincidentes. Por ejemplo, si la palabra proporcionada es "WE", la versión en minúsculas "we" no será redactada. |
texto superpuesto | cadena | Especifica el texto superpuesto, como palabras o símbolos, sobre el texto redactado. Por defecto, esta cadena está vacía. |
guardar_como_pdfa | boolean | Guarda el PDF modificado con cumplimiento de PDF/A-3. Por defecto, esto está establecido en False. |
guardar_como_pdfua | boolean | Guarda el PDF modificado con cumplimiento de PDF/UA. Por defecto, esto está establecido en False. |
Parámetros de encabezado opcionales
| Nombre | Tipo de datos | Descripción |
|---|---|---|
autor | cadena | Útil para identificarte como autor del documento PDF. Por defecto, este campo está vacío. |
título | cadena | Muestra el título del documento PDF. Por defecto, este campo está vacío. |
tema | cadena | Útil para identificar el contenido del documento PDF a simple vista. Por defecto, este campo está vacío. |
Preguntas Frecuentes
¿Cómo puedo redactar texto en un PDF usando una solicitud POST?
Puedes redactar texto en un PDF realizando una solicitud POST al servidor IronSecureDoc con el archivo PDF y las palabras que deseas redactar. El servidor procesa la solicitud y devuelve un PDF con el texto redactado.
¿Cuáles son los pasos para usar la API de IronSecureDoc para la redacción de PDF?
Para usar la API de IronSecureDoc para la redacción de PDF, primero debes descargar y comenzar la imagen de Docker de IronSecureDoc, probar la API usando Swagger, especificar el texto para redactar, ejecutar la llamada API y finalmente exportar el documento PDF redactado.
¿Cómo puedo probar la API de IronSecureDoc antes de usarla en producción?
Puedes probar la API de IronSecureDoc usando Swagger accediendo a la interfaz de Swagger, la cual te permite usar los endpoints proporcionados para simular el proceso de redacción.
¿Qué parámetros pueden personalizarse en una solicitud de redacción de PDF?
En una solicitud de redacción de PDF, puedes personalizar parámetros como user_password, owner_password, specific_pages, draw_black_box, match_whole_word, match_case, overlay_text, save_as_pdfa y save_as_pdfua para una mayor personalización.
¿Cómo ejecuto una solicitud de redacción de PDF usando curl?
Para ejecutar una solicitud de redacción de PDF usando curl, puedes usar un comando de solicitud POST de curl, especificando los parámetros necesarios y la ruta del archivo en tu línea de comandos.
¿Qué debo hacer si mi PDF está protegido con contraseña durante la redacción?
Si tu PDF está protegido con contraseña, necesitas incluir el user_password o owner_password en los parámetros opcionales para asegurar que el proceso de redacción pueda acceder y modificar el documento.
¿Cuál es el propósito del parámetro 'draw_black_box' en la redacción de texto?
El parámetro 'draw_black_box' especifica si se cubre el texto redactado con un cuadro negro. Esta opción es útil para visualizar las áreas redactadas y está habilitada por defecto.
¿Cómo puedo alojar IronSecureDoc localmente para fines de redacción?
Puedes alojar IronSecureDoc localmente siguiendo los tutoriales proporcionados para varios sistemas operativos como Windows, Mac o Linux, permitiéndote gestionar el proceso de redacción en tu servidor local.
¿Es posible redactar páginas específicas en un PDF?
Sí, puedes especificar qué páginas redactar usando el parámetro 'specific_pages', el cual te permite dirigir áreas particulares del documento para la redacción.
¿Puedo superponer texto en áreas redactadas en un PDF?
Sí, puedes superponer texto en áreas redactadas usando el parámetro 'overlay_text', el cual te permite reemplazar el texto redactado con un mensaje personalizado o un marcador de posición.
¿IronSecureDoc es compatible con .NET 10 y sus bibliotecas cliente?
Sí, IronSecureDoc proporciona un cliente .NET a través del paquete NuGet Iron Software.SecureDoc.Client, y es compatible con .NET 10, además de versiones anteriores como .NET 6-9. Esto garantiza la integración fluida de la redacción y las API relacionadas en aplicaciones .NET 10.
¿Aún desplazándote?
¿Quieres una prueba rápida?
ejecuta una muestra observa cómo se encripta tu PDF.
Comience gratis
Comience gratis
Reserve demostración en vivo gratis
No se requiere tarjeta de crédito ni creación de cuenta
