DevicePolicyManager.InstallKeyPair メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| Name | 説明 |
|---|---|
| InstallKeyPair(ComponentName, IPrivateKey, Certificate, String) |
この API は、証明書と対応する秘密キーをインストールするために呼び出すことができます。<ul><li>Device owner</li><li>Profile owner</li><li>Delegated certificate installer</ li><li>Credential 管理アプリ</li><li> |
| InstallKeyPair(ComponentName, IPrivateKey, Certificate[], String, InstallKeyFlags) |
この API は、リーフ証明書の証明書チェーンと対応する秘密キーをインストールするために呼び出すことができます:<ul><li>Device owner</li><li>Profile owner</li><li>li ><削除された証明書インストーラー</li><li>Credential 管理アプリ</li><li> |
| InstallKeyPair(ComponentName, IPrivateKey, Certificate[], String, Boolean) |
この API は、リーフ証明書の証明書チェーンと対応する秘密キーをインストールするために呼び出すことができます:<ul><li>Device owner</li><li>Profile owner</li><li>li ><削除された証明書インストーラー</li><li>Credential 管理アプリ</li><li> |
InstallKeyPair(ComponentName, IPrivateKey, Certificate, String)
この API は、証明書と対応する秘密キーをインストールするために呼び出すことができます。<ul><li>Device owner</li><li>Profile owner</li><li>Delegated certificate installer</ li><li>Credential 管理アプリ</li><li>android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATESアクセス許可を保持するアプリ</li></ul> プロファイル内のすべてのアプリは、証明書にアクセスして秘密キーを使用できます。 直接ユーザーの承認を得ることができます。
[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
パラメーター
- admin
- ComponentName
この要求が関連付けられている DeviceAdminReceiver 。呼び出し元がデバイス管理者でない場合は null 。
- privKey
- IPrivateKey
インストールする秘密キー。
- cert
- Certificate
インストールする証明書。
- alias
- String
証明書をインストールする秘密キーのエイリアス。 そのエイリアスを持つ証明書が既に存在する場合は、上書きされます。
返品
true キーがインストールされている場合は a0/ false 。それ以外の場合は。
- 属性
注釈
この API は、証明書と対応する秘密キーをインストールするために呼び出すことができます。<ul><li>Device owner</li><li>Profile owner</li><li>Delegated certificate installer</ li><li>Credential 管理アプリ</li><li>android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATESアクセス許可を保持するアプリ</li></ul> プロファイル内のすべてのアプリは、証明書にアクセスして秘密キーを使用できます。 直接ユーザーの承認を得ることができます。
Android android.os.Build.VERSION_CODES#Sから、資格情報管理アプリはこの API を呼び出すことができます。 ただし、この API は、資格情報管理アプリによって呼び出されたときに許可されない、既定で選択可能なユーザーとしてキー ペアを設定します。 代わりに、フラグとして設定されていない#INSTALLKEY_SET_USER_SELECTABLEで#installKeyPair(ComponentName, PrivateKey, Certificate[], String, int)を呼び出す必要があります。
インストールされている資格情報へのアクセスは、直接ユーザーの承認なしに、この API の呼び出し元には付与されません。 これはセキュリティのためです。証明書インストーラーが侵害された場合、既にインストールされている証明書は保護されます。
インストーラーが資格情報にアクセスできる必要がある場合は、代わりに #installKeyPair(ComponentName, PrivateKey, Certificate[], String, boolean) を呼び出します。
注: 指定された alias が既存のエイリアスの場合、このエイリアスに関連付けられているキーと証明書にアクセスするためにアプリが付与されていた以前の許可はすべて取り消されます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
InstallKeyPair(ComponentName, IPrivateKey, Certificate[], String, InstallKeyFlags)
この API は、リーフ証明書の証明書チェーンと対応する秘密キーをインストールするために呼び出すことができます:<ul><li>Device owner</li><li>Profile owner</li><li>li ><削除された証明書インストーラー</li><li>Credential 管理アプリ</li><li>android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATESアクセス許可を保持するアプリ</li/ul>プロファイル内のすべてのアプリは、(ユーザーが秘密キーの選択を許可されている場合) 直接ユーザーの承認を受けて、証明書チェーンにアクセスして秘密キーを使用できます。
[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
パラメーター
- admin
- ComponentName
この要求が関連付けられている DeviceAdminReceiver 。呼び出し元がデバイス管理者でない場合は null 。
- privKey
- IPrivateKey
インストールする秘密キー。
- certs
- Certificate[]
インストールする証明書チェーン。 チェーンはリーフ証明書から始まり、信頼のチェーンを順番に含める必要があります。 これは、 android.security.KeyChain#getCertificateChainによって返されます。
- alias
- String
証明書をインストールする秘密キーのエイリアス。 そのエイリアスを持つ証明書が既に存在する場合は、上書きされます。
- flags
- InstallKeyFlags
呼び出し元アプリに資格情報へのアクセスを許可し、キーをユーザーが選択できるように設定するように要求するフラグ。 「#INSTALLKEY_SET_USER_SELECTABLE」と「#INSTALLKEY_REQUEST_CREDENTIALS_ACCESS」を参照してください。
返品
true キーがインストールされている場合は a0/ false 。それ以外の場合は。
- 属性
注釈
この API は、リーフ証明書の証明書チェーンと対応する秘密キーをインストールするために呼び出すことができます:<ul><li>Device owner</li><li>Profile owner</li><li>li ><削除された証明書インストーラー</li><li>Credential 管理アプリ</li><li>android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATESアクセス許可を保持するアプリ</li/ul>プロファイル内のすべてのアプリは、(ユーザーが秘密キーの選択を許可されている場合) 直接ユーザーの承認を受けて、証明書チェーンにアクセスして秘密キーを使用できます。
Android android.os.Build.VERSION_CODES#Sから、資格情報管理アプリはこの API を呼び出すことができます。 資格情報管理アプリによって呼び出される場合: <ul><li>コンポーネント名は nullr</li><li>エイリアスは資格情報管理アプリの android.security.AppUriAuthenticationPolicy</li><li>に存在する必要がありますキーペアは、ユーザーが選択できる</li></ulである必要があります> アンマネージド デバイスには資格情報管理アプリしか存在できません。
この API の呼び出し元は、ユーザーの承認なしに、すぐに証明書と秘密キーへのアクセス権を自身に付与できます。 セキュリティの脆弱性が増えるので、厳密に必要でない限り、これを要求しないことをお勧めします。
flags引数に#INSTALLKEY_SET_USER_SELECTABLEを含め、ユーザーがダイアログからキーを選択できるようにします。
注: 指定された alias が既存のエイリアスの場合、このエイリアスに関連付けられているキーと証明書にアクセスするためにアプリが付与されていた以前の許可はすべて取り消されます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
InstallKeyPair(ComponentName, IPrivateKey, Certificate[], String, Boolean)
この API は、リーフ証明書の証明書チェーンと対応する秘密キーをインストールするために呼び出すことができます:<ul><li>Device owner</li><li>Profile owner</li><li>li ><削除された証明書インストーラー</li><li>Credential 管理アプリ</li><li>android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATESアクセス許可を保持するアプリ</li/ul>プロファイル内のすべてのアプリは、直接ユーザーの承認を受けて、証明書チェーンにアクセスし、秘密キーを使用できます。
[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
パラメーター
- admin
- ComponentName
この要求が関連付けられている DeviceAdminReceiver 。呼び出し元がデバイス管理者でない場合は null 。
- privKey
- IPrivateKey
インストールする秘密キー。
- certs
- Certificate[]
インストールする証明書チェーン。 チェーンはリーフ証明書から始まり、信頼のチェーンを順番に含める必要があります。 これは、 android.security.KeyChain#getCertificateChainによって返されます。
- alias
- String
証明書をインストールする秘密キーのエイリアス。 そのエイリアスを持つ証明書が既に存在する場合は、上書きされます。
- requestAccess
- Boolean
true 呼び出し元アプリに資格情報へのアクセスをすぐに許可するように要求する場合は 。 それ以外の場合、資格情報へのアクセスはユーザーの承認によって制限されます。
返品
true キーがインストールされている場合は a0/ false 。それ以外の場合は。
- 属性
注釈
この API は、リーフ証明書の証明書チェーンと対応する秘密キーをインストールするために呼び出すことができます:<ul><li>Device owner</li><li>Profile owner</li><li>li ><削除された証明書インストーラー</li><li>Credential 管理アプリ</li><li>android.Manifest.permission#MANAGE_DEVICE_POLICY_CERTIFICATESアクセス許可を保持するアプリ</li/ul>プロファイル内のすべてのアプリは、直接ユーザーの承認を受けて、証明書チェーンにアクセスし、秘密キーを使用できます。
Android android.os.Build.VERSION_CODES#Sから、資格情報管理アプリはこの API を呼び出すことができます。 ただし、この API は、資格情報管理アプリによって呼び出されたときに許可されない、既定で選択可能なユーザーとしてキー ペアを設定します。 代わりに、フラグとして設定されていない#INSTALLKEY_SET_USER_SELECTABLEで#installKeyPair(ComponentName, PrivateKey, Certificate[], String, int)を呼び出す必要があります。 アンマネージド デバイスには資格情報管理アプリしか存在できないことに注意してください。
この API の呼び出し元は、ユーザーの承認なしに、すぐに証明書と秘密キーへのアクセス権を自身に付与できます。 セキュリティの脆弱性が増えるので、厳密に必要でない限り、これを要求しないことをお勧めします。
注: 指定された alias が既存のエイリアスの場合、このエイリアスに関連付けられているキーと証明書にアクセスするためにアプリが付与されていた以前の許可はすべて取り消されます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。