Condividi tramite


DevicePolicyManager.InstallKeyPair Metodo

Definizione

Overload

InstallKeyPair(ComponentName, IPrivateKey, Certificate[], String, Boolean)

Questa API può essere chiamata dal comando seguente per installare una catena di certificati e la chiave privata corrispondente per il certificato foglia: ul>li Proprietario dispositivo/li>Profilo proprietario<</li Li Programma di installazione< del certificato delegato/li><><>>li App di gestione< delle credenziali/li<>>App che contiene l'autorizzazione<android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES/li<>></ul>><< Tutte le app all'interno del profilo potranno accedere alla catena di certificati e usare la chiave privata, data l'approvazione diretta dell'utente.

InstallKeyPair(ComponentName, IPrivateKey, Certificate[], String, InstallKeyFlags)

Questa API può essere chiamata dal comando seguente per installare una catena di certificati e la chiave privata corrispondente per il certificato foglia: ul>li Proprietario dispositivo/li>Profilo proprietario<</li Li Programma di installazione< del certificato delegato/li><><>>li App di gestione< delle credenziali/li<>>App che contiene l'autorizzazione<android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES/li<>></ul>><< Tutte le app all'interno del profilo potranno accedere alla catena di certificati e usare la chiave privata, data l'approvazione diretta dell'utente (se l'utente è autorizzato a selezionare la chiave privata).

InstallKeyPair(ComponentName, IPrivateKey, Certificate, String)

Questa API può essere chiamata dal comando seguente per installare un certificato e la chiave privata corrispondente: <ul<>li>Proprietario del dispositivo/li>><Profilo proprietario<</li>><li Programma di installazione< del certificato delegato/li li App di gestione< delle credenziali/li>>><><Un'app che contiene l'autorizzazione<android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES/li></ul> Tutte le app all'interno del profilo sarà in grado di accedere al certificato e usare la chiave privata, dato l'approvazione diretta dell'utente.

InstallKeyPair(ComponentName, IPrivateKey, Certificate[], String, Boolean)

Questa API può essere chiamata dal comando seguente per installare una catena di certificati e la chiave privata corrispondente per il certificato foglia: ul>li Proprietario dispositivo/li>Profilo proprietario<</li Li Programma di installazione< del certificato delegato/li><><>>li App di gestione< delle credenziali/li<>>App che contiene l'autorizzazione<android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES/li<>></ul>><< Tutte le app all'interno del profilo potranno accedere alla catena di certificati e usare la chiave privata, data l'approvazione diretta dell'utente.

[Android.Runtime.Register("installKeyPair", "(Landroid/content/ComponentName;Ljava/security/PrivateKey;[Ljava/security/cert/Certificate;Ljava/lang/String;Z)Z", "GetInstallKeyPair_Landroid_content_ComponentName_Ljava_security_PrivateKey_arrayLjava_security_cert_Certificate_Ljava_lang_String_ZHandler", ApiSince=24)]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_CERTIFICATES")]
public virtual bool InstallKeyPair (Android.Content.ComponentName? admin, Java.Security.IPrivateKey privKey, Java.Security.Cert.Certificate[] certs, string alias, bool requestAccess);
[<Android.Runtime.Register("installKeyPair", "(Landroid/content/ComponentName;Ljava/security/PrivateKey;[Ljava/security/cert/Certificate;Ljava/lang/String;Z)Z", "GetInstallKeyPair_Landroid_content_ComponentName_Ljava_security_PrivateKey_arrayLjava_security_cert_Certificate_Ljava_lang_String_ZHandler", ApiSince=24)>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_CERTIFICATES")>]
abstract member InstallKeyPair : Android.Content.ComponentName * Java.Security.IPrivateKey * Java.Security.Cert.Certificate[] * string * bool -> bool
override this.InstallKeyPair : Android.Content.ComponentName * Java.Security.IPrivateKey * Java.Security.Cert.Certificate[] * string * bool -> bool

Parametri

admin
ComponentName

A quale DeviceAdminReceiver richiesta è associata o null se il chiamante non è un amministratore del dispositivo.

privKey
IPrivateKey

Chiave privata da installare.

certs
Certificate[]

Catena di certificati da installare. La catena deve iniziare con il certificato foglia e includere la catena di attendibilità in ordine. Verrà restituito da android.security.KeyChain#getCertificateChain.

alias
String

Alias della chiave privata in cui installare il certificato. Se esiste già un certificato con tale alias, verrà sovrascritto.

requestAccess
Boolean

true per richiedere che all'app chiamante venga concesso immediatamente l'accesso alle credenziali. In caso contrario, l'accesso alle credenziali verrà gestito dall'approvazione dell'utente.

Restituisce

true se le chiavi sono state installate, false in caso contrario.

Attributi

Commenti

Questa API può essere chiamata dal comando seguente per installare una catena di certificati e la chiave privata corrispondente per il certificato foglia: ul>li Proprietario dispositivo/li>Profilo proprietario<</li Li Programma di installazione< del certificato delegato/li><><>>li App di gestione< delle credenziali/li<>>App che contiene l'autorizzazione<android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES/li<>></ul>><< Tutte le app all'interno del profilo potranno accedere alla catena di certificati e usare la chiave privata, data l'approvazione diretta dell'utente.

Da Android android.os.Build.VERSION_CODES#Sl'app di gestione delle credenziali può chiamare questa API. Tuttavia, questa API imposta la coppia di chiavi come selezionabile dall'utente per impostazione predefinita, che non è consentita quando viene chiamata dall'app di gestione delle credenziali. Al contrario, #installKeyPair(ComponentName, PrivateKey, Certificate[], String, int) deve essere chiamato con #INSTALLKEY_SET_USER_SELECTABLE non impostato come flag. Si noti che può essere presente solo un'app di gestione delle credenziali in un dispositivo non gestito.

Il chiamante di questa API può concedere immediatamente l'accesso al certificato e alla chiave privata, senza l'approvazione dell'utente. È consigliabile non richiederlo, a meno che non sia strettamente necessario, perché apre ulteriori vulnerabilità di sicurezza.

Nota: se l'oggetto fornito alias è di un alias esistente, tutte le precedenti concessioni concesse alle app per accedere alla chiave e ai certificati associati a questo alias verranno revocate.

Documentazione java per android.app.admin.DevicePolicyManager.installKeyPair(android.content.ComponentName, java.security.PrivateKey, java.security.cert.Certificate[], java.lang.String, boolean).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Si applica a

InstallKeyPair(ComponentName, IPrivateKey, Certificate[], String, InstallKeyFlags)

Questa API può essere chiamata dal comando seguente per installare una catena di certificati e la chiave privata corrispondente per il certificato foglia: ul>li Proprietario dispositivo/li>Profilo proprietario<</li Li Programma di installazione< del certificato delegato/li><><>>li App di gestione< delle credenziali/li<>>App che contiene l'autorizzazione<android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES/li<>></ul>><< Tutte le app all'interno del profilo potranno accedere alla catena di certificati e usare la chiave privata, data l'approvazione diretta dell'utente (se l'utente è autorizzato a selezionare la chiave privata).

[Android.Runtime.Register("installKeyPair", "(Landroid/content/ComponentName;Ljava/security/PrivateKey;[Ljava/security/cert/Certificate;Ljava/lang/String;I)Z", "GetInstallKeyPair_Landroid_content_ComponentName_Ljava_security_PrivateKey_arrayLjava_security_cert_Certificate_Ljava_lang_String_IHandler", ApiSince=28)]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_CERTIFICATES")]
public virtual bool InstallKeyPair (Android.Content.ComponentName? admin, Java.Security.IPrivateKey privKey, Java.Security.Cert.Certificate[] certs, string alias, Android.App.Admin.InstallKeyFlags flags);
[<Android.Runtime.Register("installKeyPair", "(Landroid/content/ComponentName;Ljava/security/PrivateKey;[Ljava/security/cert/Certificate;Ljava/lang/String;I)Z", "GetInstallKeyPair_Landroid_content_ComponentName_Ljava_security_PrivateKey_arrayLjava_security_cert_Certificate_Ljava_lang_String_IHandler", ApiSince=28)>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_CERTIFICATES")>]
abstract member InstallKeyPair : Android.Content.ComponentName * Java.Security.IPrivateKey * Java.Security.Cert.Certificate[] * string * Android.App.Admin.InstallKeyFlags -> bool
override this.InstallKeyPair : Android.Content.ComponentName * Java.Security.IPrivateKey * Java.Security.Cert.Certificate[] * string * Android.App.Admin.InstallKeyFlags -> bool

Parametri

admin
ComponentName

A quale DeviceAdminReceiver richiesta è associata o null se il chiamante non è un amministratore del dispositivo.

privKey
IPrivateKey

Chiave privata da installare.

certs
Certificate[]

Catena di certificati da installare. La catena deve iniziare con il certificato foglia e includere la catena di attendibilità in ordine. Verrà restituito da android.security.KeyChain#getCertificateChain.

alias
String

Alias della chiave privata in cui installare il certificato. Se esiste già un certificato con tale alias, verrà sovrascritto.

flags
InstallKeyFlags

Flag per richiedere che all'app chiamante venga concesso l'accesso alle credenziali e impostare la chiave come selezionabile dall'utente. Controllare #INSTALLKEY_SET_USER_SELECTABLE e #INSTALLKEY_REQUEST_CREDENTIALS_ACCESS.

Restituisce

true se le chiavi sono state installate, false in caso contrario.

Attributi

Commenti

Questa API può essere chiamata dal comando seguente per installare una catena di certificati e la chiave privata corrispondente per il certificato foglia: ul>li Proprietario dispositivo/li>Profilo proprietario<</li Li Programma di installazione< del certificato delegato/li><><>>li App di gestione< delle credenziali/li<>>App che contiene l'autorizzazione<android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES/li<>></ul>><< Tutte le app all'interno del profilo potranno accedere alla catena di certificati e usare la chiave privata, data l'approvazione diretta dell'utente (se l'utente è autorizzato a selezionare la chiave privata).

Da Android android.os.Build.VERSION_CODES#Sl'app di gestione delle credenziali può chiamare questa API. Se viene chiamato dall'app di gestione delle credenziali: ul>li Il componentName deve essere nullr</li>><L'alias deve esistere nell'app<android.security.AppUriAuthenticationPolicy /li><li>La coppia di chiavi non deve essere selezionabile< dall'utente/li></ul> Nota, può esistere solo un'app di gestione delle credenziali in un dispositivo non gestito.><<

Il chiamante di questa API può concedere immediatamente l'accesso al certificato e alla chiave privata, senza l'approvazione dell'utente. È consigliabile non richiederlo, a meno che non sia strettamente necessario, perché apre ulteriori vulnerabilità di sicurezza.

Includere #INSTALLKEY_SET_USER_SELECTABLE nell'argomento per consentire all'utente flags di selezionare la chiave da una finestra di dialogo.

Nota: se l'oggetto fornito alias è di un alias esistente, tutte le precedenti concessioni concesse alle app per accedere alla chiave e ai certificati associati a questo alias verranno revocate.

Documentazione java per android.app.admin.DevicePolicyManager.installKeyPair(android.content.ComponentName, java.security.PrivateKey, java.security.cert.Certificate[], java.lang.String, int).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Si applica a

InstallKeyPair(ComponentName, IPrivateKey, Certificate, String)

Questa API può essere chiamata dal comando seguente per installare un certificato e la chiave privata corrispondente: <ul<>li>Proprietario del dispositivo/li>><Profilo proprietario<</li>><li Programma di installazione< del certificato delegato/li li App di gestione< delle credenziali/li>>><><Un'app che contiene l'autorizzazione<android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES/li></ul> Tutte le app all'interno del profilo sarà in grado di accedere al certificato e usare la chiave privata, dato l'approvazione diretta dell'utente.

[Android.Runtime.Register("installKeyPair", "(Landroid/content/ComponentName;Ljava/security/PrivateKey;Ljava/security/cert/Certificate;Ljava/lang/String;)Z", "GetInstallKeyPair_Landroid_content_ComponentName_Ljava_security_PrivateKey_Ljava_security_cert_Certificate_Ljava_lang_String_Handler")]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_CERTIFICATES")]
public virtual bool InstallKeyPair (Android.Content.ComponentName? admin, Java.Security.IPrivateKey privKey, Java.Security.Cert.Certificate cert, string alias);
[<Android.Runtime.Register("installKeyPair", "(Landroid/content/ComponentName;Ljava/security/PrivateKey;Ljava/security/cert/Certificate;Ljava/lang/String;)Z", "GetInstallKeyPair_Landroid_content_ComponentName_Ljava_security_PrivateKey_Ljava_security_cert_Certificate_Ljava_lang_String_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_CERTIFICATES")>]
abstract member InstallKeyPair : Android.Content.ComponentName * Java.Security.IPrivateKey * Java.Security.Cert.Certificate * string -> bool
override this.InstallKeyPair : Android.Content.ComponentName * Java.Security.IPrivateKey * Java.Security.Cert.Certificate * string -> bool

Parametri

admin
ComponentName

A quale DeviceAdminReceiver richiesta è associata o null se il chiamante non è un amministratore del dispositivo.

privKey
IPrivateKey

Chiave privata da installare.

cert
Certificate

Certificato da installare.

alias
String

Alias della chiave privata in cui installare il certificato. Se esiste già un certificato con tale alias, verrà sovrascritto.

Restituisce

true se le chiavi sono state installate, false in caso contrario.

Attributi

Commenti

Questa API può essere chiamata dal comando seguente per installare un certificato e la chiave privata corrispondente: <ul<>li>Proprietario del dispositivo/li>><Profilo proprietario<</li>><li Programma di installazione< del certificato delegato/li li App di gestione< delle credenziali/li>>><><Un'app che contiene l'autorizzazione<android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES/li></ul> Tutte le app all'interno del profilo sarà in grado di accedere al certificato e usare la chiave privata, dato l'approvazione diretta dell'utente.

Da Android android.os.Build.VERSION_CODES#Sl'app di gestione delle credenziali può chiamare questa API. Tuttavia, questa API imposta la coppia di chiavi come selezionabile dall'utente per impostazione predefinita, che non è consentita quando viene chiamata dall'app di gestione delle credenziali. Al contrario, #installKeyPair(ComponentName, PrivateKey, Certificate[], String, int) deve essere chiamato con #INSTALLKEY_SET_USER_SELECTABLE non impostato come flag.

L'accesso alle credenziali installate non verrà concesso al chiamante di questa API senza l'approvazione diretta dell'utente. Questo è per la sicurezza: se un programma di installazione del certificato diventa compromesso, i certificati già installati saranno protetti.

Se il programma di installazione deve avere accesso alle credenziali, chiamare #installKeyPair(ComponentName, PrivateKey, Certificate[], String, boolean) invece.

Nota: se l'oggetto fornito alias è di un alias esistente, tutte le precedenti concessioni concesse alle app per accedere alla chiave e ai certificati associati a questo alias verranno revocate.

Documentazione java per android.app.admin.DevicePolicyManager.installKeyPair(android.content.ComponentName, java.security.PrivateKey, java.security.cert.Certificate, java.lang.String).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Si applica a