Files
frida-interception-and-unpi…/android/android-disable-flutter-certificate-pinning.js
T

536 lines
27 KiB
JavaScript

/**************************************************************************************************
*
* This script hooks Flutter internal certificate handling, to trust our certificate (and ignore
* any custom certificate validation - e.g. pinning libraries) for all TLS connections.
*
* Unfortunately Flutter is shipped as native code with no exported symbols, so we have to do this
* by matching individual function signatures by known patterns of assembly instructions. In
* some cases, this goes further and uses larger functions as anchors - allowing us to find the
* very short functions correctly, where the patterns would otherwise have false positives.
*
* Flutter ships a separate engine build per mode: apps run with `flutter run` bundle the JIT
* 'debug' engine, while `flutter build --release` bundles a distinct AOT 'release' engine, built
* with LTO (and, on arm64, the LLVM machine outliner) so that the same functions compile to
* visibly different code. We therefore carry a separate set of patterns for each, and detect
* which engine is loaded at runtime.
*
* In release builds LTO also inlines X509_STORE_CTX_get_current_cert (a one-line accessor) into
* its callers, so there is no function left to call. Instead we locate the instruction that reads
* the field inside CertificateCallback and recover the struct offset from it, then read the
* certificate out of the store directly.
*
* The patterns here have been generated from every non-patch release of Flutter from v2.0.0
* to v3.44.0 (the latest at the time of writing). They may need updates for new versions
* in future.
*
* Currently this is limited to just Android, but in theory this can be expanded to iOS and
* desktop platforms in future.
*
* Source available at https://github.com/httptoolkit/frida-interception-and-unpinning/
* SPDX-License-Identifier: AGPL-3.0-or-later
* SPDX-FileCopyrightText: Tim Perry <tim@httptoolkit.com>
*
*************************************************************************************************/
(() => {
const PATTERNS = {
"android/x64": {
"dart::bin::SSLCertContext::CertificateCallback": {
"signatures": [
"41 57 41 56 41 54 53 48 83 ec 18 b8 01 00 00 00 83 ff 01 0f 84 ?? ?? ?? ?? 48 89 f3",
"41 57 41 56 53 48 83 ec 10 b8 01 00 00 00 83 ff 01 0f 84 ?? ?? ?? ?? 48 89 f3"
]
},
"X509_STORE_CTX_get_current_cert": {
"signatures": [
"48 8b 87 b8 00 00 00 c3",
"48 8b 47 60 c3",
"48 8b 87 a8 00 00 00 c3",
"48 8b 47 50 c3"
],
"anchor": "dart::bin::SSLCertContext::CertificateCallback"
},
"bssl::x509_to_buffer": {
"signatures": [
"41 57 41 56 53 48 83 ec 10 48 89 f0 49 89 fe 48 89 e6 48 83 26 00 48 89 c7 e8",
"41 56 53 50 48 89 f0 48 89 fb 48 89 e6 48 83 26 00 48 89 c7 e8 ?? ?? ?? ?? 85 c0 7e 1b",
"53 48 83 ec 10 48 89 f0 48 89 fb 48 8d 74 24 08 48 83 26 00 48 89 c7 e8 ?? ?? ?? ?? 85 c0",
"41 56 53 48 83 ec 18 48 89 f0 4? 89 f? 48 8d 74 24 08 48 83 26 00 48 89 c7 e8"
]
},
"i2d_X509": {
"signatures": [
"48 8d 15 ?? ?? ?? ?? e9",
"55 41 56 53 48 83 ec 70 48 85 ff 0f 84 ?? ?? ?? ?? 48 89 f3 49 89 fe 48 8d 7c 24 40 6a 40",
"55 41 57 41 56 53 48 83 ec 68 48 85 ff 0f 84 ?? ?? ?? ?? 48 89 f3 49 89 fe 4c 8d 7c 24 08",
"55 41 57 41 56 53 48 83 ec 68 48 85 ff 0f 84 ?? ?? ?? ?? 49 89 f6 49 89 ff 48 8d 5c 24 38"
],
"anchor": "bssl::x509_to_buffer"
}
},
"android/x86": {
"dart::bin::SSLCertContext::CertificateCallback": {
"signatures": [
"55 89 e5 53 57 56 83 e4 f0 83 ec 30 e8 ?? ?? ?? ?? 5b 81 c3 ?? ?? ?? ?? bf 01 00 00 00 83 7d 08 01 0f 84"
]
},
"X509_STORE_CTX_get_current_cert": {
"signatures": [
"55 89 e5 83 e4 fc 8b 45 08 8b 40 64 89 ec 5d c3",
"55 89 e5 83 e4 fc 8b 45 08 8b 40 34 89 ec 5d c3",
"55 89 e5 83 e4 fc 8b 45 08 8b 40 5c 89 ec 5d c3",
"55 89 e5 83 e4 fc 8b 45 08 8b 40 2c 89 ec 5d c3"
],
"anchor": "dart::bin::SSLCertContext::CertificateCallback"
},
"bssl::x509_to_buffer": {
"signatures": [
"55 89 e5 53 57 56 83 e4 f0 83 ec 20 89 ce e8 ?? ?? ?? ?? 5b 81 c3 ?? ?? ?? ?? 8d 44 24 14 83 20 00 89 44 24 04 89 14 24",
"55 89 e5 53 57 56 83 e4 f0 83 ec 10 89 ce e8 ?? ?? ?? ?? 5b 81 c3 ?? ?? ?? ?? 8d 44 24 08 83 20 00 83 ec 08 50 52",
"55 89 e5 53 56 83 e4 f0 83 ec 10 89 ce e8 ?? ?? ?? ?? 5b 81 c3 ?? ?? ?? ?? 8d 44 24 0c 83 20 00 83 ec 08 50 52"
]
},
"i2d_X509": {
"signatures": [
"55 89 e5 53 83 e4 f0 83 ec 10 e8 ?? ?? ?? ?? 5b 81 c3 ?? ?? ?? ?? 83 ec 04 8d 83 ?? ?? ?? ?? 50 ff 75 0c ff 75 08",
"55 89 e5 53 57 56 83 e4 f0 83 ec 40 e8 ?? ?? ?? ?? 5b 81 c3 ?? ?? ?? ?? 8b 7d 08 85 ff 0f 84 ?? ?? ?? ?? 83 ec 08",
"55 89 e5 53 57 56 83 e4 f0 83 ec 40 e8 ?? ?? ?? ?? 5b 81 c3 ?? ?? ?? ?? 8b 75 08 83 ec 0c 85 f6 0f 84",
"55 89 e5 53 57 56 83 e4 f0 83 ec 40 e8 ?? ?? ?? ?? 5b 81 c3 ?? ?? ?? ?? 83 ec 0c 83 7d 08 00 0f 84"
],
"anchor": "bssl::x509_to_buffer"
}
},
"android/arm64": {
"dart::bin::SSLCertContext::CertificateCallback": {
"signatures": [
"ff c3 00 d1 fe 57 01 a9 f4 4f 02 a9 1f 04 00 71 ?0 ?? ?? 54 f3 03 01 aa ?? ?? ?? 94 e0 07 00 b4 e0 03 13 aa",
"ff c3 00 d1 fe 57 01 a9 f4 4f 02 a9 1f 04 00 71 ?0 ?? ?? 54 f3 03 01 aa ?? ?? ?? 94 c0 09 00 b4 e0 03 13 aa",
"ff c3 00 d1 fe 57 01 a9 f4 4f 02 a9 1f 04 00 71 ?0 ?? ?? 54 f3 03 01 aa ?? ?? ?? 94 00 0a 00 b4 e0 03 13 aa"
]
},
"X509_STORE_CTX_get_current_cert": {
"signatures": [
"00 ?? ?? f9 c0 03 5f d6"
],
"anchor": "dart::bin::SSLCertContext::CertificateCallback"
},
"bssl::x509_to_buffer": {
"signatures": [
"fe 0f 1e f8 f4 4f 01 a9 e8 03 01 aa f3 03 00 aa e1 ?? ?? 91 e0 03 08 aa ff 07 00 f9 ?? ?? ?? 97 1f 04 00 71",
"f? ?? ?? ?? f? 4f 01 a9 e1 ?? ?? 91 f3 03 08 aa ff 07 00 f9 ?? ?? ?? 97 1f 0? 00 71 ?? ?? ?? 54 e8 ?? ?? f9",
"ff c3 00 d1 fe 7f 01 a9 f4 4f 02 a9 e1 ?? ?? 91 f3 03 08 aa ?? ?? ?? 97 1f 0? 00 71 ?? ?? ?? 54 e8 ?? ?? f9"
]
},
"i2d_X509": {
"signatures": [
"ff 43 02 d1 fe 57 07 a9 f4 4f 08 a9 a0 06 00 b4 f4 03 00 aa f3 03 01 aa e0 ?? ?? 91 01 08 80 52 ?? ?? ?? 97",
"?2 ?? ?? ?? 42 ?? ?? 91 ?? ?? ?? 17",
"ff 03 02 d1 fe 33 00 f9 f4 4f 07 a9 40 04 00 b4 ?? ?? ?? 94 e0 03 00 91 01 20 80 52 ?? ?? ?? 97 20 03 00 34",
"ff 43 02 d1 fe 57 07 a9 f4 4f 08 a9 00 06 00 b4 f4 03 00 aa e0 ?? ?? 91 f3 03 01 aa ?? ?? ?? 97 e0 ?? ?? 91"
],
"anchor": "bssl::x509_to_buffer"
}
},
"android/arm": {
"dart::bin::SSLCertContext::CertificateCallback": {
"signatures": [
"70 b5 84 b0 01 28 ?? d1 01 20 04 b0 70 bd 0c 46 ?? f? ?? f? 00 28 ?? d0 20 46 ?? f? ?? f? 0? 46 ??"
]
},
"X509_STORE_CTX_get_current_cert": {
"signatures": [
"40 6b 70 47",
"40 6e 70 47",
"c0 6d 70 47",
"c0 6a 70 47"
],
"anchor": "dart::bin::SSLCertContext::CertificateCallback"
},
"bssl::x509_to_buffer": {
"signatures": [
"?c b5 00 2? 0a 46 01 9? 01 a9 04 46 10 46 ?? f? ?? f? 0? 28 ?? d? 01 46 01 98 00 22 ?? f? ??"
]
},
"i2d_X509": {
"signatures": [
"70 b5 8e b0 00 28 ?? d0 05 46 08 a8 0c 46 40 21 ?? f? ?? f? 00 28 ?? d0 ?? 4a 08 a8 02 a9 ?? f? ?? f? ?? b3",
"?? 4a 7a 44 ?? f? ??",
"70 b5 8e b0 ?? b3 08 ae 05 46 0c 46 30 46 ?? f? ?? f? 30 46 40 21 ?? f? ?? f? ?? b3 ?? 4a 08 a8 02 a9",
"70 b5 8e b0 ?? b3 02 ae 05 46 0c 46 30 46 ?? f? ?? f? 30 46 4f f4 80 71 ?? f? ?? f? ?? b3 ?? 4a 02 a8 08 a9"
],
"anchor": "bssl::x509_to_buffer"
}
},
"android-release/x64": {
"dart::bin::SSLCertContext::CertificateCallback": {
"signatures": [
"41 57 41 56 53 48 83 ec 20 b8 01 00 00 00 83 ff 01 0f 84 ?? ?? ?? ?? 48 89 f3",
"41 57 41 56 41 54 53 48 83 ec 18 b? 01 00 00 00 83 ff 01 0f 84 ?? ?? ?? ?? 4? 89",
"41 57 41 56 41 54 53 48 83 ec 18 41 b? 01 00 00 00 83 ff 01 0f 84 ?? ?? ?? ?? 4? 89"
]
},
"bssl::x509_to_buffer": {
"signatures": [
"41 56 53 48 83 ec 18 48 89 f0 49 89 fe 48 8d 74 24 08 48 83 26 00 48 89 c7 e8",
"41 56 53 50 48 89 f0 48 89 fb 48 89 e6 48 83 26 00 48 89 c7 e8 ?? ?? ?? ?? 85 c0 7e 1b",
"41 57 41 56 53 48 83 ec 10 48 89 f0 48 89 fb 48 8d 74 24 08 48 83 26 00 48 89 c7",
"53 48 83 ec 10 48 89 f0 48 89 fb 48 8d 74 24 08 48 83 26 00 48 89 c7 e8 ?? ?? ?? ?? 85 c0"
]
},
"i2d_X509": {
"signatures": [
"48 8d 15 ?? ?? ?? ?? e9",
"55 41 56 53 48 81 ec 80 00 00 00 48 85 ff 0f 84 ?? ?? ?? ?? 48 89 f3 49 89 fe",
"41 57 41 56 53 48 83 ec 60 48 85 ff 0f 84 ?? ?? ?? ?? 49 89 f6 49 89 ff 48 89 e7",
"55 41 57 41 56 41 54 53 48 81 ec a0 00 00 00 48 85 ff 0f 84 ?? ?? ?? ?? 48 89 f3 49 89 fe"
],
"anchor": "bssl::x509_to_buffer"
},
"X509_STORE_CTX::current_cert": {
"anchor": "dart::bin::SSLCertContext::CertificateCallback",
"anchorMode": "within",
"signatures": [
"4c 8b bb b8 00 00 00",
"4d 8b 7e 60",
"4d 8b be a8 00 00 00",
"4d 8b 7e 50",
"49 8b 9e b8 00 00 00",
"4c 8b 73 50",
"4d 8b be b8 00 00 00"
]
}
},
"android-release/arm64": {
"dart::bin::SSLCertContext::CertificateCallback": {
"signatures": [
"ff 03 01 d1 fe 0b 00 f9 f6 57 02 a9 f4 4f 03 a9 1f 04 00 71 ?0 ?? ?? 54"
]
},
"bssl::x509_to_buffer": {
"signatures": [
"ff c3 00 d1 fe 7f 01 a9 f4 4f 02 a9 e1 ?? ?? 91 f3 03 08 aa ?? ?? ?? 97 1f 04 00 71 ?b ?? ?? 54 e8 ?? ?? f9",
"fe 0f 1e f8 f4 4f 01 a9 ?? ?? ?? 94 ff 07 00 f9 ?? ?? ?? 97 1f 04 00 71 ?b ?? ?? 54 e8 ?? ?? f9 e1 03 00 2a",
"ff c3 00 d1 fe 57 01 a9 f4 4f 02 a9 ?? ?? ?? 94 ?? ?? ?? 94 ff 07 00 f9 ?? ?? ?? 97 1f 04 00 71 ?b ?? ?? 54",
"f? ?? ?? ?? f? 4f 01 a9 e8 03 01 aa f3 03 00 aa ?? ?? ?? 94 ff 07 00 f9 ?? ?? ?? 97 1f 0? 00 71 ?? ?? ?? 54",
"ff c3 00 d1 fe 7f 01 a9 f4 4f 02 a9 ?? ?? ?? 94 e1 ?? ?? 91 e0 03 08 aa ?? ?? ?? 97 1f 0? 00 71 ?? ?? ?? 54"
]
},
"i2d_X509": {
"signatures": [
"?2 ?? ?? ?? 42 ?? ?? 91 ?? ?? ?? 17",
"ff 83 02 d1 fe 57 08 a9 f4 4f 09 a9 a0 06 00 b4 ?? ?? ?? 94 e0 ?? ?? 91 ?? ?? ?? 94 e0 05 00 34 02 02 80 52",
"ff 83 02 d1 fe 57 08 a9 f4 4f 09 a9 c0 06 00 b4 ?? ?? ?? 94 e0 ?? ?? 91 ?? ?? ?? 94 00 06 00 34 02 02 80 52",
"ff 03 02 d1 fe 33 00 f9 f4 4f 07 a9 c0 03 00 b4 ?? ?? ?? 94 e0 03 00 91 ?? ?? ?? 94 e0 02 00 34 02 02 80 52",
"ff 43 03 d1 fe 53 00 f9 f6 57 0b a9 f4 4f 0c a9 60 09 00 b4 00 e4 00 6f ?? ?? ?? 94 ?? ?? ?? 94 e0 09 00 34"
],
"anchor": "bssl::x509_to_buffer"
},
"X509_STORE_CTX::current_cert": {
"anchor": "dart::bin::SSLCertContext::CertificateCallback",
"anchorMode": "within",
"signatures": [
"74 ?? ?? f9"
]
}
},
"android-release/arm": {
"dart::bin::SSLCertContext::CertificateCallback": {
"signatures": [
"f0 b5 83 b0 01 28 ?? d1 01 20 03 b0 f0 bd ?? 48 0d 46 78 44 00 68 00 28 18 bf 82 f1 64 e9 ?? 48 78 44",
"f0 b5 83 b0 01 28 ?? d1 01 20 03 b0 f0 bd ?? 48 0? 46 78 44 00 68 00 28 18 bf ?0 f1 ?? eb ?? 48 78 44",
"f0 b5 83 b0 01 28 ?? d1 01 20 03 b0 f0 bd ?? 48 0c 46 78 44 00 68 00 28 18 bf 7? f1 ?? e? ?? 48 78 44",
"f0 b5 83 b0 01 28 ?? d1 01 20 03 b0 f0 bd ?? 48 0d 46 78 44 00 68 00 28 18 bf ?? f1 ?0 e? ?? 48 78 44",
"?0 b5 8? b0 01 28 ?? d1 01 20 0? b0 ?0 bd ?? 48 0? 46 78 44 ?? f? ?? e? 00 68 00 28 1c bf d0 f8 ?? 0? 00 28",
"f0 b5 83 b0 01 28 ?? d1 01 20 03 b0 f0 bd ?? 48 0d 46 78 44 00 68 00 28 18 bf 3? f1 ?? e? ?? 48 78 44"
]
},
"bssl::x509_to_buffer": {
"signatures": [
"7c b5 00 2? 0a 46 01 9? 01 a9 04 46 10 46 ?? f? ?? f? 0? 28 ?? d? 01 ?? 01 ?? 00 22 ?? ?? ?? f? ?? ??",
"?c b5 00 2? 0a 46 01 9? 01 a9 04 46 10 46 ?? f? ?? f? 0? 28 ?? d? 01 46 01 98 00 22 ?? f? ?? f? ?? ??"
]
},
"i2d_X509": {
"signatures": [
"?? 4a 7a 44 ?? f? ??",
"70 b5 90 b0 00 28 ?? d0 05 46 08 a8 0c 46 40 21 ?? f? ?? f? 00 28 ?? d0 ?? 4a 08 a8 02 a9 ?? f? ?? f? 00 28",
"b0 b5 8c b0 ?? b3 0c 46 05 46 68 46 4f f4 80 71 ?? f? ?? f? ?? b3 ?? 4a 06 a9 68 46 ?? f? ?? f? ?? b1 06 a8",
"f0 b5 95 b0 00 28 ?? d0 05 46 c0 ef 50 00 08 a8 0c 46 00 22 01 46 0d 92 41 f9 cd 0a 0a 60 40 21 ?? f? ??"
],
"anchor": "bssl::x509_to_buffer"
},
"X509_STORE_CTX::current_cert": {
"anchor": "dart::bin::SSLCertContext::CertificateCallback",
"anchorMode": "within",
"signatures": [
"65 6e 40 68",
"6c 6b 40 68",
"ec 6d 40 68",
"ec 6a 40 68",
"6c 6e 40 68",
"e5 6a 40 68"
]
}
}
}
// Not a function, but the instruction inside CertificateCallback that reads the field:
const CURRENT_CERT_FIELD = 'X509_STORE_CTX::current_cert';
const MAX_ANCHOR_INSTRUCTIONS_TO_SCAN = 100;
// How much of CertificateCallback we scan to find the inlined field load. Every build
// we've seen compiles it to well under this.
const MAX_FUNCTION_BYTES_TO_SCAN = 0x400;
const CALL_MNEMONICS = ['call', 'bl', 'blx'];
// On ARM all of this code is Thumb, and both NativeFunction and Instruction.parse need the
// low bit set to treat an address as Thumb rather than A32.
const isArm32 = Process.arch === 'arm';
const asCode = (address) => isArm32 ? address.or(1) : address;
function scanForSignature(base, size, patterns) {
const results = [];
for (const pattern of patterns) {
const result = Memory.scanSync(base, size, pattern);
results.push(...result);
}
return results;
}
/**
* Finds a function that we're going to call or hook, so its address has to be exactly
* right: we require one unambiguous match, and fail loudly otherwise.
*
* Where the function is anchored, the anchor's call target is the function entry by
* definition, so we can confirm the address outright: we accept a signature only if it
* matches at the call target itself, never part-way into it.
*/
function scanForFunction(moduleRXRanges, platformPatterns, functionName, anchorFn) {
const patternInfo = platformPatterns[functionName];
const signatures = patternInfo.signatures;
if (patternInfo.anchor) {
const maxPatternByteLength = Math.max(...signatures.map(p => (p.length + 1) / 3));
let addr = asCode(ptr(anchorFn));
for (let i = 0; i < MAX_ANCHOR_INSTRUCTIONS_TO_SCAN; i++) {
const instr = Instruction.parse(addr);
addr = instr.next;
if (CALL_MNEMONICS.includes(instr.mnemonic)) {
const callTargetAddr = ptr(instr.operands[0].value);
const results = scanForSignature(callTargetAddr, maxPatternByteLength, signatures);
if (results.some(result => result.address.equals(callTargetAddr))) {
return callTargetAddr;
}
}
}
throw new Error(`Failed to find any match for ${functionName} anchored by ${anchorFn}`);
} else {
const results = moduleRXRanges.flatMap((range) => scanForSignature(range.base, range.size, signatures));
if (results.length !== 1) {
// Not necessarily a problem: we scan with each build's patterns in turn, so
// failing to match here is how we recognise the other kind of build.
if (DEBUG_MODE) console.log(`Matches for ${functionName}:`, results);
throw new Error(`Found ${results.length} matches for ${functionName}`);
}
return results[0].address;
}
}
/**
* Finds a function that's only used as a starting point to scan forwards from, never
* called. That means we don't need its exact entry point, which matters because
* signatures overlap here: one generated from a build with a shorter prologue also
* matches part-way into the same function in a build with a longer one.
*
* We only tolerate matches that fall inside the extent of the first match, which proves
* they cover the same code rather than a second, unrelated site.
*/
function scanForAnchor(moduleRXRanges, platformPatterns, functionName) {
const signatures = platformPatterns[functionName].signatures;
const results = moduleRXRanges
.flatMap((range) => scanForSignature(range.base, range.size, signatures))
.sort((a, b) => a.address.compare(b.address));
if (results.length === 0) throw new Error(`Failed to find any match for ${functionName}`);
const firstMatchEnd = results[0].address.add(results[0].size);
const overlapping = results.every(result => result.address.compare(firstMatchEnd) < 0);
if (!overlapping) {
throw new Error(`Found ${results.length} separate matches for ${functionName}`);
}
return results[0].address;
}
/**
* Recovers the offset of X509_STORE_CTX->current_cert. In release builds the accessor is
* inlined, so we find the single instruction inside CertificateCallback that reads the
* field and take the displacement straight out of it. That way a future BoringSSL layout
* change is picked up automatically, rather than silently reading the wrong field.
*/
function findCurrentCertOffset(platformPatterns, certificateCallbackAddr) {
const patternInfo = platformPatterns[CURRENT_CERT_FIELD];
const results = scanForSignature(
certificateCallbackAddr,
MAX_FUNCTION_BYTES_TO_SCAN,
patternInfo.signatures
);
if (results.length !== 1) {
throw new Error(`Found ${results.length} matches for ${CURRENT_CERT_FIELD} - expected exactly one`);
}
const instruction = Instruction.parse(asCode(results[0].address));
const memoryOperand = instruction.operands.find(op => op.type === 'mem');
if (!memoryOperand) {
throw new Error(`No memory operand in ${CURRENT_CERT_FIELD} instruction: ${instruction}`);
}
const offset = memoryOperand.value.disp;
if (!offset) {
throw new Error(`Implausible ${CURRENT_CERT_FIELD} offset ${offset} from: ${instruction}`);
}
return offset;
}
/**
* Resolves everything we need to hook, using one specific set of patterns. This has to
* succeed or fail as a whole: a pattern set for the wrong engine build can match one
* function by chance, and we want to fall through to the next set if it does, rather
* than hooking a half-resolved mixture.
*/
function resolveTargets(moduleRXRanges, patterns) {
const certificateCallbackAddr = scanForFunction(moduleRXRanges, patterns, 'dart::bin::SSLCertContext::CertificateCallback');
// Where the accessor still exists we call it; where LTO inlined it (all release
// builds) we recover the field offset and read the store directly.
let getCurrentCert;
if (patterns[CURRENT_CERT_FIELD]) {
const currentCertOffset = findCurrentCertOffset(patterns, certificateCallbackAddr);
if (DEBUG_MODE) console.log(`X509_STORE_CTX->current_cert at +0x${currentCertOffset.toString(16)}`);
getCurrentCert = (storeCtx) => storeCtx.add(currentCertOffset).readPointer();
} else {
const x509GetCurrentCert = new NativeFunction(
asCode(scanForFunction(moduleRXRanges, patterns, 'X509_STORE_CTX_get_current_cert', certificateCallbackAddr)),
'pointer',
['pointer']
);
getCurrentCert = (storeCtx) => x509GetCurrentCert(storeCtx);
}
// x509_to_buffer is just used as an anchor for searching:
const x509ToBufferAddr = scanForAnchor(moduleRXRanges, patterns, 'bssl::x509_to_buffer');
const i2d_X509 = new NativeFunction(
asCode(scanForFunction(moduleRXRanges, patterns, 'i2d_X509', x509ToBufferAddr)),
'int',
['pointer', 'pointer']
);
return { certificateCallbackAddr, getCurrentCert, i2d_X509 };
}
/** Works out which engine build is loaded, by seeing whose patterns actually match. */
function findTargets(moduleRXRanges) {
// Frida calls 32-bit x86 'ia32', but our patterns are keyed by the name Flutter
// uses for the same architecture.
const arch = Process.arch === 'ia32' ? 'x86' : Process.arch;
const candidates = [`android-release/${arch}`, `android/${arch}`];
for (const key of candidates) {
if (!PATTERNS[key]) continue;
try {
const targets = resolveTargets(moduleRXRanges, PATTERNS[key]);
if (DEBUG_MODE) console.log(`Matched Flutter ${key} patterns`);
return targets;
} catch (e) {
// Expected for whichever engine build isn't loaded - we just try the next.
if (DEBUG_MODE) console.log(`Flutter ${key} patterns don't apply here: ${e.message}`);
}
}
throw new Error(`Could not match any known Flutter patterns for ${Process.arch}`);
}
function hookFlutter(moduleBase, moduleSize) {
if (DEBUG_MODE) console.log('\n=== Disabling Flutter certificate pinning ===');
const relevantRanges = Process.enumerateRanges('r-x').filter(range => {
return range.base >= moduleBase && range.base < moduleBase.add(moduleSize);
});
try {
const { certificateCallbackAddr, getCurrentCert, i2d_X509 } = findTargets(relevantRanges);
// This callback is called for all TLS connections. It immediately returns 1 (success) if BoringSSL
// trusts the cert, or it calls the configured BadCertificateCallback if it doesn't. Note that this
// is called for every cert in the chain individually - not the whole chain at once.
const dartCertificateCallback = new NativeFunction(
asCode(certificateCallbackAddr),
'int',
['int', 'pointer']
);
Interceptor.attach(dartCertificateCallback, {
onEnter: function (args) {
this.x509Store = args[1];
},
onLeave: function (retval) {
if (retval.toInt32() === 1) return; // Ignore successful validations
// This certificate isn't trusted by BoringSSL or the app's certificate callback. Check it ourselves
// and override the result if it exactly matches our cert.
try {
const x509Cert = getCurrentCert(this.x509Store);
const derLength = i2d_X509(x509Cert, NULL);
if (derLength <= 0) {
throw new Error('Failed to get DER length for X509 cert');
}
// We create our own target buffer (rather than letting BoringSSL do so, which would
// require more hooks to handle cleanup).
const derBuffer = Memory.alloc(derLength)
const outPtr = Memory.alloc(Process.pointerSize);
outPtr.writePointer(derBuffer);
const certDataLength = i2d_X509(x509Cert, outPtr)
const certData = new Uint8Array(derBuffer.readByteArray(certDataLength));
if (certData.every((byte, j) => CERT_DER[j] === byte)) {
retval.replace(1); // We trust this certificate, return success
}
} catch (error) {
console.error('[!] Internal error in Flutter certificate unpinning:', error);
}
}
});
console.log('=== Flutter certificate pinning disabled ===');
} catch (error) {
console.error('[!] Error preparing Flutter certificate pinning hooks:', error);
throw error;
}
}
let flutter = Process.findModuleByName('libflutter.so');
if (flutter) {
hookFlutter(flutter.base, flutter.size);
} else {
waitForModule('libflutter.so', function (module) {
hookFlutter(module.base, module.size);
});
}
})();