Transloadit の新しい PDF 結合 Robot のご紹介
私たちにとって愛着のある Robotに、新しい仲間が加わることをお知らせするのは、いつもうれしいものです。今回のブログでは、/document/merge Robotをご紹介します。

すでにお気づきかもしれませんが、/document/merge Robotは、複数の PDF を連結して単一のドキュメントを出力します。さらに、この Robotは、パスワードで保護された複数の PDF の結合にも対応しています。入力ファイルのパスワードを配列で渡すだけで処理できます。出力パスワードを指定すれば、出力 PDF も保護できます。パスワード保護は安全なワークフローを構成する要素の一つであり、アップロード、ストレージ、共有リンクのアクセス制御に代わるものではありません。
2 つの PDF の結合
実際に試してみましょう。以下の Templateでは、パスワードで保護された 2 つの PDF を結合します。ドキュメントの一括処理を自動化するには、SDKの利用もご検討ください。
<!-- This pulls Uppy from our CDN -->
<!-- For smaller self-hosted bundles, install Uppy and plugins manually: -->
<!-- npm i --save @uppy/core @uppy/dashboard @uppy/remote-sources @uppy/transloadit ... -->
<link
href="https://releases.transloadit.com/uppy/v6.0.6/uppy.min.css"
rel="stylesheet"
/>
<button id="browse">Select Files</button>
<script type="module">
import {
Uppy,
Dashboard,
ImageEditor,
RemoteSources,
Transloadit,
} from 'https://releases.transloadit.com/uppy/v6.0.6/uppy.min.mjs'
const uppy = new Uppy()
.use(Transloadit, {
waitForEncoding: true,
alwaysRunAssembly: true,
assemblyOptions: {
params: {
// It's often better store encoding instructions in your account
// and use a `template_id` instead of adding these steps inline
steps: {
':original': {
robot: '/upload/handle',
},
merge: {
use: {
steps: [':original'],
bundle_steps: true,
},
robot: '/document/merge',
result: true,
input_passwords: ['password1', 'password2'],
},
exported: {
use: ['merge', ':original'],
robot: '/s3/store',
credentials: 'demo_s3_credentials',
url_prefix: 'https://demos.transloadit.com/',
},
},
},
},
})
.use(Dashboard, { trigger: '#browse' })
.use(ImageEditor, { target: Dashboard })
.use(RemoteSources, {
companionUrl: 'https://api2.transloadit.com/companion',
})
.on('complete', ({ transloadit }) => {
// Due to `waitForEncoding:true` this is fired after encoding is done.
// Alternatively, set `waitForEncoding` to `false` and provide a `notify_url`
console.log(transloadit) // Array of Assembly Statuses
for (const assembly of transloadit) {
console.log(assembly.results) // Array of all encoding results
}
})
.on('error', (error) => {
console.error(error)
})
</script>
この公開デモでは、サンプルドキュメントとデモ用の簡単なパスワードを使用します。元のファイルと、暗号化されていない結合済み PDF の両方を公開バケットにエクスポートします。ここでは機密情報を含まないファイルのみを使用してください。独自の実装には、後述の非公開ストレージの例を使用してください。
このように、input_passwords パラメーターにパスワードの配列を渡すと、Transloadit が PDF を処理します。その後、ドキュメントが単一の PDF に結合され、以下のように出力されます。

出力をパスワードで保護するには、output_password を設定してください。以下のパスワードのプレースホルダーは、信頼できるバックエンド上で置き換え、出力用には強力で一意のパスワードを使用してください。順序を明示的に指定しない場合、入力ファイルはファイル名の英数字順に並べられます。input_passwords も同じ順序で指定するか、ドキュメントの並べ替えオプションを使用してください。
保存済みの非公開 S3 バケット用 Template 認証情報を作成し、YOUR_AWS_CREDENTIALS をその認証情報の名前に置き換えてください。この例では、暗号化された結合済み PDF のみをエクスポートします。bucket-default は、公開オブジェクト ACL を要求しないための設定です。バケットポリシーも非公開のままにする必要があります。以下のパスは、セットアップガイドのポリシープレフィックス
uploads/ の配下にあります。このプレフィックスを変更する場合は、ポリシーとパスを併せて更新してください。パスワードをブラウザーのコード、公開リポジトリ、ログに含めないでください。
{
"steps": {
"merge": {
"use": {
"steps": [":original"],
"bundle_steps": true
},
"robot": "/document/merge",
"input_passwords": ["FIRST_INPUT_PASSWORD", "SECOND_INPUT_PASSWORD"],
"output_password": "REPLACE_WITH_A_STRONG_UNIQUE_PASSWORD",
"result": true
},
"exported": {
"use": "merge",
"robot": "/s3/store",
"credentials": "YOUR_AWS_CREDENTIALS",
"acl": "bucket-default",
"path": "uploads/merged/${unique_prefix}/${file.url_name}"
}
}
}
出力パスワードが適用されるのは結合済み PDF であり、アップロードされた元のファイルや、データのすべてのコピーではありません。入力と処理結果の両方へのアクセスを制限し、出力パスワードはドキュメントとは別に共有してください。脆弱なパスワードや漏えいしたパスワードでは、実効性のある保護は得られません。
まとめ
最新の Robotのご紹介は以上です。ほかにも、まもなくご紹介できるものがいくつかあります。Transloadit に関する今後の更新情報を受け取るには、以下の Dev Times (English) にご登録ください。
