Skip to content

Commit

Permalink
Fork init and adjusted config.
Browse files Browse the repository at this point in the history
  • Loading branch information
manxjason committed Jan 25, 2024
1 parent a20d6a1 commit 40f814f
Show file tree
Hide file tree
Showing 7 changed files with 15 additions and 22 deletions.

This file was deleted.

16 changes: 4 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,15 @@
An Android module (`.aar`) that can be added to any project to enable user-installed trusted root certificates in debuggable builds.

This is useful when inspecting traffic using [Charles Proxy](https://www.charlesproxy.com/) or [Fiddler](https://www.telerik.com/fiddler),
as these tools [require a self-signed root certificate](https://www.telerik.com/blogs/how-to-capture-android-traffic-with-fiddler) to
be installed on the device to enable them to decrypt traffic, man-in-the-middle style. As of Android N, user-installed certificates like
this are not respected by applications except the system web browser, unless the application explicitly opts-in to it.

This module does exactly that, by providing a `network-security-config` resource that enables user-installed certificates _only in
debuggable builds_.
An Android module (`.aar`) that can be added to any project to enable user-installed trusted root certificates.

## Prebuilt release

See the [Releases](https://github.com/aholkner/AndroidDebuggableRootCertificates/releases) page to download a prebuilt .aar file.
See the [Releases](https://github.com/ArborXR/Android-Root-CA-Library/releases) page to download a prebuilt .aar file.

## Using with Unity

Simply add the `DebuggableRootCertificates.aar` release file anywhere in the `Assets` folder. It should work with Unity 2018.x and later.
Simply add the `RootCertificateSecurityConfig.aar` release file anywhere in the `Assets` folder. It should work with Unity 2018.x and later.

## Using with other projects

Use the appropriate module-linking functionality of your build system to add the `DebuggableRootCertificates.aar` file, or import this
Use the appropriate module-linking functionality of your build system to add the `RootCertificateSecurityConfig.aar` file, or import this
prjoect into your Gradle system. Alternatively, just have a look at the `AndroidManifest.xml` and `network_security_config.xml` file
in this project and add them directly to your own.
File renamed without changes.
File renamed without changes.
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.studiodrydock.debuggablerootcertificates">
package="app.xrdm.certificatesecurityconfig">

<application android:networkSecurityConfig="@xml/network_security_config" />
</manifest>
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
<base-config>
<trust-anchors>
<certificates src="user"/>
<certificates src="system"/>
</trust-anchors>
</base-config>
</network-security-config>
2 changes: 1 addition & 1 deletion settings.gradle
Original file line number Diff line number Diff line change
@@ -1 +1 @@
include ':DebuggableRootCertificates'
include ':RootCertificateSecurityConfig'

0 comments on commit 40f814f

Please sign in to comment.