문서가격블로그
문의하기
로그인무료로 가입하기
Back to Tech Articles

Node.js アプリケーションにおけるロールベースアクセス制御の実装

8월 21, 2025
# Misc

Daniel Hayes

Full-Stack Engineer · Leapcell

이 게시물은 English, 한국어 및 Deutsch에서도 볼 수 있습니다.
Cover of "Node.js アプリケーションにおけるロールベースアクセス制御の実装"

はじめに

現代の Web アプリケーションがますます相互接続される世界において、データセキュリティと整合性の確保は最優先事項です。アプリケーションの複雑さとユーザーベースが増大するにつれて、誰が何を行うことができるかを管理することは、重要な課題となります。すべてのユーザーが、その役割に関係なく、機密性の高い管理機能にアクセスしたり、重要なビジネスデータを変更したりできるシナリオを想像してみてください。このようなきめ細かな制御の欠如は、重大なセキュリティリスクをもたらすだけでなく、アプリケーションの信頼性と信頼性を損なうものでもあります。ここで、堅牢な権限管理が重要となり、ロールベースアクセス制御（RBAC）は、強力で広く採用されているソリューションとして登場します。RBAC は、ユーザーをロールにグループ化することで権限割り当ての複雑なタスクを簡素化し、管理をより管理しやすく、スケーラブルにします。この記事では、基本的な認証を超えて、安全で柔軟な承認レイヤーを提供する、Node.js アプリケーション内での RBAC の効果的な実装方法を探ります。

RBAC の基本を理解する

実装の詳細に入る前に、RBAC に関連するいくつかのコアコンセプトを明確にしましょう。

  • ユーザー: アプリケーションと対話する個人またはエンティティ。
  • ロール: ユーザーに割り当てられる権限のコレクション。ユーザーに直接権限を割り当てるのではなく、ユーザーには 1 つ以上のロールが割り当てられます。例としては、「管理者」、「編集者」、「閲覧者」、「モデレーター」などがあります。
  • 権限: アプリケーション内の原子的な権利または機能。これは、承認されたユーザーが実際に何を行うことができるかを定義します。例としては、「投稿の作成」、「自分の投稿の編集」、「任意のユーザーの削除」、「ダッシュボードの表示」などがあります。
  • リソース: 権限が適用されるエンティティまたはデータ。これは、API エンドポイント、データベースレコード、ファイル、またはその他のアプリケーションコンポーネントである可能性があります。
  • アクション: リソースに対して実行できる操作（例：読み取り、書き込み、更新、削除）。多くの場合、権限はアクションとリソースを組み合わせます（例：「posts の読み取り」、「users の更新」）。

RBAC の基本的な原則は、ロールに権限を割り当て、次にロールをユーザーに割り当てることです。この間接的な操作により、ロールの権限への変更が、そのロールに割り当てられているすべてのユーザーに自動的に適用されるため、権限管理が大幅に簡素化されます。

RBAC システムの設計

Node.js で RBAC を実装するには、通常、いくつかの主要なコンポーネントが必要です。

  1. データモデル: ユーザー、ロール、権限、およびそれらの関連付けを格納する方法が必要です。一般的なアプローチはリレーショナルデータベースを使用することですが、NoSQL データベースも実行可能です。
  2. 承認ミドルウェア: API リクエストをインターセプトし、ユーザーのロールを確認し、要求されたアクションを実行するために必要な権限があるかどうかを判断するロジックのピース。
  3. 権限定義: アプリケーション内で利用可能な権限を定義および管理するための明確な方法。

コード例による実際の実装

Express.js を使用した簡単な例を見ていきましょう。簡単にするために、ロールと権限をメモリに格納しますが、実際のアプリケーションではこれらはデータベースに存在します。

まず、ロールとその関連権限を定義しましょう。

// permissions.js
const PERMISSIONS = {
    VIEW_DASHBOARD: 'view_dashboard',
    CREATE_POST: 'create_post',
    EDIT_OWN_POST: 'edit_own_post',
    EDIT_ANY_POST: 'edit_any_post',
    DELETE_POST: 'delete_post',
    DELETE_USER: 'delete_user',
    VIEW_USERS: 'view_users',
};

