whiteducksoftware / whiteducksoftware/flock

[1.0] Qualify one authenticated API and dashboard access path

Open
#430 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
Python
Stars
120
Forks
14
Avg merge
19h 32m
Merged PRs (30d)
8

Description

The existing authentication handlers are a starting point, but a supported access path must consistently bind authenticated callers to the identity and action permissions used by the API and dashboard.

Scope

  • Qualify one existing API-key/Bearer access path for service clients and the dashboard using the current authentication component.
  • Separate read permission from publish, invoke/control and destructive-operation permissions. Resolve identity once and reuse it in operation checks.
  • Record authentication outcomes, denials and privileged actions without credentials or sensitive payloads; provide a complete configuration example.

Acceptance criteria

  • A permitted caller, a read-only caller, an unrelated identity and an anonymous client receive the expected results for read and mutation operations.
  • Identity cannot be selected or elevated through ordinary request payloads; the dashboard uses the same authorized operations as HTTP clients.
  • Invalid credentials fail clearly, and audit records identify the actor and operation without exposing secrets.

Boundaries

OIDC/provider catalogs and sandboxing trusted in-process Python application code are outside this slice. WebSocket and other read-path enforcement have separate tickets under #280.

References

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading src/flock/components/server/auth/auth_component.py and src/flock/orchestrator/server_manager.py to understand the existing authentication component and server access flow. Trace how API and dashboard operations resolve identity and permissions. Done means one supported access path meets the listed read and mutation cases, rejects identity selection or elevation, and records safe authentication and privileged-action outcomes.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
api, authentication, authorization, backend
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.