(2026年10月29日 追記:記事どおりに再現できるよう、必要なコードと手順を追加しました)
業務システムでは「ログインできる人なら誰でも何でもできる」では困ります。閲覧だけの人、ファイルを登録・編集する人、利用者を管理する人と、役割に応じてできる操作を分けるのが権限管理です。今回は、ロール(役割)による権限管理と、ログイン・権限を確認してからPDFを返す「認可つきダウンロード」を実装します。
前回の第4回:ログイン機能を入れるでは、nuxt-auth-utils でID・パスワードのログインを作り、APIをログイン必須にしました。今回はその上に「誰が何をしてよいか」を判定する仕組みを載せます。
「ダウンロードなんて、ファイルの置き場所のURLを画面に出すだけでは?」
結論から言うと、PDFは公開フォルダに置かず、必ず「ログインと権限を確認するAPI」を通して返すのが原則です。置き場所のURLを直接出すと、そのURLを知っている人なら誰でも(退職者や社外の人でも)開けてしまいます。この回では、認証(=あなたは誰か)と認可(=あなたはそれをしてよいか)を分けて考え、Nuxt 4 のサーバーAPIで実装します。
権限管理の設計:3つのロールと判定の場所
ロールとできること
| 操作 | 閲覧のみ(viewer) | 編集可(editor) | 管理者(admin) |
|---|---|---|---|
| 一覧・検索・ダウンロード | ○ | ○ | ○ |
| アップロード | × | ○ | ○ |
| ファイルの削除 | × | 自分が登録したものだけ | すべて |
| 利用者の追加・ロール変更・利用停止 | × | × | ○ |
第7回以降の編集機能(結合・分割、注釈など)も、editor 以上に許可する想定です。
判定はすべてサーバーで、ロールは毎回DBから読む
- 画面の出し分けは使い勝手のため:権限のないボタンを隠すのは親切ですが、防御にはなりません。APIを直接呼ばれても断れるよう、判定はサーバーで行います。
- ロールはCookieではなくDBの値で判定する:第4回のセッション(暗号化Cookie)にロールを入れて判定すると、管理者がロールを下げても、その人が再ログインするまで古い権限が使えてしまいます。リクエストのたびにDBから利用者を読み直すことで、変更がすぐに反映されます。
- 利用停止にしたら、ログイン中でも締め出す:第4回で「ログアウト後も古いCookieの値は有効期限まで使える」と書きました。DBの「利用中かどうか」を毎回確認することで、利用停止にした時点でAPIが使えなくなります。
📰 出典:OWASP Authorization Cheat Sheet
ロールを定義し、利用者テーブルに列を追加する
ロールの一覧と判定関数は、画面とサーバーの両方で使うため shared/utils/ に置きます。Nuxt 4 では、shared/utils/ 直下のファイルは画面側・サーバー側の両方で自動インポートされます。
📰 出典:Nuxt 公式ドキュメント shared ディレクトリ
shared/utils/roles.ts を新しく作ります(shared/utils フォルダも作ります)。
// shared/utils/roles.ts
/**
* ロール(役割)。画面(app/)とサーバー(server/)の両方で使う。
* - viewer:閲覧・ダウンロードのみ
* - editor:アップロード、自分が登録したファイルの削除(第7回以降は編集も)
* - admin :すべてのファイルの削除、利用者の管理
*/
export const ROLES = ['viewer', 'editor', 'admin'] as const
export type Role = (typeof ROLES)[number]
/** 画面表示用のロール名 */
export const ROLE_LABELS: Record<Role, string> = {
viewer: '閲覧のみ',
editor: '編集可',
admin: '管理者',
}
const ROLE_LEVEL: Record<Role, number> = { viewer: 1, editor: 2, admin: 3 }
/** role が required 以上の権限を持つか(admin は editor の操作もできる) */
export function hasRole(role: Role, required: Role): boolean {
return ROLE_LEVEL[role] >= ROLE_LEVEL[required]
}
server/db/schema.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/db/schema.ts
+++ b/server/db/schema.ts
@@ -1,4 +1,5 @@
import { index, integer, primaryKey, sqliteTable, text } from 'drizzle-orm/sqlite-core'
+import { ROLES } from '../../shared/utils/roles'
/** アップロードされたPDFのメタデータ(PDF本体はストレージ側に保存) */
export const files = sqliteTable('files', {
@@ -48,6 +49,10 @@ export const users = sqliteTable('users', {
displayName: text('display_name').notNull(),
/** hashPassword(scrypt)で作ったハッシュ値。平文のパスワードは保存しない */
passwordHash: text('password_hash').notNull(),
+ /** ロール(viewer / editor / admin)。shared/utils/roles.ts の ROLES と同じ値 */
+ role: text('role', { enum: ROLES }).notNull().default('viewer'),
+ /** false にするとログイン中のセッションも含めて利用できなくなる(退職・異動時など) */
+ isActive: integer('is_active', { mode: 'boolean' }).notNull().default(true),
/** 登録日時 */
createdAt: integer('created_at', { mode: 'timestamp' }).notNull(),
})
マイグレーションを生成したあと、第4回で作った最初の利用者を管理者にする1文を手で追記しました。新しい列の既定値は「閲覧のみ」なので、そのままでは管理者が誰もいなくなるためです。
npm run db:generate -- --name roles # server/db/migrations/0003_roles.sql ができる
できた server/db/migrations/0003_roles.sql に、次の変更を加えます(+ が追加、- が削除)。2行目の末尾に文の区切り(--> statement-breakpoint)を足してから、コメントと UPDATE 文を追記します。
--- a/server/db/migrations/0003_roles.sql
+++ b/server/db/migrations/0003_roles.sql
@@ -1,2 +1,4 @@
ALTER TABLE `users` ADD `role` text DEFAULT 'viewer' NOT NULL;--> statement-breakpoint
-ALTER TABLE `users` ADD `is_active` integer DEFAULT true NOT NULL;
\ No newline at end of file
+ALTER TABLE `users` ADD `is_active` integer DEFAULT true NOT NULL;--> statement-breakpoint
+-- 第4回で作った最初の利用者を管理者にする(手動で追記)
+UPDATE `users` SET `role` = 'admin' WHERE `id` = (SELECT `id` FROM `users` ORDER BY `created_at`, `id` LIMIT 1);
新しく環境を作る場合は、起動時に作る最初の利用者(server/plugins/initial-admin.ts)に role: 'admin' を指定するよう変更します。
server/plugins/initial-admin.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/plugins/initial-admin.ts
+++ b/server/plugins/initial-admin.ts
@@ -21,6 +21,7 @@ export default defineNitroPlugin(async () => {
id: randomUUID(),
loginId: initialAdminLoginId,
displayName: '管理者',
+ role: 'admin',
passwordHash: await hashPassword(initialAdminPassword),
createdAt: new Date(),
}).run()
サーバー側の認可ヘルパーを作る
server/utils/auth.ts を新しく作ります。
// server/utils/auth.ts
import type { H3Event } from 'h3'
import { eq } from 'drizzle-orm'
import { users } from '../db/schema'
/** リクエストしてきた利用者(DBの最新の状態) */
export interface CurrentUser {
id: string
loginId: string
displayName: string
role: Role
}
declare module 'h3' {
interface H3EventContext {
/** requireCurrentUser で1リクエストにつき1回だけDBから読む */
currentUser?: CurrentUser
}
}
/**
* ログイン中の利用者を、セッションのIDをもとに「DBから」取得する。
* - 未ログイン → 401
* - 利用者が削除・無効化されている → セッションを消して 401
* ロールはセッション(Cookie)ではなくDBの値を使うため、変更がすぐに反映される。
*/
export async function requireCurrentUser(event: H3Event): Promise<CurrentUser> {
if (event.context.currentUser) return event.context.currentUser
const session = await requireUserSession(event, { message: 'ログインしてください' })
const row = useDb()
.select({
id: users.id,
loginId: users.loginId,
displayName: users.displayName,
role: users.role,
isActive: users.isActive,
})
.from(users)
.where(eq(users.id, session.user.id))
.get()
if (!row || !row.isActive) {
await clearUserSession(event)
throw createError({ statusCode: 401, statusMessage: 'ログインしてください' })
}
const { isActive: _, ...user } = row
event.context.currentUser = user
return user
}
/** required 以上のロールを持つ利用者だけを通す(足りなければ 403) */
export async function requireRole(event: H3Event, required: Role): Promise<CurrentUser> {
const user = await requireCurrentUser(event)
if (!hasRole(user.role, required)) {
throw createError({ statusCode: 403, statusMessage: 'この操作を行う権限がありません' })
}
return user
}
/** ファイルを削除できるか:管理者はすべて、編集者は自分が登録したものだけ */
export function canDeleteFile(user: CurrentUser, file: { uploadedBy: string | null }): boolean {
if (user.role === 'admin') return true
return user.role === 'editor' && file.uploadedBy === user.id
}
- 401 は「ログインしていない(誰か分からない)」、403 は「誰かは分かったが、その操作は許可されていない」です。
- 読み込んだ利用者は
event.context(=1回のリクエストの間だけ使える入れ物)に入れ、同じリクエスト内でDBを何度も読まないようにしています。 - 第4回の
server/middleware/auth.tsもrequireCurrentUserを呼ぶように変えます。これで、利用停止された人はすべてのAPIで 401 になります。
server/middleware/auth.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/middleware/auth.ts
+++ b/server/middleware/auth.ts
@@ -10,6 +10,6 @@ const PUBLIC_API_PATHS = new Set([
export default defineEventHandler(async (event) => {
const path = getRequestURL(event).pathname
if (!path.startsWith('/api/') || PUBLIC_API_PATHS.has(path)) return
- // セッションに user が無ければ 401 を投げる
- await requireUserSession(event, { message: 'ログインしてください' })
+ // 未ログイン・無効化された利用者は 401。結果は event.context.currentUser に入る
+ await requireCurrentUser(event)
})
各APIの先頭では、必要なロールを1行で宣言します。
// server/api/files.get.ts(一覧)
const user = await requireRole(event, 'viewer')
// server/api/files.post.ts(アップロード)
const user = await requireRole(event, 'editor')
// server/api/users.post.ts(利用者の追加)
await requireRole(event, 'admin')
一覧APIは各行に canDelete(この利用者が削除できるか)を付けて返すようにします。画面は削除ボタンを出すかどうかを自分で判定せず、サーバーの判定結果に従います。
server/api/files.get.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/api/files.get.ts
+++ b/server/api/files.get.ts
@@ -3,6 +3,7 @@ import { fileTags, files, tags, users } from '../db/schema'
/** ファイル一覧:キーワード・タグ・期間で絞り込み、20件ずつページング */
export default defineEventHandler(async (event) => {
+ const user = await requireRole(event, 'viewer')
// 1. クエリ文字列を zod で検証(不正なら 400)
const parsed = await getValidatedQuery(event, (query) => fileListQuerySchema.safeParse(query))
if (!parsed.success) {
@@ -46,6 +47,7 @@ export default defineEventHandler(async (event) => {
isEncrypted: files.isEncrypted,
// 登録者は users と結合して表示名を返す(第3回までのファイルは null)
uploadedBy: users.displayName,
+ uploadedById: files.uploadedBy,
createdAt: files.createdAt,
})
.from(files)
@@ -72,7 +74,12 @@ export default defineEventHandler(async (event) => {
}
return {
- items: rows.map((r) => ({ ...r, tags: tagsByFile.get(r.id) ?? [] })),
+ // 登録者のIDは返さず、「この利用者が削除できるか」だけを返す(画面のボタン表示用)
+ items: rows.map(({ uploadedById, ...r }) => ({
+ ...r,
+ tags: tagsByFile.get(r.id) ?? [],
+ canDelete: canDeleteFile(user, { uploadedBy: uploadedById }),
+ })),
total,
page,
perPage: FILES_PER_PAGE,
server/api/files.post.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/api/files.post.ts
+++ b/server/api/files.post.ts
@@ -3,8 +3,8 @@ import { inArray } from 'drizzle-orm'
import { fileTags, files, tags } from '../db/schema'
export default defineEventHandler(async (event) => {
- // ログイン中の利用者(server/middleware/auth.ts で確認済み。ここでは user を取り出すために呼ぶ)
- const { user } = await requireUserSession(event)
+ // アップロードは編集者(editor)以上。閲覧のみ(viewer)は 403
+ const user = await requireRole(event, 'editor')
const { maxUploadBytes } = useRuntimeConfig(event)
// 1. 本文を読み込む前に Content-Length で大きすぎるリクエストを断る
画面のロール表示もDBの値にそろえる
画面側の useUserSession() が読むセッション情報(/api/_auth/session)にも、DBの最新のロールを反映させます。nuxt-auth-utils には、セッションを返す直前に処理を差し込める sessionHooks があります。
server/plugins/session.ts を新しく作ります。
// server/plugins/session.ts
/**
* 画面側の useUserSession() がセッションを読むとき(/api/_auth/session)に、
* ロールと表示名をDBの最新の値で上書きして返す。無効化された利用者はログアウト扱いにする。
* ※ Cookie の中身は書き換えない。サーバー側の判定は常に requireCurrentUser(DB)で行う
*/
export default defineNitroPlugin(() => {
sessionHooks.hook('fetch', async (session, event) => {
const user = await requireCurrentUser(event)
session.user = { id: user.id, loginId: user.loginId, displayName: user.displayName, role: user.role }
})
})
📰 出典:nuxt-auth-utils(GitHub・README Extend Session)
利用停止された人の場合はここで 401 になり、画面側では「未ログイン」として扱われてログイン画面へ移動します。
セッションに入れる利用者情報の型(第4回の shared/types/auth.d.ts)にロールを足し、ログインAPIでロールを入れます。利用停止の人はログインできないようにします。
shared/types/auth.d.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/shared/types/auth.d.ts
+++ b/shared/types/auth.d.ts
@@ -1,10 +1,14 @@
// nuxt-auth-utils のセッションに入れる利用者情報の型。
// セッションは暗号化Cookie(上限4096バイト)に入るため、識別に必要な最小限だけを持つ
+import type { Role } from '../utils/roles'
+
declare module '#auth-utils' {
interface User {
id: string
loginId: string
displayName: string
+ /** 画面の表示切り替え用。サーバー側の判定には使わない(DBの値を使う) */
+ role: Role
}
interface UserSession {
loggedInAt: string
server/api/auth/login.post.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/api/auth/login.post.ts
+++ b/server/api/auth/login.post.ts
@@ -13,14 +13,14 @@ export default defineEventHandler(async (event) => {
// 2. 利用者を探し、パスワードを照合(IDが無い場合もダミーで照合して時間を揃える)
const user = useDb().select().from(users).where(eq(users.loginId, loginId)).get()
const ok = await verifyPassword(user?.passwordHash ?? await getDummyPasswordHash(), password)
- if (!user || !ok) {
+ if (!user || !ok || !user.isActive) {
// 「IDが違う」「パスワードが違う」を区別しない
throw createError({ statusCode: 401, statusMessage: 'ログインIDまたはパスワードが違います' })
}
// 3. セッションを作り直して保存(以前のセッション内容は引き継がない)
await replaceUserSession(event, {
- user: { id: user.id, loginId: user.loginId, displayName: user.displayName },
+ user: { id: user.id, loginId: user.loginId, displayName: user.displayName, role: user.role },
loggedInAt: new Date().toISOString(),
})
return { ok: true }
認可つきダウンロードAPI
server/api/files/[id]/download.get.ts を新しく作ります(server/api/files/[id] フォルダも作ります。[id] の部分がURLの値になります)。
// server/api/files/[id]/download.get.ts
import { eq } from 'drizzle-orm'
import { files } from '../../../db/schema'
/** PDFのダウンロード:ログイン中の利用者(viewer 以上)だけに、ストリームで返す */
export default defineEventHandler(async (event) => {
// 1. 認可(全ロールが閲覧可。ロールを絞るならここを変える)
await requireRole(event, 'viewer')
// 2. ファイルを探す(IDの形式違い・存在しないIDはどちらも 404)
const id = await getFileIdParam(event)
const file = useDb().select().from(files).where(eq(files.id, id)).get()
if (!file) {
throw createError({ statusCode: 404, statusMessage: 'ファイルが見つかりません' })
}
// 3. ストレージから読み出す。本体が無ければ 404(DBとストレージの不整合)
let stream
try {
stream = await useFileStorage().getStream(file.storageKey)
} catch {
throw createError({ statusCode: 404, statusMessage: 'ファイルが見つかりません' })
}
// 4. ヘッダーを付けて返す。inline=1 ならブラウザ内で表示、既定は保存
const inline = getQuery(event).inline === '1'
setResponseHeaders(event, {
'Content-Type': 'application/pdf',
'Content-Length': String(file.size),
'Content-Disposition': contentDisposition(file.originalName, inline ? 'inline' : 'attachment'),
'X-Content-Type-Options': 'nosniff',
// 認証が必要な内容なので、共有キャッシュ(プロキシ等)に保存させない
'Cache-Control': 'private, no-store',
})
return sendStream(event, stream)
})
- IDは zod で UUID 形式か確認してからDBを引きます(
getFileIdParam。形式違いも「見つかりません」として 404)。保存先のパスはDBのstorageKeyから作り、URLの値をそのままファイルパスに使いません。 - ストリームで返す:
sendStreamは、ファイルをメモリに全部読み込まずに少しずつ送る h3 の関数です。数十MBのPDFでもサーバーのメモリを圧迫しにくくなります。 - 本体が消えていたら 404:ローカル保存の
getStreamを「先にファイルを開いてからストリームを作る」形に変え、存在しない場合はここで例外になるようにします。
ID の確認に使う getFileIdParam は server/utils/file-id.ts に置きます。server/utils/file-id.ts を新しく作ります。
// server/utils/file-id.ts
import { z } from 'zod'
/** ルートパラメータ [id] の検証ルール(ファイルIDは UUID) */
export const fileIdParamsSchema = z.object({
id: z.uuid(),
})
/** [id] を検証して返す。形式が違えば 404(存在しないIDと同じ扱いにする) */
export async function getFileIdParam(event: Parameters<typeof getValidatedRouterParams>[0]): Promise<string> {
const parsed = await getValidatedRouterParams(event, (p) => fileIdParamsSchema.safeParse(p))
if (!parsed.success) {
throw createError({ statusCode: 404, statusMessage: 'ファイルが見つかりません' })
}
return parsed.data.id
}
server/utils/storage/local.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/utils/storage/local.ts
+++ b/server/utils/storage/local.ts
@@ -1,5 +1,4 @@
-import { createReadStream } from 'node:fs'
-import { mkdir, rm, writeFile } from 'node:fs/promises'
+import { mkdir, open, rm, writeFile } from 'node:fs/promises'
import { resolve, sep } from 'node:path'
import type { Readable } from 'node:stream'
import type { StorageAdapter } from './types'
@@ -24,7 +23,9 @@ export function createLocalStorage(baseDir: string): StorageAdapter {
await writeFile(pathOf(key), data, { flag: 'wx' })
},
async getStream(key: string): Promise<Readable> {
- return createReadStream(pathOf(key))
+ // 先にファイルを開く。存在しなければここで例外になり、呼び出し側で 404 にできる
+ const handle = await open(pathOf(key), 'r')
+ return handle.createReadStream()
},
async delete(key: string): Promise<void> {
await rm(pathOf(key), { force: true })
📰 出典:h3 公式ドキュメント Response utils(sendStream)
日本語のファイル名のままダウンロードさせる
server/utils/content-disposition.ts を新しく作ります。
// server/utils/content-disposition.ts
/**
* ダウンロード用の Content-Disposition ヘッダー値を作る。
* - filename*=UTF-8''… … 日本語などを含む本来のファイル名(RFC 6266 / RFC 8187 形式)
* - filename="…" … 古いクライアント向けの予備(ASCII 以外や " \ は _ に置き換え)
*/
export function contentDisposition(fileName: string, type: 'attachment' | 'inline' = 'attachment'): string {
// eslint-disable-next-line no-control-regex
const fallback = fileName.replace(/[^\x20-\x7e]|["\\]/g, '_')
// encodeURIComponent がエンコードしない ' ( ) * もエンコードする
const encoded = encodeURIComponent(fileName).replace(/['()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`)
return `${type}; filename="${fallback}"; filename*=UTF-8''${encoded}`
}
HTTPのヘッダーには日本語をそのまま書けないため、filename*=UTF-8''… の形でURLエンコードしたファイル名を渡します。古いクライアント向けに、ASCII文字だけの filename="…" も並べて書くのが一般的です。
📰 出典:RFC 6266(HTTPにおけるContent-Dispositionの使用)
削除API:ロールと「所有者」の両方で判定する
server/api/files/[id].delete.ts を新しく作ります。
// server/api/files/[id].delete.ts
import { eq } from 'drizzle-orm'
import { files } from '../../db/schema'
/** ファイルの削除:管理者はすべて、編集者は自分が登録したものだけ */
export default defineEventHandler(async (event) => {
const user = await requireRole(event, 'editor')
const id = await getFileIdParam(event)
const db = useDb()
const file = db.select().from(files).where(eq(files.id, id)).get()
if (!file) {
throw createError({ statusCode: 404, statusMessage: 'ファイルが見つかりません' })
}
if (!canDeleteFile(user, file)) {
throw createError({ statusCode: 403, statusMessage: 'このファイルを削除する権限がありません' })
}
// DBの行を消してから本体を消す(file_tags は外部キーの cascade で消える)
db.delete(files).where(eq(files.id, id)).run()
await useFileStorage().delete(file.storageKey)
setResponseStatus(event, 204)
return null
})
「editor 以上か」というロールの確認だけでなく、「そのファイルを登録したのは本人か」というデータ単位の確認もしています。ロールだけで判定すると、編集者同士で他人のファイルを消せてしまいます。
利用者管理(管理者のみ)
管理者が利用者を追加・変更するAPIと画面も用意します。
| API | 内容 |
|---|---|
GET /api/users | 利用者の一覧(パスワードのハッシュ値は返さない) |
POST /api/users | 利用者の追加。初期パスワードは12文字以上、ログインIDの重複は 409 |
PATCH /api/users/[id] | ロールの変更、利用停止・再開。自分自身は変更できない(管理者不在を防ぐ) |
入力の検証ルールをまとめた server/utils/user-input.ts と、3つのAPIを新しく作ります(server/api/users フォルダも作ります)。
// server/utils/user-input.ts
import { z } from 'zod'
/** 利用者の追加(管理者のみ) */
export const createUserBodySchema = z.object({
loginId: z.string().trim().min(1).max(64).regex(/^[\w.@-]+$/, '英数字と . _ @ - のみ'),
displayName: z.string().trim().min(1).max(50),
password: z.string().min(12).max(128),
role: z.enum(ROLES),
})
/** 利用者の変更(管理者のみ)。ロールの変更と、利用停止・再開 */
export const updateUserBodySchema = z.object({
role: z.enum(ROLES).optional(),
isActive: z.boolean().optional(),
}).refine((v) => v.role !== undefined || v.isActive !== undefined, { message: '変更内容がありません' })
export const userIdParamsSchema = z.object({ id: z.uuid() })
// server/api/users.get.ts
import { asc } from 'drizzle-orm'
import { users } from '../db/schema'
/** 利用者の一覧(管理者のみ)。パスワードのハッシュ値は返さない */
export default defineEventHandler(async (event) => {
await requireRole(event, 'admin')
return useDb()
.select({
id: users.id,
loginId: users.loginId,
displayName: users.displayName,
role: users.role,
isActive: users.isActive,
createdAt: users.createdAt,
})
.from(users)
.orderBy(asc(users.createdAt), asc(users.id))
.all()
})
// server/api/users.post.ts
import { randomUUID } from 'node:crypto'
import { eq } from 'drizzle-orm'
import { users } from '../db/schema'
/** 利用者の追加(管理者のみ) */
export default defineEventHandler(async (event) => {
await requireRole(event, 'admin')
const body = await readValidatedBody(event, (b) => createUserBodySchema.safeParse(b))
if (!body.success) {
throw createError({ statusCode: 400, statusMessage: '入力内容が正しくありません(パスワードは12文字以上)' })
}
const { loginId, displayName, password, role } = body.data
const db = useDb()
if (db.select({ id: users.id }).from(users).where(eq(users.loginId, loginId)).get()) {
throw createError({ statusCode: 409, statusMessage: 'このログインIDはすでに使われています' })
}
const id = randomUUID()
db.insert(users).values({
id,
loginId,
displayName,
passwordHash: await hashPassword(password),
role,
createdAt: new Date(),
}).run()
setResponseStatus(event, 201)
return { id, loginId, displayName, role }
})
// server/api/users/[id].patch.ts
import { eq } from 'drizzle-orm'
import { users } from '../../db/schema'
/** 利用者のロール変更・利用停止(管理者のみ)。自分自身は変更できない */
export default defineEventHandler(async (event) => {
const admin = await requireRole(event, 'admin')
const params = await getValidatedRouterParams(event, (p) => userIdParamsSchema.safeParse(p))
const body = await readValidatedBody(event, (b) => updateUserBodySchema.safeParse(b))
if (!params.success) {
throw createError({ statusCode: 404, statusMessage: '利用者が見つかりません' })
}
if (!body.success) {
throw createError({ statusCode: 400, statusMessage: '入力内容が正しくありません' })
}
// 管理者が自分の権限を外して、管理者が誰もいなくなる事故を防ぐ
if (params.data.id === admin.id) {
throw createError({ statusCode: 400, statusMessage: '自分自身のロール・状態は変更できません' })
}
const db = useDb()
const result = db.update(users).set(body.data).where(eq(users.id, params.data.id)).run()
if (result.changes === 0) {
throw createError({ statusCode: 404, statusMessage: '利用者が見つかりません' })
}
return { id: params.data.id, ...body.data }
})
画面 app/pages/admin/users.vue を新しく作ります(app/pages/admin フォルダも作ります)。利用者の一覧で、ロールの切り替えと利用停止・再開ができ、下のフォームで利用者を追加できます。
app/pages/admin/users.vue の全文(88行)
<!-- app/pages/admin/users.vue -->
<script setup lang="ts">
useHead({ title: '利用者管理 | PDF管理システム' })
definePageMeta({ requiredRole: 'admin' })
const { user: me } = useUserSession()
const { data: users, refresh } = await useFetch('/api/users')
const form = reactive({ loginId: '', displayName: '', password: '', role: 'viewer' as Role })
const message = ref('')
function errorMessage(err: unknown, fallback: string): string {
return (err as { data?: { statusMessage?: string } }).data?.statusMessage ?? fallback
}
async function addUser() {
message.value = ''
try {
await $fetch('/api/users', { method: 'POST', body: form })
Object.assign(form, { loginId: '', displayName: '', password: '', role: 'viewer' })
message.value = '追加しました'
await refresh()
} catch (err) {
message.value = errorMessage(err, '追加に失敗しました')
}
}
async function update(id: string, body: { role?: Role, isActive?: boolean }) {
message.value = ''
try {
await $fetch(`/api/users/${id}`, { method: 'PATCH', body })
await refresh()
} catch (err) {
message.value = errorMessage(err, '変更に失敗しました')
}
}
function onRoleChange(id: string, e: Event) {
update(id, { role: (e.target as HTMLSelectElement).value as Role })
}
</script>
<template>
<section>
<h1>利用者管理</h1>
<p v-if="message">{{ message }}</p>
<table class="users">
<thead>
<tr><th>ログインID</th><th>表示名</th><th>ロール</th><th>状態</th></tr>
</thead>
<tbody>
<tr v-for="u in users" :key="u.id">
<td>{{ u.loginId }}</td>
<td>{{ u.displayName }}</td>
<td>
<select :value="u.role" :disabled="u.id === me?.id" @change="onRoleChange(u.id, $event)">
<option v-for="r in ROLES" :key="r" :value="r">{{ ROLE_LABELS[r] }}</option>
</select>
</td>
<td>
{{ u.isActive ? '利用中' : '停止中' }}
<button v-if="u.id !== me?.id" type="button" @click="update(u.id, { isActive: !u.isActive })">
{{ u.isActive ? '利用停止' : '再開' }}
</button>
</td>
</tr>
</tbody>
</table>
<h2>利用者を追加</h2>
<form class="add" @submit.prevent="addUser">
<label>ログインID <input v-model="form.loginId" required maxlength="64"></label>
<label>表示名 <input v-model="form.displayName" required maxlength="50"></label>
<label>初期パスワード(12文字以上) <input v-model="form.password" type="password" autocomplete="new-password" required minlength="12" maxlength="128"></label>
<label>ロール
<select v-model="form.role">
<option v-for="r in ROLES" :key="r" :value="r">{{ ROLE_LABELS[r] }}</option>
</select>
</label>
<button type="submit">追加</button>
</form>
</section>
</template>
<style scoped>
.users { border-collapse: collapse; margin-bottom: 24px; }
.users th, .users td { border-bottom: 1px solid #e5e7eb; padding: 8px; text-align: left; }
.add { display: flex; flex-direction: column; gap: 8px; max-width: 360px; }
</style>
画面側は、ページごとに必要なロールを definePageMeta で宣言し、第4回のルートミドルウェアで確認します。
app/middleware/auth.global.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/app/middleware/auth.global.ts
+++ b/app/middleware/auth.global.ts
@@ -4,7 +4,7 @@
* ※ 画面を隠すだけの仕組み。データの保護はサーバー側(server/middleware/auth.ts)で行う
*/
export default defineNuxtRouteMiddleware((to) => {
- const { loggedIn } = useUserSession()
+ const { loggedIn, user } = useUserSession()
if (to.path === '/login') {
if (loggedIn.value) return navigateTo('/')
@@ -14,4 +14,9 @@ export default defineNuxtRouteMiddleware((to) => {
// ログイン後に元の画面へ戻れるよう、行き先をクエリで渡す
return navigateTo({ path: '/login', query: { redirect: to.fullPath } })
}
+ // ページごとに必要なロール(definePageMeta({ requiredRole: 'admin' }) など)
+ const required = to.meta.requiredRole
+ if (required && user.value && !hasRole(user.value.role, required)) {
+ throw createError({ statusCode: 403, statusMessage: 'このページを表示する権限がありません' })
+ }
})
requiredRole を型として使えるよう、shared/types/page-meta.d.ts を新しく作って PageMeta を拡張します。
// shared/types/page-meta.d.ts
import type { Role } from '../utils/roles'
// definePageMeta に requiredRole を書けるようにする
declare module '#app' {
interface PageMeta {
/** このページの表示に必要なロール(画面の出し分け用。データの保護はサーバー側で行う) */
requiredRole?: Role
}
}
export {}
一覧画面には「ダウンロード」リンク(通常の <a href> なのでCookieが送られます)と、canDelete が true の行だけに「削除」ボタンを付けます。アップロード画面は editor 以上に限り、ヘッダーにはロール名と「利用者管理」へのリンクを出します。
app/pages/files/index.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/pages/files/index.vue
+++ b/app/pages/files/index.vue
@@ -2,7 +2,8 @@
useHead({ title: 'ファイル一覧 | PDF管理システム' })
// useFetch はサーバー描画時にも実行され、結果がHTMLに含まれる
-const { data, status, error, currentForm, search, goToPage } = useFiles()
+const { data, status, error, refresh, currentForm, search, goToPage } = useFiles()
+const { user } = useUserSession()
// フォームの入力値。URL が変わったら(戻る・進む等)フォームも合わせる
const form = reactive(currentForm())
@@ -16,6 +17,17 @@ function clear() {
search({ q: '', tag: '', from: '', to: '' })
}
+async function remove(id: string, name: string) {
+ if (!confirm(`「${name}」を削除します。よろしいですか?`)) return
+ try {
+ await $fetch(`/api/files/${id}`, { method: 'DELETE' })
+ await refresh()
+ } catch (err: unknown) {
+ const statusMessage = (err as { data?: { statusMessage?: string } }).data?.statusMessage
+ alert(statusMessage ?? '削除に失敗しました')
+ }
+}
+
function formatSize(bytes: number): string {
if (bytes < 1024) return `${bytes} B`
if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`
@@ -35,7 +47,7 @@ function formatDate(value: string): string {
<template>
<section>
<h1>ファイル一覧</h1>
- <p><NuxtLink to="/files/upload">PDFをアップロード</NuxtLink></p>
+ <p v-if="user && hasRole(user.role, 'editor')"><NuxtLink to="/files/upload">PDFをアップロード</NuxtLink></p>
<form class="search" @submit.prevent="onSubmit">
<label>ファイル名 <input v-model="form.q" type="search" maxlength="100"></label>
@@ -61,6 +73,7 @@ function formatDate(value: string): string {
<th>ページ数</th>
<th>登録者</th>
<th>登録日時</th>
+ <th>操作</th>
</tr>
</thead>
<tbody>
@@ -76,6 +89,11 @@ function formatDate(value: string): string {
<td class="num">{{ row.pageCount }}</td>
<td>{{ row.uploadedBy ?? '—' }}</td>
<td>{{ formatDate(row.createdAt) }}</td>
+ <td class="actions">
+ <!-- 通常のリンクなので Cookie が送られ、サーバー側で認証・認可される -->
+ <a :href="`/api/files/${row.id}/download`">ダウンロード</a>
+ <button v-if="row.canDelete" type="button" @click="remove(row.id, row.originalName)">削除</button>
+ </td>
</tr>
</tbody>
</table>
@@ -94,5 +112,7 @@ function formatDate(value: string): string {
.files th, .files td { border-bottom: 1px solid #e5e7eb; padding: 8px; text-align: left; }
.files .num { text-align: right; }
.tag { display: inline-block; margin-right: 4px; padding: 0 6px; border-radius: 4px; background: #eef2ff; font-size: 0.85em; }
+.actions { white-space: nowrap; }
+.actions button { margin-left: 8px; }
.pager { display: flex; gap: 12px; align-items: center; margin-top: 16px; }
</style>
app/pages/files/upload.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/pages/files/upload.vue
+++ b/app/pages/files/upload.vue
@@ -1,5 +1,7 @@
<script setup lang="ts">
useHead({ title: 'アップロード | PDF管理システム' })
+// アップロードは編集者以上(サーバー側でも files.post.ts で確認している)
+definePageMeta({ requiredRole: 'editor' })
interface UploadResult {
id: string
app/layouts/default.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/layouts/default.vue
+++ b/app/layouts/default.vue
@@ -16,8 +16,9 @@ async function logout() {
<nav v-if="loggedIn" class="layout__nav">
<NuxtLink to="/">ホーム</NuxtLink>
<NuxtLink to="/files">ファイル一覧</NuxtLink>
- <NuxtLink to="/files/upload">アップロード</NuxtLink>
- <span class="layout__user">{{ user?.displayName }}</span>
+ <NuxtLink v-if="user && hasRole(user.role, 'editor')" to="/files/upload">アップロード</NuxtLink>
+ <NuxtLink v-if="user?.role === 'admin'" to="/admin/users">利用者管理</NuxtLink>
+ <span class="layout__user">{{ user?.displayName }}({{ user ? ROLE_LABELS[user.role] : '' }})</span>
<button type="button" class="layout__logout" @click="logout">ログアウト</button>
</nav>
</header>
動作確認の方法
npm run db:migrate # 0003_roles.sql(role / is_active 列、最初の利用者を管理者に)
npm run build
node --env-file=.env .output/server/index.mjs
curl で確かめるときは、利用者ごとに Cookie のファイルを分けます(ID・パスワードは例です)。
# 管理者でログインし、閲覧のみ(viewer1)・編集可(editor1)の利用者を追加する
curl -c admin.txt -H "Content-Type: application/json" -d '{"loginId":"admin","password":"change-this-password-123"}' http://localhost:3000/api/auth/login
curl -b admin.txt -H "Content-Type: application/json" -d '{"loginId":"viewer1","displayName":"閲覧太郎","password":"password-viewer1","role":"viewer"}' http://localhost:3000/api/users
curl -b admin.txt -H "Content-Type: application/json" -d '{"loginId":"editor1","displayName":"編集花子","password":"password-editor1","role":"editor"}' http://localhost:3000/api/users
curl -c viewer1.txt -H "Content-Type: application/json" -d '{"loginId":"viewer1","password":"password-viewer1"}' http://localhost:3000/api/auth/login
curl -c editor1.txt -H "Content-Type: application/json" -d '{"loginId":"editor1","password":"password-editor1"}' http://localhost:3000/api/auth/login
curl -i -b viewer1.txt -F "file=@test-files/sample.pdf" http://localhost:3000/api/files # 403
curl -b editor1.txt -F "file=@test-files/sample.pdf;filename=見積書.pdf" http://localhost:3000/api/files # 201(id を控える)
curl -i -b viewer1.txt -o downloaded.pdf http://localhost:3000/api/files/<id>/download # 200
curl -i -b viewer1.txt -X DELETE http://localhost:3000/api/files/<id> # 403
curl -i -b editor1.txt -X DELETE http://localhost:3000/api/files/<id> # 204
筆者の環境で、第4回のDBをマイグレーションしたうえで、管理者・閲覧のみ(viewer1)・編集可(editor1、editor2)の4人で curl により確認しました。
| 操作 | 結果 |
|---|---|
| マイグレーション後の最初の利用者 | role = admin |
| 管理者が利用者を追加/同じIDで再追加/短いパスワード | 201/409/400 |
| viewer・editor が利用者一覧・追加APIを呼ぶ | 403 |
| viewer がアップロード | 403 |
| editor1 がアップロード → 一覧 | 201。自分のファイルだけ canDelete: true |
| Cookieなしでダウンロード | 401 |
| viewer がダウンロード | 200。元ファイルと一致、日本語名は filename*=UTF-8''…、Cache-Control: private, no-store |
| ランダムなUUID/不正な形式のID | 404 |
| viewer が削除/editor2 が editor1 のファイルを削除 | 403/403 |
| editor1 が自分のファイルを削除 | 204。保存先の本体も消え、以後のダウンロードは 404 |
| 管理者が他人のファイルを削除 | 204 |
| DBにあるが本体が無いファイルをダウンロード | 404 |
| 管理者が自分自身のロールを変更 | 400 |
| editor1 を viewer に変更 → 同じCookieでアップロード | 403(再ログインなしで即反映) |
| viewer1 を利用停止 → 同じCookieで一覧/再ログイン | 401/401 |
viewer が /admin/users・/files/upload を開く | 403 |
画面の表示(viewer にはアップロードのリンクが出ない、管理者には「利用者管理」と削除ボタンが出る)は、サーバー描画のHTMLで確認しました。ブラウザでのボタン操作(削除の確認ダイアログ、ロールの切り替え)とダウンロードしたファイル名の表示は、筆者の環境では実施していません。
つまずきやすい点・セキュリティ上の注意
public/にPDFを置かない:public/のファイルは誰でもURLで取得できます。保存先は必ずAPIの外(今回はuploads/)にし、APIを通して返します。- 「IDが推測できないから安全」ではない:保存名もIDもUUIDで推測は困難ですが、URLは共有・転送されます。推測されにくさと認可チェックは別物で、両方必要です。
- 404 と 403 の使い分け:「存在しない」と「権限がない」を区別すると、存在確認の手がかりになる場合があります。今回は全ロールが全ファイルを閲覧できる前提のため区別していますが、部署ごとに見えるファイルを分けるなら、見えないファイルは 404 で返す設計も検討します。
- 削除は取り消せない:今回は即時削除です。誤削除に備えるなら「削除フラグを立てて一定期間後に消す(論理削除)」やバックアップとの組み合わせを検討します。
- 利用停止しても、ダウンロード済みのPDFは回収できない:権限管理が守れるのはシステムの中だけです。
発注者向けメモ:「誰が何をできるか」は表で決めておく
権限管理の工数は、ロールの数よりも「判定の単位」で大きく変わります。
| 判定の単位 | 例 | 工数・リスクの勘所 |
|---|---|---|
| ロール単位(今回) | 閲覧のみ/編集可/管理者 | 比較的シンプル。画面とAPIで同じ表を使えばよい |
| 所有者単位(今回の削除) | 自分が登録したものだけ消せる | データごとの確認が必要。一覧・詳細・操作のすべてで漏れなく判定する必要がある |
| 部署・案件単位 | 営業部のファイルは営業部だけが見られる | 組織・案件のマスタ、異動時の付け替え、一覧の絞り込みまで影響し、工数が大きく増える |
要件定義では、上の「ロールとできること」のような表を、発注者側で作っておくと話が早くなります。
- 操作 × 役割の表を作る:行に操作(閲覧・登録・削除・利用者管理など)、列に役割を並べ、○×を埋めます。
- 「見えてはいけないファイル」があるか:部署や案件で閲覧範囲を分ける必要があるなら、早い段階で伝えます。後から追加すると、一覧・検索・ダウンロードのすべてに手が入ります。
- 退職・異動時の手順:誰が、いつ、どの画面でアカウントを止めるかを運用として決めます。
- ダウンロードの記録が必要か:「誰がいつどのファイルを落としたか」の記録(操作ログ)は、監査で求められることがあります。本連載では扱っていないため、必要なら要件に入れます。
打ち合わせでは、次のように聞いてみてください。
- 「ダウンロードのURLを他の人に転送した場合、その人も開けてしまいますか?」
- 「権限の確認は画面だけでなく、APIでも行っていますか?」
- 「利用者を停止したら、ログイン中の人もすぐに使えなくなりますか?」
- 「部署ごとに見えるファイルを分けたくなった場合、どのくらいの改修になりますか?」
- 「誰がどのファイルをダウンロード・削除したかの記録は残りますか?」
まとめと次回予告
第5回では、ロールによる権限管理と、認可つきのダウンロードを実装しました。
- ロールは viewer/editor/admin の3段階。判定はサーバーで、ロールは毎回DBから読む
- 利用停止した利用者は、ログイン中でもすべてのAPIで 401 になる
- 削除はロールに加えて「登録した本人か」も確認する
- PDFは公開フォルダに置かず、認可を通したAPIからストリームで返す。日本語名は
filename*で渡す
次回は「ブラウザでPDFをプレビューする」です。pdfjs-dist を使ってPDFを画面上に描画し、日本語PDFを文字化けさせずに表示する設定(cMap)、ページ送り・拡大縮小を実装します。今回作ったダウンロードAPIを、プレビュー用の読み込み元として使います。
この連載の記事一覧
この記事は連載「Nuxtで作るPDF管理システム」の1回です。連載のほかの回は次のとおりです(連載の一覧ページ)。
- 【Nuxtで作るPDF管理システム 第0回】全体像とNuxt 4プロジェクトの土台づくり
- 【Nuxtで作るPDF管理システム 第1回】PDFをアップロードして安全に保存する
- 【Nuxtで作るPDF管理システム 第2回】ファイル情報をDBに持ち、一覧を表示する
- 【Nuxtで作るPDF管理システム 第3回】検索・絞り込み・ページングをつける
- 【Nuxtで作るPDF管理システム 第4回】ログイン機能を入れる
- 【Nuxtで作るPDF管理システム 第5回】権限管理と「認可つきダウンロード」(この記事)
- 【Nuxtで作るPDF管理システム 第6回】ブラウザでPDFをプレビューする
- 【Nuxtで作るPDF管理システム 第7回】PDFの結合と分割
- 【Nuxtで作るPDF管理システム 第8回】注釈・スタンプ・署名画像を貼る
- 【Nuxtで作るPDF管理システム 第9回】PDFフォーム(AcroForm)に入力する
- 【Nuxtで作るPDF管理システム 第10回】見積書・請求書をデータから生成する
- 【Nuxtで作るPDF管理システム 第11回】本番運用へ:S3への切り替えとデプロイ










コメント
コメント一覧 (2件)
[…] 前回の第5回:権限管理と「認可つきダウンロード」では、ロールによる権限管理と、ログイン・権限を確認してからPDFを返すダウンロードAPIを作りました。今回はそのAPIをプレビューの読み込み元として使います。 […]
[…] 権限管理と「認可つきダウンロード」 […]