Skip to content

TASK: Expose MFA enrollment and challenge HTTP APIs #164

Closed
1 of 1 issue completed
Closed

Description

@ramioooz

Type: Task
Epic: MFA Provider Service
Slice: Slice 4 - MFA Provider
Service: mfa-service
Priority: P0

Parent story: #50

Objective

Expose the existing MFA enrollment and challenge application services through a versioned internal HTTP adapter without moving security policy into the transport layer.

Scope

  • Add authenticated internal endpoints for TOTP enrollment, challenge creation, and challenge verification.
  • Map request bodies to application commands and application results to stable response DTOs.
  • Return Problem Details for validation, expired, exhausted, not-found, and conflict outcomes.
  • Add OpenAPI operation documentation and representative examples.
  • Add web-layer tests for success, validation, expiry/attempt failures, not-found, and idempotency/conflict behavior.
  • Add repeatable local/SIT verification instructions without committing secrets.

Boundaries

  • Keep provider and enrollment/challenge state behind existing application ports.
  • Do not add database persistence or external identity-provider integration in this task.
  • Do not expose secret material in response bodies or logs.
  • Keep the API internal and suitable for later gateway authorization.

Definition of Done

  • The HTTP adapter is covered by focused tests.
  • ./mvnw verify, Helm validation, and container smoke verification pass.
  • README and Insomnia documentation describe the endpoints.
  • The PR links this task and parent story STORY: Implement TOTP enrollment and verification #50 and is opened ready for review.

Activity

  1. self-assigned this
    on Aug 30, 2026
  2. added theissue type on Aug 30, 2026
  3. ramioooz commented on Aug 30, 2026

    @ramioooz
    MemberAuthor

    Authentication-boundary implementation PR is ready for review. PR: digital-bank-java/mfa-service#3

  4. ramioooz commented on Sep 1, 2026

    @ramioooz
    MemberAuthor

    Completed by merged MFA Service PRs #3 and #4. The authenticated MFA HTTP resources and principal binding are implemented; child task #168 is closed with evidence.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions