Magisk - Droits root & Modules

Mise à jour : Android 9 - Magisk 20.3 - Magisk Manager V7.5.1.

• Ce document décrit l'installation et l'utilisation de Magisk et Magisk Manager pour installer les droits root et des modules Magisk

• L'installation de Magisk est dite "systemlessly" car elle intervient sur la partition /system sans modifier son contenu, par montage d'une partition /system Magisk (/sbin/.magisk/block/system) en parallèle à la partition /system existante
  

• Forum Magisk
• Magisk Documentation
  

Sommaire

1 - Préalable

1.1 - Périphérique et partition de récupération

• Dans ce qui suit, on suppose que
  
• le périphérique ne dispose pas d'un double système de partition A/B
• le périphérique n'utilise pas la partition système comme racine (system-as-root)

Pour vérifier les deux points ci-dessus, ouvrir un shell, par exemple via adb comme ci-dessous.

$ adb shell

Les commandes ne doivent pas retourner le résultat "true"

a5y17lte:/ $ getprop ro.build.ab_update

a5y17lte:/ $ getprop ro.build.system_root_image

• On suppose également que TWRP a été installé dans la partition de récupération

Si  ce n'est pas le cas, voir : Magisk Documentation

1.2 - État du périphérique

• Magisk ne doit pas être installé ou s'il a été installé, doit avoir été correctement désinstallé. En cas de doute, lancer l'installation de Magisk uninstaller (voir Désinstallation).
  
• Aucune application fournissant les droits root ne doit-être présente. Pour le vérifier
  
• soit utiliser un terminal
  

gts210velte:/ $ su --help
MagiskSU v20.1(20100) (by topjohnwu)
....

Dans le cas présent, Magisk est à l'origine des droits root, le désinstaller (voir plus loin)

• soit utiliser une application dédiée telle que Root Verifier (com.abcdjdj.rootverifier), disponible dans le dépôt F-Droid, qui fournit également l'origine des droits root lorsqu'ils sont installés
  

2 - Installation

Magisk se compose

• d'un module sans interface opérateur, installable grâce à un fichier OTA Magisk-xxxx.zip
  

• d'une interface de gestion  "Magisk Manager", optionnelle, installable grâce à une application manager-yyyy.apk
  

2.1 - Installation du fichier OTA

• Télécharger la dernière version de Magisk depuis

• le Forum Magisk : Forum Magisk

• ou GitHub : https://github.com/topjohnwu/Magisk/releases
  

$ wget https://github.com/topjohnwu/Magisk/releases/download/v17.1/Magisk-v17.1.zip

• Démarrer le périphérique en mode recovery
  

$ adb reboot recovery

• Dans ce qui suit on utilise la méthode d'installation adb sideload
• Sélectionner dans le menu TWRP, Paramètres avancés >> Transfert via ADB Puis Glisser pour débuter le transfert
  
• Depuis le PC, lancer l'installation

$ adb sideload Magisk-v17.1.zip

• Redémarrer
  

• Si l'installation échoue, il peut-être nécessaire de reflasher la partition de boot d'origine (dernière version du fabricant)

2.2 - Installation de l'application de supervision

• L'application de supervision Magisk Manager est installée avec le fichier OTA
  
• Si elle n'apparaît pas,
  
• la télécharger à partir du site Magisk (Latest Magisk Manager) ou bien à partir du dépôt GitHub

$ wget https://github.com/topjohnwu/Magisk/releases/tag/manager-v7.4.0

• et l'installer

$ adb install MagiskManager-v7.4.0.apk

3 - Utilisation

3.1 - Magisk Manager

• Lancer l'application Magisk Manager
• Sélectionner les menus par l'intermédiaire de la "banane" à gauche dans la barre de menus
  

• Le Menu principal, appelé Magisk, permet

• la mise à jour de Magisk et Magisk Manager

• la vérification du statut SafetyNet

• la possibilité de faire des dons à l'auteur
• les liens vers les comptes Tweeter, GitHub et XDA du projet
  

• Le menu # Super-utilisateur fournit la liste des applications qui ont demandés les droits super-utilisateur, qu'ils aient été accordés ou refusés. Il permet de modifier ces droits (voir Droits Super-utilisateur)
  

• Le menu Magisk Hide, permet de sélectionner parmi les applications installées, celles qui ne doivent pas voir Magisk, et les droits root
  

• Les menus Modules et Téléchargement permettent de gérer et installer des modules (applications) Magisk
  

• Le menu Paramètres

3.2 - Droits Super-utilisateur

• Les droits Super-utilisateur sont disponibles dès l'installation de Magisk sous réserve du paramétrage effectué dans le menu Paramètres - Section Super-utilisateur :
  
• Par défaut, les droits sont disponibles pour les applications et les accès adb qui en font la demande.
  
• Il est possible de sélectionner d'autres configurations : aucun accès, accès adb seulement, accès applications seulement
• Lorsqu'une application demande les droits Super-utilisateur, sous réserve qu'elle ne soit pas masquée (voir Magisk Hide), Magisk affiche une notification et l'utilisateur a la possibilité d'accorder les droits (définitivement ou une fois ou pour une période donnée) ou de les refuser. Pour modifier ce choix, se rendre dans le menu Super-utilisateur de Magisk Manager, sélectionner l'application et utiliser les options pour 

• suspendre ou attribuer les droits

• supprimer les notifications lors de l'accès aux droits

• révoquer les droits et faire disparaître l'application de la liste

• Exemple 1 : Utilisation des droits root par l'application Root Verifier (com.abcdjdj.rootverifier)

• Lancer l'application et le test de vérification

• Une fenêtre de Demande d'accès super-utilisateur s'affiche pour l'application Root Verfier. Si la demande n'apparaît pas ou pour redéfinir les droits, ouvrir le menu Super-utilisateur de Magisk Manager, sélectionner l'application  et redéfinir les droits.
• Accorder les droits
  
• L'application affiche le résultat du test : Appareil Rooté
  

• Exemple 2 : Utilisation des droits root dans un shell en utilisant un émulateur de terminal

• Installer un Émulateur de Terminal
  
• Ouvrir le terminal et lancer un shell root

:/ $ su

• Une fenêtre de Demande d'accès super-utilisateur s'affiche, accorder les droits à l'application
  
• Vérifier les identifiants utilisateurs
  

:/ # id
uid=0(root) gid=0(root) group=0(root) context=u:r:magisk:s0

• Exemple 3 : Utilisation des droits root dans un shell en utilisant adb
  
• Connecter le périphérique à un PC sur lequel adb est installé
  
• Vérifier la connexion
  

$ adb devices

• Ouvrir et lancer un shell root : Accorder la demande d'accès aux droits Super-utilisateur pour "Shell"
  

$ adb shell
a5y17lte:/ $ su
a5y17lte:/ # id
uid=0(root) gid=0(root) groups=0(root) context=u:r:magisk:s0

• Taper exit, pour revenir au shell utilisateur

3.3 - Magisk Hide

• Si l'application Root Verifier est installée, pour vérifier le mode Magisk Hide
  
• Rechercher dans le Menu Magisk Hide l'application Root Verifier et la cocher
• Lancer Root Verifier et la vérification root
• La vérification doit échouer (Réponse : Appareil non routé). La busybox si installée en tant que module Magisk n'est pas détectée non plus
• Si malgré le mode Magisk Hide, l'application détecte les droits root et la busybox, redémarrer le périphérique et faire à nouveau le test
• Si une application d'émulation de terminal, par exemple Terminal Emulator est installée
• Rechercher dans le Menu Magisk Hide l'application Terminal Emulator, la cocher, fermer Magisk, éventuellement redémarrer
  
• Lancer Terminal Emulator et demander les droits root

:/ $ su
/system/bin/sh: su: not found

• Lancer la commande busybox

:/ $ busybox
/system//bin/sh: busybox: not found

3.4 - SafetyNet

• Magisk inclue plusieurs dispositifs de masquage vis à vis de SafetyNet, dont l'enracinement du système, la modification du chargeur de démarrage, etc... : pour plus de détail voir https://topjohnwu.github.io/Magisk/tutorials.html#best-practices-for-magiskhide
  

• Pour vérifier que le système passe ou non SafetyNet, lancer le test depuis le Menu Principal Magisk "Appuyez pour lancer le contrôle"
• Le message "Vérification de l'état de SafetyNet" s'affiche
• Puis en cas de succès, les messages Contrôle SafetyNet réussi, ctsProfile: true et basicintegrity: true s'affichent
  
• Le test réussit sur une Tablette Galaxy Tab S2 9.2 avec ROM non-officielle LIneageOS16 + picogapps + Magisk
• Le test échoue sur un Téléphone Galaxy A5 (2017) avec ROM officielle LineageOS16 + microG + Magisk (problème connu dû à microGuardHelper)
  

3.5 - Modules

3.5.1 Menu Téléchargements

• La page Téléchargements du menu Principal de Magisk, permet de rechercher, sélectionner et installer des modules Magisk disponibles dans le dépôt Magisk XDA-developer.
  