const ROLES = {
    ADMIN: 'admin',
    EDITOR: 'editor',
    VIEWER: 'viewer',
};

const rolePermissions = {
    [ROLES.ADMIN]: [
        PERMISSIONS.VIEW_DASHBOARD,
        PERMISSIONS.CREATE_POST,
        PERMISSIONS.EDIT_ANY_POST,
        PERMISSIONS.DELETE_POST,
        PERMISSIONS.DELETE_USER,
        PERMISSIONS.VIEW_USERS,
    ],
    [ROLES.EDITOR]: [
        PERMISSIONS.VIEW_DASHBOARD,
        PERMISSIONS.CREATE_POST,
        PERMISSIONS.EDIT_OWN_POST,
    ],
    [ROLES.VIEWER]: [
        PERMISSIONS.VIEW_DASHBOARD,
    ],
};

module.exports = {
    PERMISSIONS,
    ROLES,
    rolePermissions,
};

次に、承認ミドルウェアを作成します。このミドルウェアは通常、認証後に実行され、req.user にはロールを含む認証済みユーザーの情報が含まれます。

// authMiddleware.js
const { rolePermissions } = require('./permissions');

function authorize(requiredPermissions) {
    return (req, res, next) => {
        // 実際のアプリケーションでは、req.user は認証ミドルウェアによって設定されます。
        // この例では、ロールを持つユーザーをシミュレートしましょう。
        const user = req.user || {
            id: 'someUserId',
            roles: [ 'editor' ] // 例: このユーザーは編集者です
        };

        if (!user || user.roles.length === 0) {
            return res.status(401).send('Authentication required.');
        }

        const userPermissions = new Set();
        user.roles.forEach(role => {
            if (rolePermissions[role]) {
                rolePermissions[role].forEach(permission => userPermissions.add(permission));
            }
        });

        const hasAllRequired = requiredPermissions.every(perm => userPermissions.has(perm));

        if (hasAllRequired) {
            next(); // ユーザーは必要なすべての権限を持っています。ルートハンドラーに進みます。
        } else {
            console.log(`User with roles ${user.roles.join(', ')} missing permissions: ${requiredPermissions.filter(perm => !userPermissions.has(perm)).join(', ')}`);
            return res.status(403).send('Forbidden: Insufficient permissions.');
        }
    };
}

module.exports = authorize;

次に、Express アプリケーションにこれを統合しましょう。

// app.js
const express = require('express');
const authorize = require('./authMiddleware');
const { PERMISSIONS, ROLES } = require('./permissions');

const app = express();
const port = 3000;

app.use(express.json());

// --- 認証のシミュレーション ---
// 実際のアプリでは、これは Passport.js または同様のミドルウェアになります
app.use((req, res, next) => {
    // デモンストレーションのために、ヘッダーに基づいて異なるユーザーをモックしましょう。
    const userRoleHeader = req.headers['x-user-role'];
    if (userRoleHeader) {
        req.user = {
            id: 'mockUser123',
            roles: userRoleHeader.split(',').map(r => r.trim())
        };
    } else {
        req.user = { id: 'anonymous', roles: [] }; // 認証されていない場合はロールなし
    }
    next();
});
// --- 認証のシミュレーション終了 ---

// 公開ルート
app.get('/', (req, res) => {
    res.send('Welcome to the application!');
});

// 管理ダッシュボード - 'view_dashboard' 権限が必要です
app.get('/admin/dashboard', authorize([PERMISSIONS.VIEW_DASHBOARD]), (req, res) => {
    res.send(`Admin Dashboard accessed by user: ${req.user.id} with roles: ${req.user.roles.join(', ')}`);
});

// 投稿の作成 - 'create_post' 権限が必要です
app.post('/posts', authorize([PERMISSIONS.CREATE_POST]), (req, res) => {
    res.status(201).send(`Post created by user: ${req.user.id}`);
});

