Uso de la API DocAssurance
El servicio DocAssurance permite realizar diversas operaciones de firma digital o cifrado con documentos de PDF, como firmar, certificar, agregar campos de firma, cifrar, descifrar, etc.
Este artículo proporciona fragmentos de código java para ayudarle a empezar a utilizar la API. El fragmento de código utiliza el token de acceso. Este artículo explica los pasos necesarios para generar el token de acceso
Esta característica está disponible en el programa de usuarios que la adoptaron por primera vez. Puede escribir a aem-forms-ea@adobe.com desde su ID de correo electrónico oficial para unirse al programa de usuarios que lo adoptaron por primera vez y solicitar acceso a esta funcionalidad
Requisitos previos
- Experiencia con AEM Forms Cloud Service
- Experiencia en el uso de componentes HTTP Apache
- Acceso al entorno de Cloud Service de AEM Forms
Documento de Inspect
Utilice la API de inspección para recuperar el tipo de seguridad de un documento de PDF determinado. El siguiente fragmento de código debería ayudarle a empezar.
...
File fileToInspect = new File("path_to_your_pdf_file)";
HttpPost httpPost = new HttpPost("<your_aem_forms_instance>/adobe/forms/document/assure/inspect");
httpPost.addHeader("Authorization", "Bearer " + accessToken);
MultipartEntityBuilder builder = MultipartEntityBuilder.create();
byte[] fileContent = FileUtils.readFileToByteArray(fileToInspect);
builder.addBinaryBody("document", fileContent, ContentType.create("application/pdf"), "BenefitOverview.pdf");
try
{
HttpEntity entity = builder.build();
httpPost.setEntity(entity);
CloseableHttpClient httpclient = HttpClients.createDefault();
CloseableHttpResponse response = httpclient.execute(httpPost);
if (response.getStatusLine().getStatusCode() == 200)
{
String json = EntityUtils.toString(response.getEntity(), StandardCharsets.UTF_8);
log.info("The mode of encryption is " + JsonParser.parseString(json).getAsJsonObject().get("mode").getAsString());
}
}
catch (Exception e)
{
log.error(e.getMessage());
}
...
Cifrar documento
Utilice la API de cifrado para cifrar documentos PDF con contraseña. El siguiente fragmento de código de ejemplo cifra un PDF determinado.
...
File fileToEncrypt = new File("path_to_your_pdf_file");
HttpPost httpPost = new HttpPost(postURL);
httpPost.addHeader("Authorization", "Bearer " + accessToken ");
MultipartEntityBuilder builder = MultipartEntityBuilder.create(); byte[] fileContent = FileUtils.readFileToByteArray(fileToEncrypt); builder.addBinaryBody("document", fileContent, ContentType.create("application/pdf"), "BenefitOverview.pdf");
String config = "{\"mode\":\"ENCRYPT_WITH_PASSWORD\",\"params\":{\"openPassword\":\"adobe\",\"permPassword\":\"systems\",\"permissions\":[\"ALL_PERM\"]}}";
builder.addTextBody("config", config, ContentType.APPLICATION_JSON);
try
{
HttpEntity entity = builder.build();
httpPost.setEntity(entity);
CloseableHttpClient httpclient = HttpClients.createDefault();
CloseableHttpResponse response = httpclient.execute(httpPost);
if (response.getStatusLine().getStatusCode() == 200)
{
InputStream generatedPDF = response.getEntity().getContent();
byte[] bytes = IOUtils.toByteArray(generatedPDF);
File encryptedFile = new File("c:\\aem_forms_cs_api\\encrypted.pdf");
FileOutputStream outputStream = new FileOutputStream(encryptedFile);
outputStream.write(bytes);
outputStream.close();
}
}
catch (Exception e)
{
log.error(e.getMessage());
}
...
Agregar campo de firma al PDF
Utilice la API signfield para agregar una firma al PDF proporcionado. El siguiente fragmento de código de ejemplo agrega un campo de firma denominado SignHere en la página 4 del documento
...
File pdfFile = new File(pdfFile1.getPath());
HttpPost httpPost = new HttpPost(postURL);
httpPost.addHeader("Authorization", "Bearer "+accessToken);
MultipartEntityBuilder builder = MultipartEntityBuilder.create();
byte[] fileContent = FileUtils.readFileToByteArray(pdfFile);
builder.addBinaryBody("document", fileContent, ContentType.create("application/pdf"), "BenefitOverview.pdf");
builder.addTextBody("field", "SignHere", ContentType.TEXT_PLAIN);
String rectangle = "{\"lowerLeftX\":1,\"lowerLeftY\":40,\"width\":100,\"height\":100}";
builder.addTextBody("rectangle", rectangle, ContentType.APPLICATION_JSON);
Quitar cifrado
Utilice la operación PUT en la API de cifrado para quitar el cifrado del PDF proporcionado. El siguiente fragmento de código Java debería ayudarle a empezar.
...
File fileToDecrypt = new File("path_to_your_pdf_file");
HttpPut httpPut = new HttpPut(putURL);
httpPut.addHeader("Authorization", "Bearer " + accessToken);
MultipartEntityBuilder builder = MultipartEntityBuilder.create();
byte[] fileContent = FileUtils.readFileToByteArray(fileToDecrypt);
builder.addBinaryBody("document", fileContent, ContentType.create("application/pdf"), "BenefitOverview.pdf");
builder.addTextBody("config", "systems", ContentType.TEXT_PLAIN);
try {
HttpEntity entity = builder.build();
httpPut.setEntity(entity);
CloseableHttpClient httpclient = HttpClients.createDefault();
CloseableHttpResponse response = httpclient.execute(httpPut);
if (response.getStatusLine().getStatusCode() == 200) {
InputStream generatedPDF = response.getEntity().getContent();
byte[] bytes = IOUtils.toByteArray(generatedPDF);
File encryptionRemoved = new File("c:\\aem_forms_cs_api\\encryption_removed.pdf");
FileOutputStream outputStream = new FileOutputStream(encryptionRemoved);
outputStream.write(bytes);
outputStream.close();
httpclient.close();
}
} catch (Exception e) {
log.error(e.getMessage());
}
...
Colección Postman
Se puede descargar una colección de Postman de la API desde aquí con fines de prueba. Puede utilizar el tipo de autenticación Autenticación básica o Token de portador para invocar la API.