[BUG] Application role restrictions are ignored when using "Treat Tags As: Categories"

オープン 初心者向け
#1,626 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
78/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
laravel, php

調査の方向性

app/Http/Controllers/ItemController.php の ItemController::dash() から始め、categories ブランチを、すでに whereIn('role', $roles) でフィルタしている folders ブランチと比較してください。with('children', ...) クロージャ内の pinned() の隣に同じロール制約を追加し、ヘッダーがない場合に $roles がどのようにパースされるかを確認して、制限なしの項目が隠れないようにしてください。完了とは、ヘッダーに staff のみが含まれるユーザーがカテゴリ内で staff タイルだけを見えることです。上で説明した remote-groups ヘッダーで再現してください。

索引モデルが issue の本文から書いたものです。

説明

Description

When role-based authorization is enabled using AUTH_ROLES_ENABLE=true, Heimdall correctly supports assigning roles to individual application tiles.

However, when Treat Tags As is set to Categories, the configured application-level role restrictions are not enforced.

Applications assigned to a tag become visible on the dashboard regardless of whether the authenticated user belongs to the required group.

This appears to be a regression in authorization behavior depending on the selected dashboard layout.

Tags are only used to organize applications into categories. Assigning an application to a tag should not affect its existing role restrictions.

Environment

  • Deployment: Docker

  • Docker image: LinuxServer.io Heimdall

  • Image tag: latest (exact image reference to be confirmed)

  • Application version: To be confirmed from the running container

  • Source code analyzed: Heimdall v2.8.4

  • Authentication: External authentication with group information forwarded through HTTP headers

  • Role header: remote-groups

  • Role-based authorization: Enabled

  • Treat Tags As: Categories

Relevant example configuration:


AUTH_ROLES_ENABLE=true
AUTH_ROLES_HEADER=remote-groups
AUTH_ROLES_ADMIN=admin

The configuration and identifiers below illustrate a minimal reproduction scenario and do not contain production credentials or actual user information.

Minimal reproduction setup

Users and groups

Two regular users are provided by an external authentication system.

User A: Alice

Username: alice
remote-groups: staff

User B: Bob

Username: bob
remote-groups: operations

Neither user has the admin role.

Applications

Create two applications with different role restrictions:

Application Assigned role Pinned
Internal Wiki staff Yes
Infrastructure Monitoring operations Yes

Assign both applications to this tag.

Configure Heimdall to display tags as categories:

Settings → Treat Tags As → Categories

The tag is intended exclusively for organizing applications on the dashboard. It should not override or replace the roles assigned to individual applications.

Steps to reproduce

  1. Start Heimdall with role-based authorization enabled.

  2. Configure an external authentication system to forward the authenticated user's group memberships through the remote-groups header.

  3. Create two application tiles:

    • Internal Wiki, restricted to staff.

    • Infrastructure Monitoring, restricted to operations.

  4. Ensure both applications are pinned.

  5. Create a tag named Infrastructure and pin it.

  6. Assign both application tiles to the Infrastructure tag.

  7. Set Treat Tags As to Categories.

  8. Open Heimdall as a regular user whose remote-groups header contains only staff.

  9. Inspect the applications displayed under the Infrastructure category.

Expected behavior

The authenticated user's group memberships should determine which application tiles are visible, independently of the dashboard layout.

For Alice (remote-groups: staff), the dashboard should display:

Infrastructure
└── Internal Wiki

Infrastructure Monitoring must not be displayed because Alice does not have the operations role.

For Bob (remote-groups: operations), the dashboard should display:

Infrastructure
└── Infrastructure Monitoring

Internal Wiki must not be displayed because Bob does not have the staff role.

The category should only organize applications that the current user is permitted to see.

Actual behavior

Both applications are displayed under the Infrastructure category, regardless of the authenticated user's group memberships.

For Alice, the dashboard incorrectly displays:

Infrastructure
├── Internal Wiki
└── Infrastructure Monitoring  <-- Unexpected

For Bob, it incorrectly displays:

Infrastructure
├── Internal Wiki              <-- Unexpected
└── Infrastructure Monitoring

Application-level role restrictions are therefore not enforced when applications are rendered within categories.

Additionally, assigning a non-matching role to the tag itself does not prevent the applications from appearing.

For example, assigning the tag the role restricted-test-group, which neither user possesses, does not resolve the problem.

The issue is not that tags lack additional authorization capabilities. The issue is that existing application-level restrictions are ignored.

Technical analysis

The behavior appears to originate in:

app/Http/Controllers/ItemController.php

Specifically, within ItemController::dash().

In Heimdall v2.8.4, the relevant code in the role-enabled branch is:

$roles = explode(
    config('app.auth_roles_delimiter'),
    $request->header(config('app.auth_roles_header')) ?? ''
);

if ($treat_tags_as == 'categories') {
$data['categories'] = Item::whereHas('children')
->with('children', function ($query) {
$query->pinned()->orderBy('order', 'asc');
})
->pinned()
->orderBy('order', 'asc')
->get();
}

The authenticated user's roles are extracted into $roles, but they are not used in the query that retrieves the category's child applications.

The eager-loaded children relationship only applies the pinned scope and ordering.

Consequently, applications are retrieved without checking whether their assigned roles match the current user's roles.

In contrast, the Folders branch of the same controller contains an application role filter:

->whereIn('role', $roles)

This suggests that role filtering was omitted from the category-specific query.

Source:

https://github.com/linuxserver/Heimdall/blob/v2.8.4/app/Http/Controllers/ItemController.php

Impact

This issue causes unintended disclosure of application tiles to users who do not possess the required roles.

Potentially exposed information includes:

  • Application names

  • Application URLs

  • Application icons

  • The existence of internal services

  • Service organization and category membership

It also makes dashboard visibility restrictions dependent on the selected presentation mode.

An administrator may configure application roles correctly while being unaware that switching to the Categories layout effectively disables those visibility restrictions.

This report does not claim that authentication or authorization in the linked applications can be bypassed. The observed issue concerns the visibility of application entries within Heimdall.

Suggested resolution

Ensure that application-level role restrictions are applied when loading applications belonging to categories.

The existing authorization behavior should remain consistent across dashboard presentation modes.

Specifically:

  1. Retrieve the authenticated user's roles using the existing role-header mechanism.

  2. Apply the existing application role restrictions to applications loaded through category relationships.

  3. Ensure that unauthorized applications are not included in the rendered category contents.

  4. Preserve the use of tags as organizational elements without introducing mandatory tag-level authorization.

This report does not request additional permissions on tags or role inheritance from categories to applications.

It only requests that the existing application-level restrictions continue to be enforced when the dashboard is displayed using categories.

Additional information

The problem is reproducible with applications assigned to the same category but restricted to different groups.

Changing the tag's own role does not resolve the unauthorized visibility of its applications.

The relevant distinction is between:

  • Application role: Determines whether the user should see the application.

  • Tag/category: Determines where the application is displayed.

A presentation setting should not disable an existing visibility restriction.

The expected outcome is that users continue to see only applications matching their assigned roles, regardless of how those applications are organized on the dashboard.

主要言語
PHP
スター
9.4k
フォーク
626
平均マージ
13分
マージ済み PR(30日)
3

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

linuxserver/Heimdall のほかの issue

linuxserver/Heimdall の issue をすべて見る

似ている issue

PHP の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。