blob: 8dd01f0ea575e5e245f1a9820c5a9fc50436e106 [file] [log] [blame]
Kevin Chyn9af27672021-06-09 17:32:43 -07001/*
2 * Copyright (C) 2021 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package com.android.settings.biometrics;
18
19import android.app.admin.DevicePolicyManager;
20import android.content.ComponentName;
21import android.content.Context;
22import android.hardware.biometrics.BiometricAuthenticator;
Kevin Chynee3ca152021-06-14 19:07:43 -070023import android.hardware.biometrics.ParentalControlsUtilsInternal;
Kevin Chyn9af27672021-06-09 17:32:43 -070024import android.os.UserHandle;
Kevin Chyn0c34d252021-06-15 13:34:11 -070025import android.os.UserManager;
Kevin Chyn9af27672021-06-09 17:32:43 -070026import android.util.Log;
27
28import androidx.annotation.NonNull;
29import androidx.annotation.Nullable;
30
31import com.android.internal.annotations.VisibleForTesting;
32import com.android.settingslib.RestrictedLockUtils;
33
34/**
35 * Utilities for things at the cross-section of biometrics and parental controls. For example,
36 * determining if parental consent is required, determining which strings should be shown, etc.
37 */
38public class ParentalControlsUtils {
39
40 private static final String TAG = "ParentalControlsUtils";
Kevin Chyn9af27672021-06-09 17:32:43 -070041
42 /**
Kevin Chynadd8de42021-06-15 12:52:45 -070043 * Public version that enables test paths, see
Yuri Ufimtsevd16c12b2022-03-30 18:55:01 +000044 * {@link android.hardware.biometrics.ParentalControlsUtilsInternal#getTestComponentName}
Kevin Chyn9af27672021-06-09 17:32:43 -070045 * @return non-null EnforcedAdmin if parental consent is required
46 */
47 public static RestrictedLockUtils.EnforcedAdmin parentConsentRequired(@NonNull Context context,
48 @BiometricAuthenticator.Modality int modality) {
49
Yuri Ufimtsevd16c12b2022-03-30 18:55:01 +000050 final int userId = UserHandle.myUserId();
51 final UserHandle userHandle = new UserHandle(userId);
52 final ComponentName testComponentName = ParentalControlsUtilsInternal.getTestComponentName(
53 context, userId);
54 if (testComponentName != null) {
Kevin Chynadd8de42021-06-15 12:52:45 -070055 Log.d(TAG, "Requiring consent for test flow");
Yuri Ufimtsevd16c12b2022-03-30 18:55:01 +000056 return new RestrictedLockUtils.EnforcedAdmin(testComponentName,
Kevin Chyn0c34d252021-06-15 13:34:11 -070057 UserManager.DISALLOW_BIOMETRIC, userHandle);
Kevin Chyn9af27672021-06-09 17:32:43 -070058 }
59
60 final DevicePolicyManager dpm = context.getSystemService(DevicePolicyManager.class);
61 return parentConsentRequiredInternal(dpm, modality, userHandle);
62 }
63
64 /**
65 * Internal testable version.
66 * @return non-null EnforcedAdmin if parental consent is required
67 */
68 @Nullable
69 @VisibleForTesting
70 static RestrictedLockUtils.EnforcedAdmin parentConsentRequiredInternal(
71 @NonNull DevicePolicyManager dpm, @BiometricAuthenticator.Modality int modality,
72 @NonNull UserHandle userHandle) {
Kevin Chynadd8de42021-06-15 12:52:45 -070073 if (ParentalControlsUtilsInternal.parentConsentRequired(dpm, modality,
74 userHandle)) {
Kevin Chynee3ca152021-06-14 19:07:43 -070075 final ComponentName cn =
76 ParentalControlsUtilsInternal.getSupervisionComponentName(dpm, userHandle);
Kevin Chyn0c34d252021-06-15 13:34:11 -070077 return new RestrictedLockUtils.EnforcedAdmin(cn, UserManager.DISALLOW_BIOMETRIC,
78 userHandle);
Kevin Chyn9af27672021-06-09 17:32:43 -070079 } else {
80 return null;
81 }
82 }
Kevin Chyn9af27672021-06-09 17:32:43 -070083}