• Installer par exemple,
  

• App Systemizer : permet de rendre système une application utilisateur et réciproquement, les applications ne sont jamais supprimées et peuvent être réinstallées
  
• Debloater : permet de supprimer des applications système installées dans la partition /system
  
• Busybox for Android NDK : busybox nécessaire pour le fonctionnement de nombreux modules, dont App Systemizer et Debloater
  
• YouTube Vanced - Magisk Repo : une version de YouTube avec blocage des publicités
• GNU Utils for Android : Divers utilitaires GNU pour Android
• Nano for Android : l'éditeur de texte GNU en ligne de commande
• ADB & Fastboot for Android NDK : adb et fastboot pour s'interfacer avec un autre périphérique Android via adb et fastboot
• Magisk Manager for Recovery mode (mm) : gestion des modules - désinstallation TWRP - ... à partir du mode TWRP : voir plus loin
  
• Redémarrer le périphérique pour terminer l'installation

3.5.2 Menu Modules

• Le menu Modules
  
• affiche la liste des Modules installés
• et permet (icône  +) d'installer des Modules à partir de fichiers zip téléchargés préalablement, qu'ils proviennent du dépôt Magisk XDA-developer ou d'autres sources
  
• Installer par exemple le module AuroraServicesxxxmagisk.zip qui fournit les droits de téléchargement / installation automatique aux applications AuroraStore et AuroraDroid
  
• Télécharger et recopier dans un répertoire du périphérique, par exemple, /sdcard/Download le fichier
  
• Tapoter sur l'icône +, sélectionner le répertoire et le fichier
• Redémarrer le périphérique

3.5.3 Installation de modules depuis TWRP

Lorsque l'on dispose des fichiers OTA des modules, ils peuvent également être installés directement depuis TWRP (Menu Installation ou Sideload)

4 - Mises à jour et désinstallation

4.1 - Mises à jour

Lors des mises à jour de Magisk, de Magisk Manager et d'Android, les paramétrages, autorisations etc.. effectués sous une version sont reconduits automatiquement. De même les modules installés sont conservés.

4.2 - Désinstallation

Pour désinstaller Magisk et Magisk Manager utiliser l'une des méthodes suivantes :

4.2.1 Désinstallation depuis Magisk Manager

Depuis la page principale du Menu Magisk Manager, sélectionner le menu Désinstaller en bas de page et redémarrer le périphérique

4.2.2 Désinstallation depuis TWRP

• Télécharger la dernière version du désinstallateur depuis
  

• le Forum Magisk : Forum Magisk

• ou GitHub : https://github.com/topjohnwu/Magisk/releases
  

$ wget https://github.com/topjohnwu/Magisk/releases/download/v20.1/Magisk-uninstaller-20191102.zip

• Démarrer le périphérique en mode recovery
  

$ adb reboot recovery

• Pour installer le fichier, par la méthode d'installation adb sideload
• Sélectionner le menu Paramètres avancés >> Transfert via ADB
  
• Depuis le PC, lancer la désinstallation

$ adb sideload Magisk-uninstaller-20191102.zip

• Redémarrer

5 - Magisk Manager for Recovery mode (mm)

5.1 - Principe

Le module Magisk Manager for Recovery mode (mm) permet de gérer les modules Magisk en mode récupération TWRP. Cette option est intéressante lorsque l'installation d'un module empêche le système de démarrer normalement.

5.2 - Utilisation

• Redémarrer le périphérique en mode recovery TWRP
• Ouvrir un shell
  
• soit depuis le terminal disponible dans TWRP >> Paramètres avancés
• soit depuis un PC connecté via adb, comme ci-dessous
• Lancer le module Magisk Manager for Recovery
  

$ adb shell
~ # sh /sdcard/mm

Magisk Manager for Recovery Mode (mm) 2019.4.4
Copyright (C) 2017-2019, VR25 @ xda-developers
License: GPLv3+

##########################
l) List installed modules
##########################
Toggle
  c) Core only mode
  m) Magic mount
  d) Disable
  r) Remove
##########################
q) Quit
##########################

?) 

5.3 - Gestion des modules

Sélectionner l'option l pour lister les modules

Sélectionner l'option c pour activer uniquement les fonctions de base de Magisk, MagiskSU et MagiskHide resteront activés, mais aucun module ne sera chargé

Sélectionner l'option m pour sélectionner les modules à monter / démonter

Sélectionner l'option d pour sélectionner les modules à désactiver

Sélectionner l'option r pour sélectionner les modules à supprimer