Cryptographic API Functions/en - Versionsgeschichte

Cg: /* Class-Side Utility Protocol */

2025-04-02T00:15:59Z

Class-Side Utility Protocol

Cg: /* Others... */

2023-07-05T09:50:42Z

Others...

← Nächstältere Version		Version vom 5. Juli 2023, 09:50 Uhr
Zeile 155:		Zeile 155:

	=== Others... ===		=== Others... ===
	Many more ciphers are available; open a browser or evaluate "<code>Cipher allSubclasses</code>".		Many more ciphers are available; open a browser or evaluate "<code>Cipher allSubclasses inspect</code>" in a workspace.

	= Certificate Handling =		= Certificate Handling =

Cg: /* Hashing */

2023-07-05T09:43:39Z

Hashing

← Nächstältere Version		Version vom 5. Juli 2023, 09:43 Uhr
Zeile 13:		Zeile 13:
	Available hash classes are (among many others): <code>MD5Stream</code>, <code>SHA1Stream</code>, <code>SHA256Stream</code>, <code>SHA512Stream</code>, <code>RipeMD160Stream</code>, <code>SipHashStream</code>, <code>WhirlpoolStream</code> etc.		Available hash classes are (among many others): <code>MD5Stream</code>, <code>SHA1Stream</code>, <code>SHA256Stream</code>, <code>SHA512Stream</code>, <code>RipeMD160Stream</code>, <code>SipHashStream</code>, <code>WhirlpoolStream</code> etc.

	Open a class browser or evaluate "<code>HashStream allSubclasses</code>" to see them all.		Open a class browser or evaluate "<code>HashStream allSubclasses inspect</code>" to see them all.
	<br>eXept may provide additional hash classes upon request.		<br>eXept may provide additional hash classes upon request.

Cg: /* Hashing */

2023-07-05T09:43:02Z

Hashing

← Nächstältere Version		Version vom 5. Juli 2023, 09:43 Uhr
Zeile 7:		Zeile 7:
	All hash algorithms are accessed the same way, by either sending one of the convenient utility messages to a hash-stream-class, or by instantiating a hash stream and sending it the data to be hashed (byte-wise or block-wise).		All hash algorithms are accessed the same way, by either sending one of the convenient utility messages to a hash-stream-class, or by instantiating a hash stream and sending it the data to be hashed (byte-wise or block-wise).

	The utility messages are easier to use, but require the data ~~to be hashed~~ to be already present in a byte- or character collection (i.e. in memory), which may be inefficient or impossible, if big chunks are to be hashed.		The utility messages are easier to use, but require the hhash data to be already present in a byte- or character collection (i.e. in memory), which may be inefficient or impossible, if big chunks are to be hashed.

	The instance messages allow for streams of unknown length to be hashed, to preinitialize the parameters and to fetch/reset the hash value during the operation.		The instance messages allow for streams of unknown length to be hashed, to preinitialize the parameters and to fetch/reset the hash value during the operation.

Cg: /* Hashing */

2023-07-05T09:42:29Z

Hashing

← Nächstältere Version		Version vom 5. Juli 2023, 09:42 Uhr
Zeile 7:		Zeile 7:
	All hash algorithms are accessed the same way, by either sending one of the convenient utility messages to a hash-stream-class, or by instantiating a hash stream and sending it the data to be hashed (byte-wise or block-wise).		All hash algorithms are accessed the same way, by either sending one of the convenient utility messages to a hash-stream-class, or by instantiating a hash stream and sending it the data to be hashed (byte-wise or block-wise).

	The utility messages are easier to use, but require the data to be hashed to be already present. ~~The~~ ~~instance~~ ~~messages~~ ~~allow~~ ~~for~~ ~~streams~~ of ~~unknown~~ ~~length to be hashed~~, to ~~preinitialize~~ ~~the~~ ~~parameters~~ ~~and~~ to ~~fetch/reset~~ ~~the~~ ~~hash~~ ~~value~~ ~~during~~ ~~the~~ ~~operation~~.		The utility messages are easier to use, but require the data to be hashed to be already present in a byte- or character collection (i.e. in memory), which may be inefficient or impossible, if big chunks are to be hashed.

			The instance messages allow for streams of unknown length to be hashed, to preinitialize the parameters and to fetch/reset the hash value during the operation.

	Available hash classes are (among many others): <code>MD5Stream</code>, <code>SHA1Stream</code>, <code>SHA256Stream</code>, <code>SHA512Stream</code>, <code>RipeMD160Stream</code>, <code>SipHashStream</code>, <code>WhirlpoolStream</code> etc.		Available hash classes are (among many others): <code>MD5Stream</code>, <code>SHA1Stream</code>, <code>SHA256Stream</code>, <code>SHA512Stream</code>, <code>RipeMD160Stream</code>, <code>SipHashStream</code>, <code>WhirlpoolStream</code> etc.

Cg: /* Hashing */

2023-07-05T09:40:38Z

Hashing

← Nächstältere Version		Version vom 5. Juli 2023, 09:40 Uhr
Zeile 5:		Zeile 5:

	= Hashing =		= Hashing =
	All hash algorithms are accessed the same way, by either sending one of the convenient utility messages to a hash-stream-class, or by instantiating a hash stream and sending it the data to be hashed.		All hash algorithms are accessed the same way, by either sending one of the convenient utility messages to a hash-stream-class, or by instantiating a hash stream and sending it the data to be hashed (byte-wise or block-wise).

	The utility messages are easier to use, but require the data to be hashed to be already present. The instance messages allow for streams of unknown length to be hashed, to preinitialize the parameters and to fetch/reset the hash value during the operation.		The utility messages are easier to use, but require the data to be hashed to be already present. The instance messages allow for streams of unknown length to be hashed, to preinitialize the parameters and to fetch/reset the hash value during the operation.

