DevicePolicyManager.SetResetPasswordToken(ComponentName, Byte[]) Methode

Definition

Namespace:: Android.App.Admin

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Wird von einem Profil- oder Gerätebesitzer aufgerufen, um ein Token bereitzustellen, das später verwendet werden kann, um das Kennwort für den Sperrbildschirm des Geräts zurückzusetzen (wenn vom Gerätebesitzer aufgerufen), oder verwaltete Profilabfrage (wenn vom Profilbesitzer aufgerufen), über #resetPasswordWithToken.

[Android.Runtime.Register("setResetPasswordToken", "(Landroid/content/ComponentName;[B)Z", "GetSetResetPasswordToken_Landroid_content_ComponentName_arrayBHandler", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_RESET_PASSWORD")]
public virtual bool SetResetPasswordToken(Android.Content.ComponentName? admin, byte[]? token);

[<Android.Runtime.Register("setResetPasswordToken", "(Landroid/content/ComponentName;[B)Z", "GetSetResetPasswordToken_Landroid_content_ComponentName_arrayBHandler", ApiSince=26)>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_RESET_PASSWORD")>]
abstract member SetResetPasswordToken : Android.Content.ComponentName * byte[] -> bool
override this.SetResetPasswordToken : Android.Content.ComponentName * byte[] -> bool

Parameter

admin: ComponentName

Dieser DeviceAdminReceiver Anforderung ist zugeordnet. Null, wenn der Anrufer kein Geräteadministrator ist.

token: Byte[]

ein sicheres Token mit einer Länge von mindestens 32 Byte, das von einem kryptografisch starken Zufallszahlengenerator generiert werden muss.

Gibt zurück

Boolean

"true", wenn der Vorgang erfolgreich ist, andernfalls "false".

Attribute: RegisterAttribute RequiresPermissionAttribute

Hinweise

Wenn der Benutzer derzeit über ein Sperrbildschirmkennwort verfügt, kann das bereitgestellte Token nicht sofort verwendet werden. sie wird nur aktiv, nachdem der Benutzer einen Bestätigungs-Anmeldeinformationsvorgang ausgeführt hat, der durch KeyguardManager#createConfirmDeviceCredentialIntentausgelöst werden kann. Wenn der Benutzer kein Sperrbildschirmkennwort hat, wird das Token sofort aktiviert. In allen Fällen kann der aktive Zustand des aktuellen Tokens überprüft werden.#isResetPasswordTokenActive Aus Sicherheitsgründen werden nicht aktivierte Token nur im Arbeitsspeicher gespeichert und gehen nach dem Neustart des Geräts verloren. In diesem Fall muss ein neues Token erneut bereitgestellt werden.

Nach der Bereitstellung und Aktivierung bleibt das Token auch dann wirksam, wenn der Benutzer das Sperrbildschirmkennwort ändert oder löscht.

<em>This token is highly sensitive and should be treated at the same level as user credentials. Insbesondere speichern Sie dieses Token niemals auf dem Gerät im Nur-Text-Format. Speichern Sie das Nur-Text-Token nicht im geräteverschlüsselten Speicher, wenn es erforderlich ist, das Kennwort auf dateibasierten Verschlüsselungsgeräten zurückzusetzen, bevor der Benutzer entsperrt wird. Überlegen Sie sorgfältig, wie ein Kennworttoken auf Ihrem Server gespeichert wird und wer Darauf zugreifen muss. Token können Gegenstand gesetzlicher Zugriffsanforderungen sein. </em>

Auf Geräten, die das Feature nicht unterstützen PackageManager#FEATURE_SECURE_LOCK_SCREEN , wird das Zurücksetzungstoken nicht festgelegt, und diese Methode gibt "false" zurück.

Java Dokumentation für android.app.admin.DevicePolicyManager.setResetPasswordToken(android.content.ComponentName, byte[]).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: