microg / microg/GmsCore

NFC‑based CIE ID authentication fails on LineageOS for microG (Fairphone 3)

Open
#3,093 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug
Dominant language
Java
Stars
14.6k
Forks
3.2k
Avg merge
12d 11h
Merged PRs (30d)
4

Description

Description:
A user reports that the Italian government CIE ID app (it.pagopa.io.app) partially works on a Fairphone 3 running LineageOS for microG (build 22.2-20251010-microG-NO-PI-PATCH-FP3).

The app launches and can read the ID card via NFC the first time (card is recognized and “success” is shown).
Subsequent authorisation attempts (which require a second NFC read) stall: the request never completes, no notification is shown, and the UI remains stuck.
The issue persists after updating microG Services and microG Companion to version 0.3.10 (via F‑Droid) and rebooting.

Environment:

Device: Fairphone 3
ROM: LineageOS for microG (downloaded from https://download.lineage.microg.org/FP3/)
microG version: Services 0.3.10, Companion 0.3.10
App version: latest from Google Play (as of the report)

Observed behavior:

First NFC load of the CIE ID card succeeds.
When trying to authorise access (second NFC read), the app loops and never returns a success/failure response.

Expected behavior:
The app should read the card again and display an in‑app “success” (or failure) notification, completing the authorisation flow.

Possible causes to investigate:

Compatibility issue between the app’s Play Services checks and the microG implementation on this unofficial LineageOS build.
NFC handling differences in the custom ROM or microG’s GMS core libraries.
Potential missing permissions or signature verification that affect the second NFC transaction.

Requested assistance:
Any insight into whether this is a known microG limitation, a bug introduced in recent microG releases, or something that requires a specific tweak (e.g., Magisk module, additional permission grant) would be appreciated.

Additional notes: The user confirmed that the app works 100 % on tested microG devices according to Plexus reports, suggesting the problem may be specific to this ROM/build.

Contributor guide

No contributing guide indexed for this repository

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

The issue names no files, tests, or code entry points. Start by reproducing the second NFC authorization attempt on the listed Fairphone 3 and LineageOS for microG build, then inspect relevant logs and compare the first and second reads. Done means identifying whether the failure is in microG, the ROM, or the app integration and recording actionable evidence.

Written by the indexing model from the issue text.

Assessment

Tech stack
android, java
Domain
authentication, mobile
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.