Comparteix via


DevicePolicyManager.InstallKeyPair Método

Definición

Sobrecargas

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

Puede llamar a esta API para instalar una cadena de certificados y la clave privada correspondiente para el certificado hoja: ul>li Device owner</li><li>Li Profile owner</li><>Li Delegated certificate installer</li li><>Credential management app</li li><>Li Li Una aplicación que contiene el android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES permiso</li></ul>><< Todas las aplicaciones del perfil podrán acceder a la cadena de certificados y usar la clave privada, dada la aprobación directa del usuario.

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

Puede llamar a esta API para instalar una cadena de certificados y la clave privada correspondiente para el certificado hoja: ul>li Device owner</li><li>Li Profile owner</li><>Li Delegated certificate installer</li li><>Credential management app</li li><>Li Li Una aplicación que contiene el android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES permiso</li></ul>><< Todas las aplicaciones del perfil podrán acceder a la cadena de certificados y usar la clave privada, dada la aprobación directa del usuario (si el usuario puede seleccionar la clave privada).

InstallKeyPair(ComponentName, IPrivateKey, Certificate, String)

Puede llamar a esta API para instalar un certificado y la clave privada correspondiente: ul>li Li Device owner</li<>li>Li Profile owner</li><>Li Delegated certificate installer</li li><>Li Credential management app</li li<>>Li Una aplicación que contiene el android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES permiso</li></ul> Todas las aplicaciones dentro del perfil podrán acceder al certificado y usar la clave privada,><< dada la aprobación directa del usuario.

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

Puede llamar a esta API para instalar una cadena de certificados y la clave privada correspondiente para el certificado hoja: ul>li Device owner</li><li>Li Profile owner</li><>Li Delegated certificate installer</li li><>Credential management app</li li><>Li Li Una aplicación que contiene el android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES permiso</li></ul>><< Todas las aplicaciones del perfil podrán acceder a la cadena de certificados y usar la clave privada, dada la aprobación directa del usuario.

