Cryoprison 1.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package Cryoprison --version 1.0.0                
NuGet\Install-Package Cryoprison -Version 1.0.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Cryoprison" Version="1.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Cryoprison --version 1.0.0                
#r "nuget: Cryoprison, 1.0.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Cryoprison as a Cake Addin
#addin nuget:?package=Cryoprison&version=1.0.0

// Install Cryoprison as a Cake Tool
#tool nuget:?package=Cryoprison&version=1.0.0                

Cryoprison

A mobile app jailbreak detector to be used in Xamarin.

Supports iOS and Android.

Overview

The host application should instantiate a JailbreakDetector from the correct Cryoprison platform library. Debug builds will be simulator-friendly to the extent possible by default.

The JailbreakDetector implements the IJailbreakDetector interface, which provides three methods, as described below:

Method Description
IsJailbroken Runs the jailbreak detection code if neccessary, and returns true if any jailbreaks are detected.
Violations Runs the jailbreak detection code if neccessary, and returns a list of all jailbreaks that are detected.
Reset Resets the violations list, causing the next call to IsJailbroken or Violations to re-run the detection code.

Jailbreaks are detected by running Inspectors, which derive from the IInspector interface. When possible, Inspectors are implemented in a platform independent fashion in the Cryoprison.Inspectors namespace. Some Inspectors are however platform dependent and are implemented in the PlatformSpecific namespaces of their OS specific Cryoprison.

Inspectors perform checks, which are configured on a per-platform basis in the platform-specific JailbreakDetector implementations using the Checks class.

The following checks are currently supported:

Method Platform Description
DirectoryNotPresent * Checks that the configured directory is not present.
FileNotAccessible * Checks that the configured file is not readable.
FileNotDestructivelyWritable * Checks that the configured file can not be created by the app. Destroys any previous version of the file as a side effect.
FileNotPresent * Checks that the configured file is not present.
PathNotSymbolicLink * Checks that the configured path is not as symbolic link.
UrlNotOpenable * Checks that the configured url can not be opened.
ShouldBeMobileProvisioned iOS Checks that the app has a mobile provisioning profile.
ShouldNotBeAbleToLocateFile Android Checks that a specific file is not found via 'which'.
ShouldNotHavePackageInstalled Android Check that a specific package is not installed.
ShouldNotHavePropValues Android Check for specific prop values via 'getprop'
ShouldNotHaveSpecificBuildTags Android Check that the kernal was not built with specific build tags, indicating a third party build.

The host may optionally register with the Reporter for global exception handling and jailbreak detection, for example for logging purposes. This is done indirectly via assigning callback methods to the static callbacks found in the JailbreakDetector class:

Method Description
OnJailbreakReported Invoked each time a jailbreak is detected, with the ID of the jailbreak.
OnExceptionReported Invoked each time an exception occurs, with an internal reason and the exception body

SampleApp

The sample app is a very simple Xamarin forms application that performs a jailbreak detection check when the main window appears.

Library

The Cryoprison library resides in this folder, and should currently be included via manual means in your project. Future versions may include a NuGet package.

Product Compatible and additional computed target framework versions.
MonoAndroid monoandroid80 is compatible. 
Xamarin.iOS xamarinios10 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • MonoAndroid 8.0

    • No dependencies.
  • Xamarin.iOS 1.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.0.1 212,960 9/5/2018
1.0.0 1,472 9/5/2018

Currently working on getting the nuget packaging correct