[Email DLP] Configuration File Columns (Secure Download for Box Type) – HENNGE One Help Center

Target

Admins responsible for the initial setup and operational management of Email DLP

Purpose

This article explains the columns (items) of the Secure Download Method settings file.
By using the settings file, you can register and update Email DLP settings in bulk.
For instructions on how to create and import the settings file, please refer to the following article.
About Creating Email DLP Import Data (Settings File)

Notes

The content of this article is based on the product specifications as of December 2025 and is subject to change without notice.
Admin privileges for Email DLP are required to check the actual screens or make configuration changes.
For instructions on how to configure admin settings, please refer to the following article.
Configuring Email DLP Admin Privileges
For information on how to access the Email DLP Administration, please refer to the following article.
[Email DLP] How to Log in to the Administration

Content

The supported file formats are YAML and JSON.
The unique key is "name" (the name of the Secure Download Method).
When "Overwrite" is selected, all information associated with the unique key will be overwritten.
If you want to modify only part of the information, be sure to include all necessary information for each Secure Download Method.

Columns

Column	Description
version	Specify 1. (Fixed value)
box_upload_configs	Creates the specified Secure Download for Box Methods from the following lines.
name	Specify the name of the Secure Download for Box Method.
options	Specify the options for the Secure Download for Box Method from the following lines.
pdf	If the Link Sharing method is PDF, specify this and then include basename and language_order in the following lines.
basename	Specify the PDF Filename.
language_order	Specify the PDF Languages and their order. ・ja-JP: Japanese ・en-US: English ・zh-TW: Traditional Chinese ・zh-CN: Simplified Chinese *Multiple languages can be specified. List them in order of priority. The PDF will be generated with pages in the order listed.
msg_body	If the Link Sharing method is Email body, specify this and then include language in the following line.
language	Specify the Message Language. ・ja-JP: Japanese ・en-US: English ・zh-TW: Traditional Chinese ・zh-CN: Simplified Chinese
custom_template	If you want to use a Custom Template in the Email body, specify the content here.
template_name	Specify the name of the Custom Template.
use_custom_template	If you want to use a Custom Template, set this to true.
use_msg_body	Specify whether to use the Email body Link Sharing method. *If both "use_pdf" and this value are set to false, an import error will occur. ・true ・false
use_pdf	Specify whether to use the PDF Link Sharing method. *If both "use_msg_body" and this value are set to false, an import error will occur. ・true ・false
shared_link_expiry_in_days	Specify the expiration period for the link. *1–31 days
time_zone	Specify the Time Zone. Example: For the United States, specify America/New_York.

Example

・Create a type that sends via both PDF and Email body.
・Use a Custom Template for the Email body content.

YAML Format

version: 1
box_upload_configs:
- name: PDFで送信
  options:
    pdf:
      basename: hennge_secure_download
      language_order:
      - ja-JP
      - en-US
      - zh-TW
      - zh-CN
    msg_body:
      language: ja-JP
      custom_template: "testTemplate\nダウンロードURL：((%DOWNLOAD-URL%)) \nURL有効期限：((%EXPIRATION-DATE%)) "
      template_name: testTemplate
      use_custom_template: true
    use_msg_body: true
    use_pdf: true
    shared_link_expiry_in_days: 31
    time_zone: America/New_York

JSON Format

{
"version": 1,
  "box_upload_configs": [
    {
      "name": "PDFで送信",
      "options": {
        "pdf": {
          "basename": "hennge_secure_download",
          "language_order": [
            "ja-JP",
            "en-US",
            "zh-TW",
            "zh-CN"
          ]
        },
          "msg_body": {
          "language": "ja-JP",
          "custom_template": "testTemplate\nダウンロードURL：((%DOWNLOAD-URL%)) \nURL有効期限：((%EXPIRATION-DATE%)) ",
          "template_name": "testTemplate",
          "use_custom_template": true
        },
        "use_msg_body": true,
        "use_pdf": true,
        "shared_link_expiry_in_days": 31,
        "time_zone": "America/New_York"
      }
    }
  ]
}