Cg: /* Creation */

2023-07-05T09:39:44Z

Creation

← Nächstältere Version		Version vom 5. Juli 2023, 09:39 Uhr
Zeile 203:		Zeile 203:

	Supported algorithm names (by time this document was written) are:		Supported algorithm names (by time this document was written) are:
	#sha1WithRSAEncryption, #sha224WithRSAEncryption, #sha256WithRSAEncryption,		: #sha1WithRSAEncryption, #sha224WithRSAEncryption, #sha256WithRSAEncryption,
	#md2WithRSAEncryption, #md5WithRSAEncryption, #sha384WithRSAEncryption,		: #md2WithRSAEncryption, #md5WithRSAEncryption, #sha384WithRSAEncryption,
	#sha512WithRSAEncryption.		: #sha512WithRSAEncryption.

	Be aware that most of them are considered insecure nowadays - they are only to be used to support older protocols. If in doubt, ask your security staff.		Be aware that most of them are considered insecure nowadays - they are only to be used to support older protocols. If in doubt, ask your security staff.

			=== Signing ===
	To sign a new certificate, given a root CA certificate:		To sign a new certificate, given a root CA certificate:

Cg: /* Creation */

2023-07-05T09:38:37Z

Creation

← Nächstältere Version		Version vom 5. Juli 2023, 09:38 Uhr
Zeile 202:		Zeile 202:
	signSelf		signSelf

			Supported algorithm names (by time this document was written) are:
			#sha1WithRSAEncryption, #sha224WithRSAEncryption, #sha256WithRSAEncryption,
			#md2WithRSAEncryption, #md5WithRSAEncryption, #sha384WithRSAEncryption,
			#sha512WithRSAEncryption.

			Be aware that most of them are considered insecure nowadays - they are only to be used to support older protocols. If in doubt, ask your security staff.

	To sign a new certificate, given a root CA certificate:		To sign a new certificate, given a root CA certificate:

Cg: /* Writing as a DER Encoded File */

2023-07-05T09:27:42Z

Writing as a DER Encoded File

← Nächstältere Version		Version vom 5. Juli 2023, 09:27 Uhr
Zeile 184:		Zeile 184:
	close.		close.
	or more convenient:		or more convenient:
	'filename.crt' asFilename contents:caCert asSignedDerBytes;		'filename.crt' asFilename contents:(caCert asSignedDerBytes)

	=== Creation ===		=== Creation ===

Cg: /* Writing as a DER Encoded File */

2023-07-05T09:27:15Z

Writing as a DER Encoded File

← Nächstältere Version		Version vom 5. Juli 2023, 09:27 Uhr
Zeile 184:		Zeile 184:
	close.		close.
	or more convenient:		or more convenient:
	'filename.crt' asFilename ~~binaryContents~~:caCert asSignedDerBytes;		'filename.crt' asFilename contents:caCert asSignedDerBytes;

	=== Creation ===		=== Creation ===

← Nächstältere Version		Version vom 2. April 2025, 00:15 Uhr
Zeile 23:		Zeile 23:
	<div style="margin-left: 4em;">		<div style="margin-left: 4em;">
	<code>MD5Stream hashValueOf:</code> 'hello world'		<code>MD5Stream hashValueOf:</code> 'hello world'
	=> #[94 182 59 187 224 30 238 208 147 203 34 187 143 90 205 195]		<small>=> #[94 182 59 187 224 30 238 208 147 203 34 187 143 90 205 195]</small>

	<code>SHA1Stream hashValueOf:</code> 'hello world'		<code>SHA1Stream hashValueOf:</code> 'hello world'
	=> #[42 174 108 53 201 79 207 180 21 219 233 95 64 139 156 233 30 232 70 237]		<small>=> #[42 174 108 53 201 79 207 180 21 219 233 95 64 139 156 233 30 232 70 237]</small>

	<code>SHA256Stream hashValueOf:</code> 'hello world'		<code>SHA256Stream hashValueOf:</code> 'hello world'
	=> #[185 77 39 185 147 77 62 8 165 46 82 215 218 125 171 250 196		<small>=> #[185 77 39 185 147 77 62 8 165 46 82 215 218 125 171 250 196
	132 239 227 122 83 128 238 144 136 247 172 226 239 205 233]		132 239 227 122 83 128 238 144 136 247 172 226 239 205 233]</small>
	</div>		</div>

Zeile 38:		Zeile 38:
	<div style="margin-left: 4em;">		<div style="margin-left: 4em;">
	<code>MD5Stream hashValueHexString:</code> 'hello world'		<code>MD5Stream hashValueHexString:</code> 'hello world'
	=> '5eb63bbbe01eeed093cb22bb8f5acdc3'		<small>=> '5eb63bbbe01eeed093cb22bb8f5acdc3'</small>

	<code>SHA1Stream hashValueHexString:</code> 'hello world'		<code>SHA1Stream hashValueHexString:</code> 'hello world'
	=> '2aae6c35c94fcfb415dbe95f408b9ce91ee846ed'		<small>=> '2aae6c35c94fcfb415dbe95f408b9ce91ee846ed'</small>

	<code>SHA256Stream hashValueHexString:</code> 'hello world'		<code>SHA256Stream hashValueHexString:</code> 'hello world'
	=> 'b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9'		<small>=> 'b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9'</small>
	</div>		</div>