From 4ab3f07396b09b7c0a8084b6d461775514326aae Mon Sep 17 00:00:00 2001 From: fuchunhui Date: Tue, 21 Jan 2025 10:51:29 +0800 Subject: [PATCH 1/3] [zh-cn]: create docs for RsaHashedKeyGenParams and RsaHashedImportParams --- .../web/api/rsahashedimportparams/index.md | 38 +++++++++++++++++ .../web/api/rsahashedkeygenparams/index.md | 41 +++++++++++++++++++ 2 files changed, 79 insertions(+) create mode 100644 files/zh-cn/web/api/rsahashedimportparams/index.md create mode 100644 files/zh-cn/web/api/rsahashedkeygenparams/index.md diff --git a/files/zh-cn/web/api/rsahashedimportparams/index.md b/files/zh-cn/web/api/rsahashedimportparams/index.md new file mode 100644 index 00000000000000..f6b7a600426f69 --- /dev/null +++ b/files/zh-cn/web/api/rsahashedimportparams/index.md @@ -0,0 +1,38 @@ +--- +title: RsaHashedImportParams +slug: Web/API/RsaHashedImportParams +l10n: + sourceCommit: 802b6063046dffb7634d2138aadcd92cb22ed40c +--- + +{{ APIRef("Web Crypto API") }} + +[Web Crypto API](/zh-CN/docs/Web/API/Web_Crypto_API) 的 **`RsaHashedImportParams`** 字典表示在生成任何基于 RSA 的密钥对时，对象应该以 `algorithm` 参数传递给 {{domxref("SubtleCrypto.importKey()")}} 或 {{domxref("SubtleCrypto.unwrapKey()")}}：即当算法被标记为 [RSASSA-PKCS1-v1_5](/zh-CN/docs/Web/API/SubtleCrypto/sign#rsassa-pkcs1-v1_5)、[RSA-PSS](/zh-CN/docs/Web/API/SubtleCrypto/sign#rsa-pss) 或 [RSA-OAEP](/zh-CN/docs/Web/API/SubtleCrypto/encrypt#rsa-oaep) 中的任一种时。 + +## 实例属性 + +- `name` + - : 一个字符串，应设置为 `RSASSA-PKCS1-v1_5`、`RSA-PSS` 或 `RSA-OAEP`，依据你想要使用的算法。 +- `hash` + + - : 一个表示要使用的[摘要函数](/zh-CN/docs/Web/API/SubtleCrypto/digest)名称的字符串。可以是 `SHA-256`、`SHA-384` 或 `SHA-512` 中任意一个。 + + > [!WARNING] + > 从技术上讲，虽然你可以在这里传递 `SHA-1`，但强烈建议不要这样做，因为它被认为是脆弱的。 + +## 示例 + +参见 {{domxref("SubtleCrypto.importKey()")}} 的示例。 + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +支持在 {{domxref("SubtleCrypto.importKey()")}} 或 {{domxref("SubtleCrypto.unwrapKey()")}} 方法中使用任何基于 RSA 算法的浏览器将会支持此类型。 + +## 参见 + +- {{domxref("SubtleCrypto.importKey()")}} +- {{domxref("SubtleCrypto.unwrapKey()")}} diff --git a/files/zh-cn/web/api/rsahashedkeygenparams/index.md b/files/zh-cn/web/api/rsahashedkeygenparams/index.md new file mode 100644 index 00000000000000..e1c3d852da23f8 --- /dev/null +++ b/files/zh-cn/web/api/rsahashedkeygenparams/index.md @@ -0,0 +1,41 @@ +--- +title: RsaHashedKeyGenParams +slug: Web/API/RsaHashedKeyGenParams +l10n: + sourceCommit: f2088b8912ef205a737551441d54b73507bd3ac6 +--- + +{{ APIRef("Web Crypto API") }} + +[Web Crypto API](/zh-CN/docs/Web/API/Web_Crypto_API) 的 **`RsaHashedKeyGenParams`** 字典表示在生成任何基于 RSA 的密钥对时，对象应该以 `algorithm` 参数传递给 {{domxref("SubtleCrypto.generateKey()")}}：即当算法被标记为 [RSASSA-PKCS1-v1_5](/zh-CN/docs/Web/API/SubtleCrypto/sign#rsassa-pkcs1-v1_5)、[RSA-PSS](/zh-CN/docs/Web/API/SubtleCrypto/sign#rsa-pss) 或 [RSA-OAEP](/zh-CN/docs/Web/API/SubtleCrypto/encrypt#rsa-oaep) 中的任一种时。 + +## 实例属性 + +- `name` + - : 一个字符串，应设置为 `RSASSA-PKCS1-v1_5`、`RSA-PSS` 或 `RSA-OAEP`，依据你想要使用的算法。 +- `modulusLength` + - : 一个 `Number`。RSA 模数的位长度。此长度应至少为 2048 位：例如，请参见 [SP 800-131A Rev. 2](https://csrc.nist.gov/pubs/sp/800/131/a/r2/final)。一些组织现在建议此长度应为 4096 位。 +- `publicExponent` + - : 一个 {{jsxref("Uint8Array")}}。公共指数。除非你有充分的理由使用此值，否则请在此处指定 65537（即 `[0x01, 0x00, 0x01]`）。 +- `hash` + + - : 一个表示要使用的[摘要函数](/zh-CN/docs/Web/API/SubtleCrypto/digest)名称的字符串。可以传递 `SHA-256`、`SHA-384` 或 `SHA-512` 中任意一个。 + + > [!WARNING] + > 从技术上讲，虽然你可以在这里传递 `SHA-1`，但强烈建议不要这样做，因为它被认为是脆弱的。 + +## 示例 + +参见 {{domxref("SubtleCrypto.generateKey()")}} 的示例。 + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +支持在 {{domxref("SubtleCrypto.generateKey()")}} 方法中使用任何基于 RSA 算法的浏览器将会支持此类型。 + +## 参见 + +- {{domxref("SubtleCrypto.generateKey()")}} From ec9c627366133f5be23b8c7900440e305117f33a Mon Sep 17 00:00:00 2001 From: Chunhui Fu Date: Fri, 7 Mar 2025 17:28:04 +0800 Subject: [PATCH 2/3] Apply suggestions from code review Co-authored-by: A1lo --- files/zh-cn/web/api/rsahashedimportparams/index.md | 2 +- files/zh-cn/web/api/rsahashedkeygenparams/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/files/zh-cn/web/api/rsahashedimportparams/index.md b/files/zh-cn/web/api/rsahashedimportparams/index.md index f6b7a600426f69..8dd96bd426ebc7 100644 --- a/files/zh-cn/web/api/rsahashedimportparams/index.md +++ b/files/zh-cn/web/api/rsahashedimportparams/index.md @@ -7,7 +7,7 @@ l10n: {{ APIRef("Web Crypto API") }} -[Web Crypto API](/zh-CN/docs/Web/API/Web_Crypto_API) 的 **`RsaHashedImportParams`** 字典表示在生成任何基于 RSA 的密钥对时，对象应该以 `algorithm` 参数传递给 {{domxref("SubtleCrypto.importKey()")}} 或 {{domxref("SubtleCrypto.unwrapKey()")}}：即当算法被标记为 [RSASSA-PKCS1-v1_5](/zh-CN/docs/Web/API/SubtleCrypto/sign#rsassa-pkcs1-v1_5)、[RSA-PSS](/zh-CN/docs/Web/API/SubtleCrypto/sign#rsa-pss) 或 [RSA-OAEP](/zh-CN/docs/Web/API/SubtleCrypto/encrypt#rsa-oaep) 中的任一种时。 +[Web Crypto API](/zh-CN/docs/Web/API/Web_Crypto_API) 的 **`RsaHashedImportParams`** 字典表示在生成任何基于 RSA 的密钥对时（即当算法被标记为 [RSASSA-PKCS1-v1_5](/zh-CN/docs/Web/API/SubtleCrypto/sign#rsassa-pkcs1-v1_5)、[RSA-PSS](/zh-CN/docs/Web/API/SubtleCrypto/sign#rsa-pss) 或 [RSA-OAEP](/zh-CN/docs/Web/API/SubtleCrypto/encrypt#rsa-oaep) 中的任一种时），应该以 `algorithm` 参数传递给 {{domxref("SubtleCrypto.importKey()")}} 或 {{domxref("SubtleCrypto.unwrapKey()")}} 的对象。 ## 实例属性 diff --git a/files/zh-cn/web/api/rsahashedkeygenparams/index.md b/files/zh-cn/web/api/rsahashedkeygenparams/index.md index e1c3d852da23f8..e6de89b218d425 100644 --- a/files/zh-cn/web/api/rsahashedkeygenparams/index.md +++ b/files/zh-cn/web/api/rsahashedkeygenparams/index.md @@ -7,7 +7,7 @@ l10n: {{ APIRef("Web Crypto API") }} -[Web Crypto API](/zh-CN/docs/Web/API/Web_Crypto_API) 的 **`RsaHashedKeyGenParams`** 字典表示在生成任何基于 RSA 的密钥对时，对象应该以 `algorithm` 参数传递给 {{domxref("SubtleCrypto.generateKey()")}}：即当算法被标记为 [RSASSA-PKCS1-v1_5](/zh-CN/docs/Web/API/SubtleCrypto/sign#rsassa-pkcs1-v1_5)、[RSA-PSS](/zh-CN/docs/Web/API/SubtleCrypto/sign#rsa-pss) 或 [RSA-OAEP](/zh-CN/docs/Web/API/SubtleCrypto/encrypt#rsa-oaep) 中的任一种时。 +[Web Crypto API](/zh-CN/docs/Web/API/Web_Crypto_API) 的 **`RsaHashedKeyGenParams`** 字典表示在生成任何基于 RSA 的密钥对时（即当算法被标记为 [RSASSA-PKCS1-v1_5](/zh-CN/docs/Web/API/SubtleCrypto/sign#rsassa-pkcs1-v1_5)、[RSA-PSS](/zh-CN/docs/Web/API/SubtleCrypto/sign#rsa-pss) 或 [RSA-OAEP](/zh-CN/docs/Web/API/SubtleCrypto/encrypt#rsa-oaep) 中的任一种时），应该以 `algorithm` 参数传递给 {{domxref("SubtleCrypto.generateKey()")}} 的对象。 ## 实例属性 From 57b24790cd848ff8411ba737cb65c13348f9c2d9 Mon Sep 17 00:00:00 2001 From: Allo Date: Sun, 9 Mar 2025 09:38:07 +0800 Subject: [PATCH 3/3] minor fixes --- files/zh-cn/web/api/rsahashedimportparams/index.md | 12 ++++++++---- files/zh-cn/web/api/rsahashedkeygenparams/index.md | 12 ++++++++---- 2 files changed, 16 insertions(+), 8 deletions(-) diff --git a/files/zh-cn/web/api/rsahashedimportparams/index.md b/files/zh-cn/web/api/rsahashedimportparams/index.md index 8dd96bd426ebc7..ef318d73da9e76 100644 --- a/files/zh-cn/web/api/rsahashedimportparams/index.md +++ b/files/zh-cn/web/api/rsahashedimportparams/index.md @@ -2,7 +2,7 @@ title: RsaHashedImportParams slug: Web/API/RsaHashedImportParams l10n: - sourceCommit: 802b6063046dffb7634d2138aadcd92cb22ed40c + sourceCommit: 8e49db2182a5ad4ddfcaecdefd3d2d67db20f213 --- {{ APIRef("Web Crypto API") }} @@ -12,13 +12,17 @@ l10n: ## 实例属性 - `name` - - : 一个字符串，应设置为 `RSASSA-PKCS1-v1_5`、`RSA-PSS` 或 `RSA-OAEP`，依据你想要使用的算法。 + - : 一个字符串。应依据你想要使用的算法，设置为 `RSASSA-PKCS1-v1_5`、`RSA-PSS` 或 `RSA-OAEP`。 - `hash` - - : 一个表示要使用的[摘要函数](/zh-CN/docs/Web/API/SubtleCrypto/digest)名称的字符串。可以是 `SHA-256`、`SHA-384` 或 `SHA-512` 中任意一个。 + - : 一个字符串或一个包含单个名为 `name` 且具有字符串值的属性的对象。表示要使用的[摘要函数](/zh-CN/docs/Web/API/SubtleCrypto/digest)名称的字符串。可以是以下值之一： + + - `SHA-256`：选择 [SHA-256](/zh-CN/docs/Web/API/SubtleCrypto/digest#支持的算法) 算法。 + - `SHA-384`：选择 [SHA-384](/zh-CN/docs/Web/API/SubtleCrypto/digest#支持的算法) 算法。 + - `SHA-512`：选择 [SHA-512](/zh-CN/docs/Web/API/SubtleCrypto/digest#支持的算法) 算法。 > [!WARNING] - > 从技术上讲，虽然你可以在这里传递 `SHA-1`，但强烈建议不要这样做，因为它被认为是脆弱的。 + > 此处也支持 `SHA-1`，但 [SHA-1](/zh-CN/docs/Web/API/SubtleCrypto/digest#支持的算法) 算法被认为是脆弱的，应该不再使用。 ## 示例 diff --git a/files/zh-cn/web/api/rsahashedkeygenparams/index.md b/files/zh-cn/web/api/rsahashedkeygenparams/index.md index e6de89b218d425..fe3202951f6876 100644 --- a/files/zh-cn/web/api/rsahashedkeygenparams/index.md +++ b/files/zh-cn/web/api/rsahashedkeygenparams/index.md @@ -2,7 +2,7 @@ title: RsaHashedKeyGenParams slug: Web/API/RsaHashedKeyGenParams l10n: - sourceCommit: f2088b8912ef205a737551441d54b73507bd3ac6 + sourceCommit: 8e49db2182a5ad4ddfcaecdefd3d2d67db20f213 --- {{ APIRef("Web Crypto API") }} @@ -12,17 +12,21 @@ l10n: ## 实例属性 - `name` - - : 一个字符串，应设置为 `RSASSA-PKCS1-v1_5`、`RSA-PSS` 或 `RSA-OAEP`，依据你想要使用的算法。 + - : 一个字符串。应依据你想要使用的算法，设置为 `RSASSA-PKCS1-v1_5`、`RSA-PSS` 或 `RSA-OAEP`。 - `modulusLength` - : 一个 `Number`。RSA 模数的位长度。此长度应至少为 2048 位：例如，请参见 [SP 800-131A Rev. 2](https://csrc.nist.gov/pubs/sp/800/131/a/r2/final)。一些组织现在建议此长度应为 4096 位。 - `publicExponent` - : 一个 {{jsxref("Uint8Array")}}。公共指数。除非你有充分的理由使用此值，否则请在此处指定 65537（即 `[0x01, 0x00, 0x01]`）。 - `hash` - - : 一个表示要使用的[摘要函数](/zh-CN/docs/Web/API/SubtleCrypto/digest)名称的字符串。可以传递 `SHA-256`、`SHA-384` 或 `SHA-512` 中任意一个。 + - : 一个字符串或一个包含单个名为 `name` 且具有字符串值的属性的对象。表示要使用的[摘要函数](/zh-CN/docs/Web/API/SubtleCrypto/digest)的字符串。可以是以下值之一： + + - `SHA-256`：选择 [SHA-256](/zh-CN/docs/Web/API/SubtleCrypto/digest#支持的算法) 算法。 + - `SHA-384`：选择 [SHA-384](/zh-CN/docs/Web/API/SubtleCrypto/digest#支持的算法) 算法。 + - `SHA-512`：选择 [SHA-512](/zh-CN/docs/Web/API/SubtleCrypto/digest#支持的算法) 算法。 > [!WARNING] - > 从技术上讲，虽然你可以在这里传递 `SHA-1`，但强烈建议不要这样做，因为它被认为是脆弱的。 + > 此处也支持 `SHA-1`，但 [SHA-1](/zh-CN/docs/Web/API/SubtleCrypto/digest#支持的算法) 算法被认为是脆弱的，应该不再使用。 ## 示例