Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 11 additions & 15 deletions eng/_util/cmd/updatecryptodocs/docs.go
Original file line number Diff line number Diff line change
Expand Up @@ -300,10 +300,12 @@ var doc = Document{
},
{
Name: "OAEP (SHA-3)",
Notes: []string{
"Supports only hash algorithms that are [supported as standalone hash functions](#hash-and-message-authentication-algorithms).",
},
MinGoVersion: "1.26",
Platforms: Platforms{
Windows: PlatformStatus{Supported: NotSupported},
Linux: PlatformStatus{Supported: NotSupported},
MacOS: PlatformStatus{Supported: NotSupported},
MacOS: PlatformStatus{Supported: NotSupported},
},
},
{
Expand Down Expand Up @@ -352,9 +354,11 @@ var doc = Document{
},
{
Name: "PSS (SHA-3)",
Notes: []string{
"Supports only hash algorithms that are [supported as standalone hash functions](#hash-and-message-authentication-algorithms).",
},
Platforms: Platforms{
Windows: PlatformStatus{Supported: NotSupported},
Linux: PlatformStatus{Supported: NotSupported},
Windows: PlatformStatus{MinGoVersion: "1.26"},
MacOS: PlatformStatus{Supported: NotSupported},
},
},
Expand All @@ -367,14 +371,6 @@ var doc = Document{
MacOS: PlatformStatus{Supported: NotSupported},
},
},
{
Name: "PKCS1v15 Signature (MD4)",
Platforms: Platforms{
Windows: PlatformStatus{Supported: NotSupported},
Linux: PlatformStatus{MinGoVersion: "1.24"},
MacOS: PlatformStatus{Supported: NotSupported},
},
},
{
Name: "PKCS1v15 Signature (MD5)",
Platforms: Platforms{
Expand All @@ -399,8 +395,8 @@ var doc = Document{
{
Name: "PKCS1v15 Signature (SHA-3)",
Platforms: Platforms{
Windows: PlatformStatus{Supported: NotSupported},
Linux: PlatformStatus{Supported: NotSupported},
Windows: PlatformStatus{MinVersion: "11 (24H2)", MinGoVersion: "1.26"},
Linux: PlatformStatus{MinVersion: "1.1.1"},
MacOS: PlatformStatus{Supported: NotSupported},
},
},
Expand Down
47 changes: 26 additions & 21 deletions eng/doc/CrossPlatformCryptography.md
Original file line number Diff line number Diff line change
Expand Up @@ -156,34 +156,39 @@ Please refer to the documentation of the underlying cryptographic library for th

Operations that require random numbers (rand io.Reader) only support [rand.Reader](https://pkg.go.dev/crypto/rand#Reader).

| Padding Mode | Windows | Linux | macOS |
| -------------------------------------- | -------------- | -------------- | -------------- |
| OAEP (MD5) | ✔️ | ✔️ | ✔️<sup>1</sup> |
| OAEP (SHA-1) | ✔️ | ✔️ | ✔️<sup>1</sup> |
| OAEP (SHA-2)<sup>2</sup> | ✔️ | ✔️ | ✔️<sup>1</sup> |
| OAEP (SHA-3) | ❌️ | ❌️ | ❌️ |
| PSS (MD5) | ✔️<sup>3</sup> | ✔️ | ❌️ |
| PSS (SHA-1) | ✔️<sup>3</sup> | ✔️ | ✔️<sup>4</sup> |
| PSS (SHA-2)<sup>2</sup> | ✔️<sup>3</sup> | ✔️ | ✔️<sup>4</sup> |
| PSS (SHA-3) | ❌️ | ❌️ | ❌️ |
| PKCS1v15 Signature (Unhashed) | ✔️ | ✔️ | ✔️ |
| PKCS1v15 Signature (RIPMED160) | ❌️ | ✔️<sup>5</sup> | ❌️ |
| PKCS1v15 Signature (MD4) | ❌️ | ✔️<sup>5</sup> | ❌️ |
| PKCS1v15 Signature (MD5) | ✔️ | ✔️ | ❌️ |
| PKCS1v15 Signature (MD5-SHA1) | ✔️<sup>5</sup> | ✔️<sup>5</sup> | ❌️ |
| PKCS1v15 Signature (SHA-1) | ✔️ | ✔️ | ✔️ |
| PKCS1v15 Signature (SHA-2)<sup>2</sup> | ✔️ | ✔️ | ✔️ |
| PKCS1v15 Signature (SHA-3) | ❌️ | ❌️ | ❌️ |
| Padding Mode | Windows | Linux | macOS |
| -------------------------------------- | ---------------- | -------------- | -------------- |
| OAEP (MD5) | ✔️ | ✔️ | ✔️<sup>1</sup> |
| OAEP (SHA-1) | ✔️ | ✔️ | ✔️<sup>1</sup> |
| OAEP (SHA-2)<sup>2</sup> | ✔️ | ✔️ | ✔️<sup>1</sup> |
| OAEP (SHA-3)<sup>2,3</sup> | ✔️ | ✔️ | ❌️ |
| PSS (MD5) | ✔️<sup>4</sup> | ✔️ | ❌️ |
| PSS (SHA-1) | ✔️<sup>4</sup> | ✔️ | ✔️<sup>5</sup> |
| PSS (SHA-2)<sup>2</sup> | ✔️<sup>4</sup> | ✔️ | ✔️<sup>5</sup> |
| PSS (SHA-3)<sup>2</sup> | ✔️<sup>3</sup> | ✔️ | ❌️ |
| PKCS1v15 Signature (Unhashed) | ✔️ | ✔️ | ✔️ |
| PKCS1v15 Signature (RIPMED160) | ❌️ | ✔️<sup>6</sup> | ❌️ |
| PKCS1v15 Signature (MD5) | ✔️ | ✔️ | ❌️ |
| PKCS1v15 Signature (MD5-SHA1) | ✔️<sup>6</sup> | ✔️<sup>6</sup> | ❌️ |
| PKCS1v15 Signature (SHA-1) | ✔️ | ✔️ | ✔️ |
| PKCS1v15 Signature (SHA-2)<sup>2</sup> | ✔️ | ✔️ | ✔️ |
| PKCS1v15 Signature (SHA-3) | ✔️<sup>3,7</sup> | ✔️<sup>8</sup> | ❌️ |

<sup>1</sup>macOS doesn't support passing a custom label to OAEP functions.

<sup>2</sup>Supports only hash algorithms that are [supported as standalone hash functions](#hash-and-message-authentication-algorithms).

<sup>3</sup>Verifying PSS signatures with [rsa.PSSSaltLengthAuto](https://pkg.go.dev/crypto/rsa#pkg-constants) is not supported.
<sup>3</sup>Available starting in the Microsoft build of Go 1.26.

<sup>4</sup>Verifying PSS signatures with [rsa.PSSSaltLengthAuto](https://pkg.go.dev/crypto/rsa#pkg-constants) is not supported.

<sup>5</sup>Custom salt lengths are not supported. PSS always uses the [`rsa.PSSSaltLengthEqualsHash`](https://pkg.go.dev/crypto/rsa#pkg-constants).

<sup>6</sup>Available starting in the Microsoft build of Go 1.24.

<sup>4</sup>Custom salt lengths are not supported. PSS always uses the [`rsa.PSSSaltLengthEqualsHash`](https://pkg.go.dev/crypto/rsa#pkg-constants).
<sup>7</sup>Requires Windows 11 (24H2) or later.

<sup>5</sup>Available starting in the Microsoft build of Go 1.24.
<sup>8</sup>Requires OpenSSL 1.1.1 or later.

### ECDSA

Expand Down
Loading
Loading