MENU

問い合わせ

    お問い合わせ


    【Nuxtで作るPDF管理システム 第5回】権限管理と「認可つきダウンロード」

    (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="…" も並べて書くのが一般的です。

    📰 出典:MDN Content-Disposition

    📰 出典: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/不正な形式のID404
    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回です。連載のほかの回は次のとおりです(連載の一覧ページ)。

    システム制作・運用・保守のお問い合わせはこちら

      お問い合わせ


      よかったらシェアしてね!
      • URLをコピーしました!
      • URLをコピーしました!

      この記事を書いた人

      株式会社THIRD HERO代表取締役 朝野貴朗
      Webシステム開発を中心に、toC向けサービスサイトの運営、ツール開発などを行ってまいりました。

      コメント

      コメント一覧 (2件)

      目次