Next.js と Transloadit
Client Component で Uppy を使用し、Auth Secret を公開せずに固定の Transloadit Template に署名する小さな App Router エンドポイントを用意します。
実行可能な処理設定
連携を構築
サーバールートが固定の Template に署名し、クライアントコンポーネントが各アップロードの前に署名済みパラメーターを Uppy に渡します。
- Transloadit の Template を作成し、その ID、Auth Key、Auth Secret をサーバーの環境変数に設定してください。
- ルートハンドラーを追加し、アプリケーションの他の部分と同じ認可チェックで保護してください。
- ページに UploadForm クライアントコンポーネントを表示し、ファイルを選択して Template を実行してください。
インストール
yarn add @uppy/core @uppy/dashboard @uppy/react @uppy/transloadit transloaditapp/api/transloadit/route.ts
import { NextResponse } from 'next/server'
import { Transloadit } from 'transloadit'
export async function POST() {
const authKey = process.env.TRANSLOADIT_KEY
const authSecret = process.env.TRANSLOADIT_SECRET
const templateId = process.env.TRANSLOADIT_TEMPLATE_ID
if (!authKey || !authSecret || !templateId) {
return NextResponse.json({ error: 'Server configuration is incomplete' }, { status: 500 })
}
const transloadit = new Transloadit({ authKey, authSecret })
const requestParams = {
auth: { expires: new Date(Date.now() + 5 * 60 * 1000).toISOString() },
template_id: templateId,
}
const { params, signature } = transloadit.calcSignature(requestParams)
return NextResponse.json(
{ params, signature },
{ headers: { 'Cache-Control': 'private, no-store' } },
)
}app/UploadForm.tsx
'use client'
import Uppy from '@uppy/core'
import TransloaditPlugin from '@uppy/transloadit'
import Dashboard from '@uppy/react/dashboard'
import { useEffect, useState } from 'react'
import '@uppy/core/css/style.min.css'
import '@uppy/dashboard/css/style.min.css'
export function UploadForm() {
const [uppy, setUppy] = useState<Uppy | null>(null)
useEffect(() => {
const instance = new Uppy().use(TransloaditPlugin, {
waitForEncoding: true,
async assemblyOptions() {
const response = await fetch('/api/transloadit', { method: 'POST' })
if (!response.ok) throw new Error('Could not authorize upload')
return response.json()
},
})
setUppy(instance)
return () => instance.destroy()
}, [])
return uppy == null ? null : <Dashboard uppy={uppy} />
}認証
- TRANSLOADIT_SECRET は、プレフィックスのないサーバー環境変数に保存してください。Next.js は、NEXT_PUBLIC_ プレフィックスが付いた変数をブラウザーバンドルに公開します。
- Route Handler は公式 Node SDK を使用して、有効期限を五分に設定した固定の Template ID に署名し、ブラウザーには params と署名のみを返します。
- 署名を返す前に、製品で必要なユーザー認可を必ず行い、ブラウザーから任意の Template ID や Step を受け付けないでください。
制限事項と運用上の注意点
- ブラウザーでは Auth Secret を保護できません。Signature の生成と認可チェックは、必ずサーバー専用のコードで行う必要があります。
- waitForEncoding は、処理が終わるまでアップロード UI を待機させます。長時間の処理には Assembly の通知を使用するか、後で Assembly を取得してください。
- この例では、固定された一つの Template の使用を許可します。動的フィールドは、署名対象のパラメーターに含める前に、サーバー側で検証する必要があります。
その他の連携