Document watermark

Step 1: Download the SDK package

1. Log on to the Workspace Security console.

2. In the left-side navigation pane, choose Digital Watermarking > Embedding Service.

3. On the Embedding Service page, click Download SDK in the Actions column for the document watermark feature to download the document watermark SDK package to your local computer. Save the AK and SK information.

   Currently, only the Java language is supported.

   Currently, only the Java language is supported.

   • watermark-normaldocument-v1.2.8.jar: The SDK package for watermarking. Add this package to the Maven repository.

   • normalDocumentDemo: A demo for document watermarking. Use this demo to try it out.

Step 2: Integrate the SDK

1. Add the JAR package dependency (Maven).

   1. Add the dependency for watermark-normaldocument-v1.2.8.jar.

      mvn install:install-file  -Dfile=watermark-normaldocument-v1.2.8.jar  -DgroupId=com.aliyun.security.sase -DartifactId=watermark-normaldocument  -Dversion=v1.2.8  -Dpackaging=jar

   2. Add the following dependencies to the pom.xml file.

      <dependency>
          <groupId>com.aliyun.security.sase</groupId>
          <artifactId>watermark-normaldocument</artifactId>
          <version>v1.2.8</version>
      </dependency>
      <dependency>
          <groupId>net.java.dev.jna</groupId>
          <artifactId>jna</artifactId>
          <version>5.13.0</version>
      </dependency>
      <dependency>
          <groupId>org.apache.poi</groupId>
          <artifactId>poi</artifactId>
          <version>3.17</version>
      </dependency>
      <dependency>
          <groupId>org.apache.poi</groupId>
          <artifactId>poi-ooxml</artifactId>
          <version>3.17</version>
      </dependency>
      <dependency>
          <groupId>org.apache.poi</groupId>
          <artifactId>poi-ooxml-schemas</artifactId>
          <version>3.17</version>
      </dependency>
      <dependency>
          <groupId>org.apache.poi</groupId>
          <artifactId>poi-scratchpad</artifactId>
          <version>3.17</version>
      </dependency>
      <dependency>
          <groupId>org.apache.poi</groupId>
          <artifactId>poi-excelant</artifactId>
          <version>3.17</version>
      </dependency>
      <dependency>
          <groupId>org.apache.poi</groupId>
          <artifactId>ooxml-schemas</artifactId>
          <version>1.3</version>
          <exclusions>
              <exclusion>
                  <groupId>org.apache.xmlbeans</groupId>
                  <artifactId>xmlbeans</artifactId>
              </exclusion>
          </exclusions>
      </dependency>