// 投稿の編集 - 'edit_any_post' (管理者) または 'edit_own_post' (編集者) が必要です
// 注: より詳細な 'edit_own_post' は、req.user.id を投稿の作成者の ID と比較する必要があります。
// この例では、一般的な権限のみを確認します。
app.put('/posts/:id', authorize([PERMISSIONS.EDIT_ANY_POST]), (req, res) => {
    res.send(`Post ${req.params.id} updated by user: ${req.user.id}`);
});

// ユーザーの削除 - 'delete_user' 権限が必要です
app.delete('/users/:id', authorize([PERMISSIONS.DELETE_USER]), (req, res) => {
    res.send(`User ${req.params.id} deleted by user: ${req.user.id}`);
});

app.listen(port, () => {
    console.log(`Server listening at http://localhost:${port}`);
    console.log('Test with headers:');
    console.log(`  x-user-role: ${ROLES.ADMIN}`);
    console.log(`  x-user-role: ${ROLES.EDITOR}`);
    console.log(`  x-user-role: ${ROLES.VIEWER}`);
    console.log('  (Or no header for anonymous access)');
});

これをテストするには：

  1. node app.js を実行します。
  2. cURL や Postman などのツールを使用します。
    • GET /admin/dashboard
      • x-user-role: admin を使用: 200 OK
      • x-user-role: editor を使用: 200 OK
      • x-user-role: viewer を使用: 200 OK
      • ヘッダーなし: 401 Authentication required.
    • POST /posts
      • x-user-role: admin を使用: 201 Created
      • x-user-role: editor を使用: 201 Created
      • x-user-role: viewer を使用: 403 Forbidden
    • DELETE /users/123
      • x-user-role: admin を使用: 200 OK
      • x-user-role: editor を使用: 403 Forbidden

高度な考慮事項とアプリケーションシナリオ

上記の例は基本的な RBAC セットアップを提供します。実際のアプリケーションでは、より高度な機能が求められることがよくあります。

  • 動的権限: データベースに権限を保存することで、管理者はコードを変更せずにロールと権限のマッピングを変更できます。
  • リソースベースの権限（ABAC ハイブリッド）: たとえば、edit_own_post と edit_any_post です。これは、RBAC と属性ベースのアクセス制御（ABAC）を組み合わせることが多く、ロールだけでなく、ユーザーとリソースの属性（例：req.user.id === post.authorId）も確認します。
  • 権限の継承: ロールは他のロールから権限を継承する場合があります（例：「編集者」はすべての「閲覧者」権限を継承する可能性があります）。
  • キャッシュ: パフォーマンスのために、事前計算されたユーザー権限はメモリまたは Redis にキャッシュできます。
  • 専用ライブラリ: 複雑な RBAC ニーズには、権限定義、ルールエンジン、クエリビルダーなどのより堅牢な機能を提供する casl、accesscontrol、または rbac-a のようなライブラリを検討してください。
  • フロントエンド統合: フロントエンドは、適切な UI 要素（例：「編集」ボタンの表示/非表示）を表示するために、ユーザーが実行できるアクションを知る必要があることがよくあります。これは、専用の API エンドポイントを通じてユーザー権限を公開するか、初期ユーザーオブジェクトに含めることで達成できます。

RBAC は、ユーザー権限を定義済みのロールのセットにきれいに分類でき、権限の粒度が主にこれらのロールに沿っているアプリケーションに最も適しています。例としては、CMS プラットフォーム、さまざまな部門を持つ内部ツール、または顧客、販売者、管理者ロールを持つ e コマースサイトなどがあります。

結論

ロールベースアクセス制御の実装は、Node.js アプリケーションを保護するための重要なステップであり、単純な認証から、よりきめ細かく管理可能な承認スキームへと移行します。ロールを慎重に定義し、関連する権限を割り当て、効果的なミドルウェアを採用することにより、開発者は、承認されたユーザーのみが特定のリソースに対する特定の操作を実行できるようにすることができます。この構造化されたアプローチはセキュリティを強化するだけでなく、ユーザー権限の管理を簡素化し、アプリケーションをより堅牢でスケーラブルにします。

Share this article

HackerNews

More Posts from Leapcell

Popular Posts