PlayIntegrityFork/README.md

Play Integrity Fork

PIF forked to be more futureproof and develop more methodically

A Zygisk module which fixes "ctsProfileMatch" (SafetyNet) and "MEETS_DEVICE_INTEGRITY" (Play Integrity).

To use this module you must have one of the following (latest versions):

• Magisk with Zygisk enabled (and Enforce DenyList enabled if NOT also using Shamiko)
• KernelSU with ZygiskNext module installed
• APatch with ZygiskNext MOD module installed

About module

It injects a classes.dex file to modify a few fields in the android.os.Build class. Also, it creates a hook in the native code to modify system properties. These are spoofed only to Google Play Services' DroidGuard (SafetyNet/Play Integrity) service.

The purpose of the module is to avoid hardware attestation.

About 'custom.pif.json' file

You can fill out the included template example.pif.json from the module directory then rename it to custom.pif.json to spoof custom values to the GMS unstable process. It will be used instead of any included pif.json (none included currently).

As a general rule you can't use values from recent devices due to them only being allowed with full hardware backed attestation.

Older formatted custom.pif.json files from cross-forks and previous releases will be automatically migrated to the latest format.

A migration may also be performed manually with sh migrate.sh and custom.pif.json in the same directory, or from a file explorer app that supports script execution.

Resources

FAQ:

• PIF FAQ - Frequently Asked Questions (READ FIRST!)

Guides:

• How-To Guide - Info to help find build.prop files, then manually create and use a custom.pif.json
• Complete Noobs' Guide - A more in-depth basic explainer of the How-To Guide above
• UI Workflow Guide - Build/find, edit, and test custom.pif.json using PixelFlasher on PC
• Tasker PIF Testing Helper - Test custom.pif.json using Tasker on your device

Scripts:

• gen_pif_custom.sh - Script to generate a custom.pif.json from device dump build.prop files
• autopif.sh - Script to extract the latest working Xiaomi.eu fingerprint (though frequently banned) to test an initial setup
• pickaprint.sh - Script to help find a random working custom.pif.json (rarely banned) for long-term use
• install-random-fp.sh - Script to randomly switch between multiple working fingerprints found by the user

About 'custom.app_replace.list' file

You can customize the included default example.app_replace.list from the module directory then rename it to custom.app_replace.list to systemlessly replace any additional conflicting custom ROM spoof injection app paths to disable them.

Troubleshooting

Failing BASIC verdict

If you are failing basicIntegrity (SafetyNet) or MEETS_BASIC_INTEGRITY (Play Integrity) something is wrong in your setup. Recommended steps in order to find the problem:

• Disable all modules except this one
• Try a different (ideally known working) custom.pif.json

Some modules which modify system can trigger DroidGuard detection, never hook GMS processes.

Failing DEVICE verdict (on KernelSU/APatch)

• Disable ZygiskNext
• Reboot
• Enable ZygiskNext

Failing DEVICE verdict (on custom kernel/ROM)

• Check the kernel release string with command adb shell uname -r or uname -r
• If it's on the Known Banned Kernel List then inform your kernel developer/ROM maintainer to remove their branding for their next build
• You may also try a different custom kernel, or go back to the default kernel for your ROM, if available/possible

Play Protect/Store Certification and Google Wallet Tap To Pay Setup Security Requirements

Follow these steps:

• Reflash the module in your root manager app
• Clear Google Wallet cache (if you have it)
• Clear Google Play Store cache and data
• Clear Google Play Services (com.google.android.gms) cache and data (Optionally skip clearing data and wait some time, ~24h, for it to resolve on its own)
• Reboot

Note: Clearing Google Play Services app data will then require you to reset any WearOS devices paired to your device.

Read module logs

You can read module logs using one of these commands directly after boot:

adb shell "logcat | grep 'PIF/'" or su -c "logcat | grep 'PIF/'"

Add a "VERBOSE_LOGS" entry with a value of "0", "1", "2", "3" or "100" to your custom.pif.json to enable higher logging levels; "100" will dump all Build fields, and all the system properties that DroidGuard is checking.

Can this module pass MEETS_STRONG_INTEGRITY?

No.

About Play Integrity, SafetyNet is deprecated

You can read more here: Play Integrity API FAQ/Information - XDA Forums

Credits

Module scripts were adapted from those of kdrag0n/Displax's Universal SafetyNet Fix (USNF) module, please see the commit history of Displax's USNF Fork for proper attribution.