B4A Library Device Administrator library

Erel · Jul 2, 2012

Starting from Android 2.2 (api level 8), Android allows application to be registered as administrators.
Administrator apps have the following special features:
- Manually lock the screen
- Set the minimum password length and quality
- Wipe the entire device
- Set the maximum allowed time before the device locks
- Request the user to change password
- Manually set a new password
- Disable the camera
- Track password changes
- Some other security features as described here.

Note that the password is the screen lock password (other passwords are not affected).

The user needs to enable the admin app before it can have any special privileges.
This is done either by calling Manager.Enable or from the Security settings page.
The user will see a message with the policies that this app requests:

The user can always disable an administrator app from the Security settings page. The idea is that in your app you should check whether the admin is enabled and the password meets the requirements. If they don't then you do not give access to some resource such as the company's server.

How to
A working example is attached to this project. It is recommended to start with it.
Add the following code to the manifest editor:

B4X:

AddApplicationText(<receiver android:name="anywheresoftware.b4a.objects.AdminReceiver2"
  android:permission="android.permission.BIND_DEVICE_ADMIN"
  android:exported="true">
  <meta-data android:name="android.app.device_admin"
  android:resource="@xml/device_admin" />
  <intent-filter>
  <action android:name="android.app.action.DEVICE_ADMIN_ENABLED" />
  </intent-filter>
</receiver>)

CreateResource(xml, device_admin.xml,
<device-admin xmlns:android="http://schemas.android.com/apk/res/android">
  <uses-policies>
  <limit-password />
  <reset-password />
  <force-lock />
  </uses-policies>
</device-admin>
)

3. Declare an AdminManager object. With this object you can ask the user to enable the admin app and access the special privileges.

4. (optional) Add a service named ManagerService. This service will allow you to track password changes and changes to the admin app enabled status. See the attached example.

The latest version of this library is included in the IDE.

Upgrading from v1.00

The receiver name has changed. You need to update the manifest editor code.
The user will probably need to re-enable the admin app. V1.00 library is attached to allow developers to keep the previous version if prefered.

Erel · Jul 18, 2017

Mark Hollingworth said:
o it looks like this is not going to be possible anymore as there is no way to set an app as a device owner (from what I can see)..

It is now possible to set the device owner: https://www.b4x.com/android/forum/threads/81765/#content

Mark Hollingworth · Jul 18, 2017

Erel said:
It is now possible to set the device owner: https://www.b4x.com/android/forum/threads/81765/#content

Excellent that will work for me, shame you can only set it using a PC connection but that's better then nothing just wont be able to add it to the play store... yet

moster67 · Aug 9, 2017

Using the role of the Device Administrator, is this the way that automation tools, such as Tasker, works?

Erel · Aug 10, 2017

I don't think so. Do you need to enable that app as an admin app?

moster67 · Aug 10, 2017

I would like to find out how automation apps such as Tasker work and how they do things and I thought this library might matter.
I will open a separate question.

ykucuk · Sep 11, 2017

Hi,
I downloaded example project. I did set read-only the XML file in the Res folder.

Tried 3 different devices but doesn't work. Not even log or any error.

I attached a screenshot with unfiltered logs.

Any help?

Erel · Sep 11, 2017

ykucuk said:
I did set read-only the XML file in the Res folder.

That is not needed. It creates the XML with CreateResource command.

ykucuk said:
I attached a screenshot with unfiltered logs.

It is always better to post text instead of screenshots. You can right click to copy.

There is nothing relevant in the logs.

ykucuk · Sep 11, 2017

Erel said:
That is not needed. It creates the XML with CreateResource command.

It is always better to post text instead of screenshots. You can right click to copy.

There is nothing relevant in the logs.

It gives error "file not found:deviceadmin.XML" if don't set read only.

is there way copy all log because its like listbox and can copy line by line.

I added my project file. Already tried 4 different devices and cant figure out. I need administrator right.

could you check when you have time.

Erel · Sep 11, 2017

I've updated the example attached to the first post.

ykucuk · Sep 11, 2017

Erel said:
I've updated the example attached to the first post.

Thank you. its work.

Xenno · Jan 2, 2018

Please, help. I followed the steps but keeps failing. No device administration dialog appear on calling "Enable".

The log shows:

B4X:

Unable to retrieve device policy ComponentInfo{com.sample.test/anywheresoftware.b4a.objects.AdminManager$AdminReceiver}

In manifest code:

B4X:

AddApplicationText(<receiver android:name="anywheresoftware.b4a.objects.AdminReceiver"
...

The device_admin.xml exists in res/xml

B4A 6.80

TIA

DonManfred · Jan 2, 2018

Xenno said:
The device_admin.xml exists in res/xml

and it is set to readonly; means; it is STILL THERE?

Edit; sorry it is using the CreateResource; so i guess it is still there.

Can you post your manifestcode?

Xenno · Jan 2, 2018

Here is the manifest code:

B4X:

'This code will be applied to the manifest file during compilation.
'You do not need to modify it in most cases.
'See this link for for more information: https://www.b4x.com/forum/showthread.php?p=78136
AddManifestText(
<uses-sdk android:minSdkVersion="5" android:targetSdkVersion="19"/>
<supports-screens android:largeScreens="true"
    android:normalScreens="true"
    android:smallScreens="true"
    android:anyDensity="true"/>)
SetApplicationAttribute(android:icon, "@drawable/icon")
SetApplicationAttribute(android:label, "$LABEL$")
'End of default text.

AddApplicationText(<receiver android:name="anywheresoftware.b4a.objects.AdminReceiver"
  android:permission="android.permission.BIND_DEVICE_ADMIN">
  <meta-data android:name="android.app.device_admin"
  android:resource="@xml/device_admin" />
  <intent-filter>
  <action android:name="android.app.action.DEVICE_ADMIN_ENABLED" />
  </intent-filter>
</receiver>)

CreateResource(xml, device_admin.xml,
<device-admin xmlns:android="http://schemas.android.com/apk/res/android">
  <uses-policies>
  <limit-password />
  <reset-password />
  <force-lock />
  </uses-policies>
</device-admin>
)

Here's the code in main activity:

B4X:

Sub Process_Globals
    'These global variables will be declared once when the application starts.
    'These variables can be accessed from all modules.

    Public AdmMgr As AdminManager
End Sub

...

Sub cbEnable_CheckedChange(Checked As Boolean)
    If (Checked) Then      
        If Not(AdmMgr.Enabled) Then
            AdmMgr.Enable("Device Administration for this app is required.")
            If Not(AdmMgr.Enabled) Then
                cbEnable.Checked = False
            End If
        End If
    End If
End Sub

Erel · Jan 2, 2018

The correct receiver name in v1.00 of this library is:

B4X:

AddApplicationText(<receiver android:name="anywheresoftware.b4a.objects.AdminManager$AdminReceiver"

Xenno · Jan 2, 2018

Thanks, Erel.
It solved.

noeleon · Apr 5, 2019

Erel said:
r.RunMethod4("setCameraDisabled", Array As Object(cm, True), _
Array As String("android.content.ComponentName", "java.lang.boolean") 'change to False to enable camera

Can't enable the camera if it was disabled by another admin app. How do i check for this?

And how to launch the Device Administrators activity in android settings?
Thanks.

Erel · Apr 7, 2019

Please start a new thread and post any error message you see when trying to enable the camera.

Erel · Aug 9, 2023

Example was updated. android:exported was added to the manifest editor.

B4A Library Device Administrator library

Attachments

B4X founder

Member

Expert

B4X founder

Expert

Well-Known Member

Attachments

B4X founder

Well-Known Member

Attachments

B4X founder

Well-Known Member

Member

Expert

Member

B4X founder

Member

Active Member

B4X founder

B4X founder

Similar Threads

Privacy & Transparency

Privacy & Transparency