[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

Parámetros

admin
ComponentName

Al que DeviceAdminReceiver está asociada esta solicitud, o null si el autor de la llamada no es un administrador de dispositivos.

privKey
IPrivateKey

Clave privada que se va a instalar.

certs
Certificate[]

Cadena de certificados que se va a instalar. La cadena debe comenzar con el certificado hoja e incluir la cadena de confianza en orden. Este valor lo devolverá android.security.KeyChain#getCertificateChain.

alias
String

Alias de clave privada en el que se va a instalar el certificado. Si ya existe un certificado con ese alias, se sobrescribirá.

requestAccess
Boolean

true para solicitar que la aplicación que realiza la llamada tenga acceso a las credenciales inmediatamente. De lo contrario, el acceso a las credenciales se puertará mediante la aprobación del usuario.

Devoluciones

true si se instalaron las claves; de lo contrario, false .

Atributos

Comentarios

Puede llamar a esta API para instalar una cadena de certificados y la clave privada correspondiente para el certificado hoja: ul>li Device owner</li><li>Li Profile owner</li><>Li Delegated certificate installer</li li><>Credential management app</li li><>Li Li Una aplicación que contiene el android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES permiso</li></ul>><< Todas las aplicaciones del perfil podrán acceder a la cadena de certificados y usar la clave privada, dada la aprobación directa del usuario.

Desde Android android.os.Build.VERSION_CODES#S, la aplicación de administración de credenciales puede llamar a esta API. Sin embargo, esta API establece el par de claves como seleccionable por el usuario de forma predeterminada, que no se permite cuando la aplicación de administración de credenciales la llama. En su lugar, #installKeyPair(ComponentName, PrivateKey, Certificate[], String, int) se debe llamar a con #INSTALLKEY_SET_USER_SELECTABLE no establecido como una marca. Tenga en cuenta que solo puede haber una aplicación de administración de credenciales en un dispositivo no administrado.

El autor de la llamada de esta API puede conceder acceso al certificado y a la clave privada inmediatamente, sin la aprobación del usuario. Se recomienda no solicitar esto a menos que sea estrictamente necesario, ya que abre vulnerabilidades de seguridad adicionales.

Nota: Si el proporcionado alias es de un alias existente, se revocarán todas las concesiones anteriores a las que se han concedido las aplicaciones para acceder a la clave y los certificados asociados a este alias.

Documentación de Java para android.app.admin.DevicePolicyManager.installKeyPair(android.content.ComponentName, java.security.PrivateKey, java.security.cert.Certificate[], java.lang.String, boolean).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

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

Puede llamar a esta API para instalar una cadena de certificados y la clave privada correspondiente para el certificado hoja: ul>li Device owner</li><li>Li Profile owner</li><>Li Delegated certificate installer</li li><>Credential management app</li li><>Li Li Una aplicación que contiene el android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES permiso</li></ul>><< Todas las aplicaciones del perfil podrán acceder a la cadena de certificados y usar la clave privada, dada la aprobación directa del usuario (si el usuario puede seleccionar la clave privada).

[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

Parámetros

admin
ComponentName

Al que DeviceAdminReceiver está asociada esta solicitud, o null si el autor de la llamada no es un administrador de dispositivos.

privKey
IPrivateKey

Clave privada que se va a instalar.

certs
Certificate[]

Cadena de certificados que se va a instalar. La cadena debe comenzar con el certificado hoja e incluir la cadena de confianza en orden. Este valor lo devolverá android.security.KeyChain#getCertificateChain.

alias
String

Alias de clave privada en el que se va a instalar el certificado. Si ya existe un certificado con ese alias, se sobrescribirá.

flags
InstallKeyFlags

Marca para solicitar que se conceda acceso a la aplicación que realiza la llamada a las credenciales y establezca la clave para que sea seleccionable por el usuario. Consulte #INSTALLKEY_SET_USER_SELECTABLE y #INSTALLKEY_REQUEST_CREDENTIALS_ACCESS.

Devoluciones

true si se instalaron las claves; de lo contrario, false .

Atributos

Comentarios

Puede llamar a esta API para instalar una cadena de certificados y la clave privada correspondiente para el certificado hoja: ul>li Device owner</li><li>Li Profile owner</li><>Li Delegated certificate installer</li li><>Credential management app</li li><>Li Li Una aplicación que contiene el android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES permiso</li></ul>><< Todas las aplicaciones del perfil podrán acceder a la cadena de certificados y usar la clave privada, dada la aprobación directa del usuario (si el usuario puede seleccionar la clave privada).

Desde Android android.os.Build.VERSION_CODES#S, la aplicación de administración de credenciales puede llamar a esta API. Si lo llama la aplicación de administración de credenciales: ul>li El componentName debe ser nullr</li><li>El alias debe existir en el /li li><>de android.security.AppUriAuthenticationPolicy<la aplicación de administración de credenciales El par de claves no debe ser seleccionable< por el usuario/li></ul> Note, solo puede haber una aplicación de administración de credenciales en un dispositivo no administrado.><<

El autor de la llamada de esta API puede conceder acceso al certificado y a la clave privada inmediatamente, sin la aprobación del usuario. Se recomienda no solicitar esto a menos que sea estrictamente necesario, ya que abre vulnerabilidades de seguridad adicionales.

Incluya #INSTALLKEY_SET_USER_SELECTABLE en el flags argumento para permitir que el usuario seleccione la clave de un cuadro de diálogo.

Nota: Si el proporcionado alias es de un alias existente, se revocarán todas las concesiones anteriores a las que se han concedido las aplicaciones para acceder a la clave y los certificados asociados a este alias.

Documentación de Java para android.app.admin.DevicePolicyManager.installKeyPair(android.content.ComponentName, java.security.PrivateKey, java.security.cert.Certificate[], java.lang.String, int).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

InstallKeyPair(ComponentName, IPrivateKey, Certificate, String)

Puede llamar a esta API para instalar un certificado y la clave privada correspondiente: ul>li Li Device owner</li<>li>Li Profile owner</li><>Li Delegated certificate installer</li li><>Li Credential management app</li li<>>Li Una aplicación que contiene el android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES permiso</li></ul> Todas las aplicaciones dentro del perfil podrán acceder al certificado y usar la clave privada,><< dada la aprobación directa del usuario.

[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

Parámetros

admin
ComponentName

Al que DeviceAdminReceiver está asociada esta solicitud, o null si el autor de la llamada no es un administrador de dispositivos.

privKey
IPrivateKey

Clave privada que se va a instalar.

cert
Certificate

Certificado que se va a instalar.

alias
String

Alias de clave privada en el que se va a instalar el certificado. Si ya existe un certificado con ese alias, se sobrescribirá.

Devoluciones

true si se instalaron las claves; de lo contrario, false .

Atributos

Comentarios

Puede llamar a esta API para instalar un certificado y la clave privada correspondiente: ul>li Li Device owner</li<>li>Li Profile owner</li><>Li Delegated certificate installer</li li><>Li Credential management app</li li<>>Li Una aplicación que contiene el android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATES permiso</li></ul> Todas las aplicaciones dentro del perfil podrán acceder al certificado y usar la clave privada,><< dada la aprobación directa del usuario.

Desde Android android.os.Build.VERSION_CODES#S, la aplicación de administración de credenciales puede llamar a esta API. Sin embargo, esta API establece el par de claves como seleccionable por el usuario de forma predeterminada, que no se permite cuando la aplicación de administración de credenciales la llama. En su lugar, #installKeyPair(ComponentName, PrivateKey, Certificate[], String, int) se debe llamar a con #INSTALLKEY_SET_USER_SELECTABLE no establecido como una marca.

No se concederá acceso a las credenciales instaladas al autor de la llamada de esta API sin la aprobación directa del usuario. Esto es para la seguridad: si un instalador de certificados se pone en peligro, los certificados que ya tenía instalados estarán protegidos.

Si el instalador debe tener acceso a las credenciales, llame #installKeyPair(ComponentName, PrivateKey, Certificate[], String, boolean) a en su lugar.

Nota: Si el proporcionado alias es de un alias existente, se revocarán todas las concesiones anteriores a las que se han concedido las aplicaciones para acceder a la clave y los certificados asociados a este alias.

Documentación de Java para android.app.admin.DevicePolicyManager.installKeyPair(android.content.ComponentName, java.security.PrivateKey, java.security.cert.Certificate, java.lang.String).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a