diff options
Diffstat (limited to 'zh-cn/security/keystore/tags.html')
| -rw-r--r-- | zh-cn/security/keystore/tags.html | 15 |
1 files changed, 8 insertions, 7 deletions
diff --git a/zh-cn/security/keystore/tags.html b/zh-cn/security/keystore/tags.html index 1ffb2a55..d981413b 100644 --- a/zh-cn/security/keystore/tags.html +++ b/zh-cn/security/keystore/tags.html @@ -93,7 +93,7 @@ typedef enum { <p><strong>版本</strong>：1、2、3</p> <p><strong>是否可重复使用</strong>？否</p> -<p>当提供给 <a href="/security/keystore/implementer-ref#generate_key">generateKey</a> 或 <a href="/security/keystore/implementer-ref#import_key">importKey</a> 时，此标记用于指定使用相应密钥时必需的数据。具体来说就是，调用 <a href="/security/keystore/implementer-ref#export_key">exportKey</a> 和 <a href="/security/keystore/implementer-ref#get_key_characteristics">getKeyCharacteristics</a> 时需要为 <code>clientId</code> 参数提供相同的值，而调用 <a href="/security/keystore/implementer-ref#begin">begin</a> 时则需要提供此标记以及相同的相关数据（作为 <code>inParams</code> 集的一部分）。如果未收到正确的数据，则该函数会返回 <code>ErrorCode::INVALID_KEY_BLOB</code>。</p> +<p>当提供给 <a href="/security/keystore/implementer-ref#generate_key">generateKey</a> 或 <a href="/security/keystore/implementer-ref#import_key">importKey</a> 时，此标记用于指定任何时候使用相应密钥时必需的数据。具体来说就是，调用 <a href="/security/keystore/implementer-ref#export_key">exportKey</a> 和 <a href="/security/keystore/implementer-ref#get_key_characteristics">getKeyCharacteristics</a> 时需要为 <code>clientId</code> 参数提供相同的值，而调用 <a href="/security/keystore/implementer-ref#begin">begin</a> 时则需要提供此标记以及相同的相关数据（作为 <code>inParams</code> 集的一部分）。如果未收到正确的数据，则该函数会返回 <code>ErrorCode::INVALID_KEY_BLOB</code>。</p> <p>此标记的内容以加密形式绑定到相应密钥，这意味着，如果有不轨人士有权访问安全域的所有机密内容，但无权访问此标记的内容，必须要确保他们在不对此标记的内容进行暴力破解攻击的情况下无法解密相应密钥，应用可通过指定足够的高熵内容来防范这一行为。<em></em></p> @@ -104,7 +104,7 @@ typedef enum { <p><strong>版本</strong>：1、2、3</p> <p><strong>是否可重复使用</strong>？否</p> -<p>当提供给 <a href="/security/keystore/implementer-ref#generate_key">generateKey</a> 或 <a href="/security/keystore/implementer-ref#import_key">importKey</a> 时，此标记用于指定使用相应密钥时必需的数据。具体来说就是，调用 <a href="/security/keystore/implementer-ref#export_key">exportKey</a> 和 <a href="/security/keystore/implementer-ref#get_key_characteristics">getKeyCharacteristics</a> 时需要为 <code>clientId</code> 参数提供相同的值，而调用 <a href="/security/keystore/implementer-ref#begin">begin</a> 时则需要提供此标记以及相同的相关数据（作为 <code>inParams</code> 集的一部分）。如果未收到正确的数据，则该函数会返回 <code>ErrorCode::INVALID_KEY_BLOB</code>。</p> +<p>当提供给 <a href="/security/keystore/implementer-ref#generate_key">generateKey</a> 或 <a href="/security/keystore/implementer-ref#import_key">importKey</a> 时，此标记用于指定任何时候使用相应密钥时必需的数据。具体来说就是，调用 <a href="/security/keystore/implementer-ref#export_key">exportKey</a> 和 <a href="/security/keystore/implementer-ref#get_key_characteristics">getKeyCharacteristics</a> 时需要为 <code>clientId</code> 参数提供相同的值，而调用 <a href="/security/keystore/implementer-ref#begin">begin</a> 时则需要提供此标记以及相同的相关数据（作为 <code>inParams</code> 集的一部分）。如果未收到正确的数据，则该函数会返回 <code>ErrorCode::INVALID_KEY_BLOB</code>。</p> <p>此标记的内容以加密形式绑定到相应密钥，这意味着，即使有不轨人士有权访问安全域的所有机密内容，也应无权访问此标记的内容，必须要确保他们无法解密相应密钥（在不对此标记的内容进行暴力破解攻击的情况下）。<em></em></p> @@ -396,7 +396,8 @@ P_521 = 3, <p><strong>是否可重复使用</strong>？否</p> <p>用于指定相应密钥的大小（以位数计，按适用于相应密钥算法的一般方式衡量）。例如，对于 RSA 密钥，<code>Tag::KEY_SIZE</code> 用于指定公开模数的大小。对于 AES 密钥，此标记用于指定密钥私密材料的长度。</p> -<p class="note">在 Keymaster 2 及更高版本中，<code>Tag::KEY_SIZE</code> 不再是选择 ECC（椭圆曲线加密）曲线的首选机制。虽然对于其他密钥类型而言没有变化，但 ECC 曲线是使用标记 <a href="#ec_curve"><code>Tag::EC_CURVE</code></a> 选择的。</p> +<p class="note">在 Keymaster 2 及更高版本中，<code>Tag::KEY_SIZE</code> 不再是选择 ECC（椭圆曲线加密）曲线的首选机制。 +虽然对于其他密钥类型而言没有变化，但 ECC 曲线是使用标记 <a href="#ec_curve"><code>Tag::EC_CURVE</code></a> 选择的。</p> <h2 id="mac_length">Tag::MAC_LENGTH</h2> @@ -504,7 +505,7 @@ typedef enum { <p><strong>版本</strong>：1、2、3</p> <p><strong>是否可重复使用</strong>？否</p> -<p>用于指定相应密钥无法再用于签名和加密目的的过期日期和时间。如果向 <a href="/security/keystore/implementer-ref#begin">begin</a> 提供的目的是 <a href="#purpose">KeyPurpose::SIGN</a> 或 <a href="#purpose">KeyPurpose::ENCRYPT</a>，那么在此之后，尝试使用相应密钥时，操作会失败并显示 <code>ErrorCode::KEY_EXPIRED</code>。</p> +<p>用于指定相应密钥无法再用于签名和加密目的的过期日期和时间。在此之后，如果尝试使用提供给 <a href="/security/keystore/implementer-ref#begin">begin</a> 的带 <a href="#purpose">KeyPurpose::SIGN</a> 或 <a href="#purpose">KeyPurpose::ENCRYPT</a> 的密钥，操作会失败并显示 <code>ErrorCode::KEY_EXPIRED</code>。</p> <p>此标记的值是一个 64 位的整数，表示距 1970 年 1 月 1 日的毫秒数。</p> @@ -517,7 +518,7 @@ typedef enum { <p>该标记的值是形式为 YYYYMM 的整数，其中 YYYY 表示上次更新时间的四位数年份，MM 表示上次更新时间的两位数月份。例如，对于上次更新时间为 2015 年 12 月的 Android 设备上生成的密钥，其值将表示为 201512。</p> -<p>如果密钥的补丁程序级别与当前补丁程序级别不同，则该密钥不可用。尝试使用此类密钥会导致 <a href="/security/keystore/implementer-ref#begin">begin</a>、<a href="/security/keystore/implementer-ref#get_key_characteristics">getKeyCharacteristics</a> 或 <a href="/security/keystore/implementer-ref#export_key">exportKey</a> 返回 <code>ErrorCode::KEY_REQUIRES_UPGRADE</code>。要了解详情，请参阅<a href="/security/keystore/version-binding">版本绑定</a>。</p> +<p>如果密钥的补丁程序级别与当前补丁程序级别不同，则该密钥不可用。尝试使用此类密钥会导致 <a href="/security/keystore/implementer-ref#begin">begin</a>、<a href="/security/keystore/implementer-ref#get_key_characteristics">getKeyCharacteristics</a> 或 <a href="/security/keystore/implementer-ref#export_key">exportKey</a> 返回 <code>ErrorCode::KEY_REQUIRES_UPGRADE</code>。如需了解更多详情，请参阅<a href="/security/keystore/version-binding">版本绑定</a>。</p> <h2 id="os_version">Tag::OS_VERSION</h2> @@ -652,7 +653,7 @@ typedef enum { <p><strong>版本</strong>：1、2、3</p> <p><strong>是否可重复使用</strong>？否</p> -<p>用于指定相应密钥无法再用于验证和解密目的的过期日期和时间。如果向 <a href="/security/keystore/implementer-ref#begin">begin</a> 提供的目的是 <a href="#purpose">KeyPurpose::VERIFY</a> 或 <a href="#purpose">KeyPurpose::DECRYPT</a>，那么在此之后，尝试使用相应密钥时，操作会失败并显示 <code>ErrorCode::KEY_EXPIRED</code>。</p> +<p>用于指定相应密钥无法再用于验证和解密目的的过期日期和时间。在此之后，如果尝试使用提供给 <a href="/security/keystore/implementer-ref#begin">begin</a> 的带 <a href="#purpose">KeyPurpose::VERIFY</a> 或 <a href="#purpose">KeyPurpose::DECRYPT</a> 的密钥，操作会失败并显示 <code>ErrorCode::KEY_EXPIRED</code>。</p> <p>此标记的值是一个 64 位的整数，表示距 1970 年 1 月 1 日的毫秒数。</p> @@ -693,7 +694,7 @@ typedef enum { <p>用于指定只能在某个安全的用户身份验证状态下使用相应密钥。此标记与 <a href="#no_auth_required">Tag::NO_AUTH_REQUIRED</a> 互斥。</p> -<p>此标记的值是一个 64 位的整数，用于指定在通过 <a href="#auth_token">Tag::AUTH_TOKEN</a> 向 <a href="/security/keystore/implementer-ref#begin">begin</a> 提供的身份验证令牌中必须存在哪个身份验证政策状态值，身份验证程序才会授权使用相应密钥。如果在调用 <a href="/security/keystore/implementer-ref#begin">begin</a> 时未提供身份验证令牌，或提供的身份验证令牌没有匹配的政策状态值，但所用密钥带有此标记，则该调用失败。</p> +<p>此标记的值是一个 64 位的整数，用于指定在通过 <a href="/security/keystore/implementer-ref#begin">Tag::AUTH_TOKEN</a> 向 <a href="#auth_token">begin</a> 提供的身份验证令牌中必须存在哪个身份验证政策状态值，身份验证程序才会授权使用相应密钥。如果在调用 <a href="/security/keystore/implementer-ref#begin">begin</a> 时未提供身份验证令牌，或提供的身份验证令牌没有匹配的政策状态值，但所用密钥带有此标记，则该调用失败。</p> <p>此标记可重复使用。如果提供的值中有任何一个与身份验证令牌中的任何政策状态值一致，身份验证程序即会授权使用相应密钥。否则，操作会失败并显示 <code>ErrorCode::KEY_USER_NOT_AUTHENTICATED</code>。</p> |