Zoeken…
Opmerkingen
De WebCrypto API's zijn meestal alleen beschikbaar op "veilige" oorsprong, wat betekent dat het document moet zijn geladen via HTTPS of vanaf de lokale machine (van localhost
, file:
of een browserextensie).
Deze API's worden gespecificeerd door de W3C Web Cryptography API Candidate Recommendation .
Cryptografisch willekeurige gegevens
// Create an array with a fixed size and type.
var array = new Uint8Array(5);
// Generate cryptographically random values
crypto.getRandomValues(array);
// Print the array to the console
console.log(array);
crypto.getRandomValues(array)
kan worden gebruikt met instanties van de volgende klassen (verder beschreven in Binaire gegevens ) en genereert waarden uit de gegeven bereiken (beide uiteinden inclusief):
-
Int8Array
: -2 7 tot 2 7 -1 -
Uint8Array
: 0 tot 2 8 -1 -
Int16Array
: -2 15 tot 2 15 -1 -
Uint16Array
: 0 tot 2 16 -1 -
Int32Array
: -2 31 tot 2 31 -1 -
Uint32Array
: 0 tot 2 31 -1
Digests maken (bijv. SHA-256)
// Convert string to ArrayBuffer. This step is only necessary if you wish to hash a string, not if you aready got an ArrayBuffer such as an Uint8Array.
var input = new TextEncoder('utf-8').encode('Hello world!');
// Calculate the SHA-256 digest
crypto.subtle.digest('SHA-256', input)
// Wait for completion
.then(function(digest) {
// digest is an ArrayBuffer. There are multiple ways to proceed.
// If you want to display the digest as a hexadecimal string, this will work:
var view = new DataView(digest);
var hexstr = '';
for(var i = 0; i < view.byteLength; i++) {
var b = view.getUint8(i);
hexstr += '0123456789abcdef'[(b & 0xf0) >> 4];
hexstr += '0123456789abcdef'[(b & 0x0f)];
}
console.log(hexstr);
// Otherwise, you can simply create an Uint8Array from the buffer:
var digestAsArray = new Uint8Array(digest);
console.log(digestAsArray);
})
// Catch errors
.catch(function(err) {
console.error(err);
});
De huidige versie suggereert om ten minste SHA-1
, SHA-256
, SHA-384
en SHA-512
, maar dit is geen strikte vereiste en kan worden gewijzigd. De SHA-familie kan echter nog steeds als een goede keuze worden beschouwd, omdat deze waarschijnlijk in alle belangrijke browsers wordt ondersteund.
RSA-sleutelpaar genereren en converteren naar PEM-indeling
In dit voorbeeld leert u hoe u een RSA-OAEP-sleutelpaar kunt genereren en hoe u een privésleutel van dit sleutelpaar kunt converteren naar base64 zodat u deze kunt gebruiken met OpenSSL enz. Houd er rekening mee dat dit proces ook kan worden gebruikt voor de openbare sleutel die u zojuist hebt om het voorvoegsel en het achtervoegsel hieronder te gebruiken:
-----BEGIN PUBLIC KEY-----
-----END PUBLIC KEY-----
OPMERKING: Dit voorbeeld is volledig getest in deze browsers: Chrome, Firefox, Opera, Vivaldi
function arrayBufferToBase64(arrayBuffer) {
var byteArray = new Uint8Array(arrayBuffer);
var byteString = '';
for(var i=0; i < byteArray.byteLength; i++) {
byteString += String.fromCharCode(byteArray[i]);
}
var b64 = window.btoa(byteString);
return b64;
}
function addNewLines(str) {
var finalString = '';
while(str.length > 0) {
finalString += str.substring(0, 64) + '\n';
str = str.substring(64);
}
return finalString;
}
function toPem(privateKey) {
var b64 = addNewLines(arrayBufferToBase64(privateKey));
var pem = "-----BEGIN PRIVATE KEY-----\n" + b64 + "-----END PRIVATE KEY-----";
return pem;
}
// Let's generate the key pair first
window.crypto.subtle.generateKey(
{
name: "RSA-OAEP",
modulusLength: 2048, // can be 1024, 2048 or 4096
publicExponent: new Uint8Array([0x01, 0x00, 0x01]),
hash: {name: "SHA-256"} // or SHA-512
},
true,
["encrypt", "decrypt"]
).then(function(keyPair) {
/* now when the key pair is generated we are going
to export it from the keypair object in pkcs8
*/
window.crypto.subtle.exportKey(
"pkcs8",
keyPair.privateKey
).then(function(exportedPrivateKey) {
// converting exported private key to PEM format
var pem = toPem(exportedPrivateKey);
console.log(pem);
}).catch(function(err) {
console.log(err);
});
});
Dat is het! Nu hebt u een volledig werkende en compatibele RSA-OAEP privésleutel in PEM-indeling die u kunt gebruiken waar u maar wilt. Genieten!
PEM-sleutelpaar converteren naar CryptoKey
Dus, heb je je ooit afgevraagd hoe je je PEM RSA-sleutelpaar kunt gebruiken dat door OpenSSL is gegenereerd in Web Cryptography API? Als de antwoorden ja zijn. Super goed! Je gaat het uitzoeken.
OPMERKING: Dit proces kan ook worden gebruikt voor de openbare sleutel. U hoeft alleen het voor- en achtervoegsel te wijzigen in:
-----BEGIN PUBLIC KEY-----
-----END PUBLIC KEY-----
In dit voorbeeld wordt ervan uitgegaan dat uw RSA-sleutelpaar is gegenereerd in PEM.
function removeLines(str) {
return str.replace("\n", "");
}
function base64ToArrayBuffer(b64) {
var byteString = window.atob(b64);
var byteArray = new Uint8Array(byteString.length);
for(var i=0; i < byteString.length; i++) {
byteArray[i] = byteString.charCodeAt(i);
}
return byteArray;
}
function pemToArrayBuffer(pem) {
var b64Lines = removeLines(pem);
var b64Prefix = b64Lines.replace('-----BEGIN PRIVATE KEY-----', '');
var b64Final = b64Prefix.replace('-----END PRIVATE KEY-----', '');
return base64ToArrayBuffer(b64Final);
}
window.crypto.subtle.importKey(
"pkcs8",
pemToArrayBuffer(yourprivatekey),
{
name: "RSA-OAEP",
hash: {name: "SHA-256"} // or SHA-512
},
true,
["decrypt"]
).then(function(importedPrivateKey) {
console.log(importedPrivateKey);
}).catch(function(err) {
console.log(err);
});
En nu ben je klaar! U kunt uw geïmporteerde sleutel gebruiken in WebCrypto API.