2. Call the document watermark API.

   1. Initialize the AccessKey ID and AccessKey secret.

        /**
         * Initializes the AccessKey ID and AccessKey secret.
         * @param appKey The application key.
         * @param secret The application secret.
         * @param useLocalConfig Specifies whether to use local configurations. 0: remote configuration (requires an internet connection); 1: local configuration.
         */
      WaterMarkUtils.init(appKey, secret, useLocalConfig);

   2. Embed a document watermark in a document.

      • Method 1: Generate a new document after embedding the watermark.

        ParamsFile paramsFile = new ParamsFile();
        // Visible watermark parameters (required): {"invisibleAntiTextCopy":"true","invisibleAntiAllCopy":"true","backgroundControl":{"bgAddVisible":"true","bgVisibleControl":{"visibleText":"Alibaba visible watermark TEST123","mode":"pos","fontSize":"30","fontColor":"0x000000","fontTransparent":"0.2","angle":"30","pos_x":"0.5","pos_y":"0.5","fontPath":"/tmp/AlibabaPuHuiTi-2-45-Light.ttf"},"bgAddInvisible":"true","bgInvisibleControl":{"invisibleTransparent":"0.03"}}}
        paramsFile.setVisibleParam(visibleParam);
        // Destination file path.
        paramsFile.setDestFilePath(dest);
        // Source file path.
        paramsFile.setSrcFilePath(src);
        // Watermark number. Range: 1 to 4294967295.
        paramsFile.setMsgNum(msgNum);
        /**
         * Embeds a watermark in a file.
         * @param baseParam
         * @return
         * @throws NormalDocumentException See Error Codes for the definitions of errorCode and errorMessage.
         * @throws IOException
         */
        WaterMarkUtils.WatermarkFile(paramsFile);

      • Method 2: Embed a watermark using a byte array and receive the output as a byte array.

        ParamsBytes paramsBytes = new ParamsBytes();
        // Set the source file byte array.
        paramsBytes.setSrcFileBytes(srcFileBytes);
        // File name. The file type is obtained from the file name.
        paramsBytes.setFileName("234.doc");
        // Visible watermark parameters: {"invisibleAntiTextCopy":"true","invisibleAntiAllCopy":"true","backgroundControl":{"bgAddVisible":"true","bgVisibleControl":{"visibleText":"Alibaba visible watermark TEST123","mode":"pos","fontSize":"30","fontColor":"0x000000","fontTransparent":"0.2","angle":"30","pos_x":"0.5","pos_y":"0.5","fontPath":"/tmp/AlibabaPuHuiTi-2-45-Light.ttf"},"bgAddInvisible":"true","bgInvisibleControl":{"invisibleTransparent":"0.03"}}}
        paramsBytes.setVisibleParam(visibleParam);
        // Watermark number. Range: 1 to 4294967295.
        paramsBytes.setMsgNum(msgNum);
        /**
         * Embeds a watermark and returns the destination file as a byte array.
         * @param baseParam
         * @return
         * @throws NormalDocumentException See Error Codes for the definitions of errorCode and errorMessage.
         * @throws IOException
         */
        byte[] destFileBytes = WaterMarkUtils.WatermarkFile(paramsBytes);

visibleParam

This parameter controls watermark features. For example, you can use it to enable or disable invisible watermarks, configure the style of background visible watermarks, set the intensity of background invisible watermarks, and enable or disable background visible and invisible watermarks.

{
  "invisibleAntiTextCopy": "true",
  "invisibleAntiAllCopy": "true",
  "backgroundControl": {
    "bgAddVisible":"true",
    "bgVisibleControl": {
      "visibleText":"Alibaba visible watermark TEST123",
      "mode":"pos",
      "fontSize":"30",
      "fontColor":"0x000000",
      "fontTransparent":"0.2",
      "angle":"30",
      "pos_x":"0.5",
      "pos_y":"0.5",
      "fontPath":"/tmp/AlibabaPuHuiTi-2-45-Light.ttf"
    },
    "bgAddInvisible":"true",
    "bgInvisibleControl": {
      "invisibleTransparent":"0.03"
    }
  }
}

The following table describes the parameters.

bgVisibleControl

Step 1: Create an extraction task

1. Log on to the Workspace Security console.

2. In the left-side navigation pane, choose Digital Watermarking > Extraction Service.

3. On the Extraction Service page, click Create Extraction Task to extract the invisible watermark content from the leaked document.

   For the Is Screenshot parameter, select Yes or No based on the file that you upload.

   Parameter	Description
   Watermark version	Select the watermark version to use. Valid values: Normal: Supports extraction from standard files that are not generated by AI. AIGC: Supports extraction from files generated by AI.
   Watermark type	Select Document Watermark.
   Bit width of embedded watermark	Specify the bit width of the embedded watermark. This value must match the bit width configured in the SDK (default is 32).
   Upload file for watermark extraction	Upload the leaked file as prompted.

Step 2: View the extraction result

After the extraction task is created and successfully completed, view the result to obtain the invisible watermark plaintext.

1. On the Extraction Service page, click Show in the Extracted Information column.

2. In the expanded information, you can find the invisible watermark plaintext (a decimal number).

   The expanded information also shows the Watermark Content Type (for example, 64-bit uint information) and the Extraction Result status.