1
0
mirror of https://github.com/vlang/v.git synced 2023-08-10 21:13:21 +03:00
v/vlib/crypto
2023-08-01 06:55:41 +03:00
..
aes all: 2023 copyright 2023-03-28 22:55:57 +02:00
bcrypt checker: check option fn returning error (fix #17423) (#17438) 2023-03-02 15:49:50 +02:00
blowfish checker: check option fn returning error (fix #17423) (#17438) 2023-03-02 15:49:50 +02:00
cipher all: 2023 copyright 2023-03-28 22:55:57 +02:00
des ci: fix ./v -progress test-cleancode 2022-04-15 21:04:10 +03:00
ed25519 math.big: rework function naming and documentation (#18890) 2023-07-20 02:33:07 +03:00
hmac checker: disallow import names and import aliases, shadowing the module name (#18431) 2023-06-17 16:39:10 +03:00
internal/subtle all: 2023 copyright 2023-03-28 22:55:57 +02:00
md5 all: 2023 copyright 2023-03-28 22:55:57 +02:00
pem crypto.pem: add decode_only and general improvements to decoding (#18908) 2023-07-20 02:34:08 +03:00
rand all: 2023 copyright 2023-03-28 22:55:57 +02:00
rc4 all: 2023 copyright 2023-03-28 22:55:57 +02:00
sha1 all: 2023 copyright 2023-03-28 22:55:57 +02:00
sha256 all: 2023 copyright 2023-03-28 22:55:57 +02:00
sha512 crypto.sha512: make the new384/0, new512_256/0, new512_224/0 functions public 2023-08-01 06:55:41 +03:00
crypto.v
README.md vfmt: change all '$expr' to '${expr}' (#16428) 2022-11-15 16:53:13 +03:00

Description:

crypto is a module that exposes cryptographic algorithms to V programs.

Each submodule implements things differently, so be sure to consider the documentation of the specific algorithm you need, but in general, the method is to create a cipher struct using one of the module functions, and then to call the encrypt or decrypt method on that struct to actually encrypt or decrypt your data.

This module is a work-in-progress. For example, the AES implementation currently requires you to create a destination buffer of the correct size to receive the decrypted data, and the AesCipher encrypt and decrypt functions only operate on the first block of the src.

The implementations here are loosely based on Go's crypto package.

Examples:

AES:

import crypto.aes
import crypto.rand

fn main() {
	// remember to save this key somewhere if you ever want to decrypt your data
	key := rand.bytes(32)!
	println('KEY: ${key}')

	// this data is one block (16 bytes) big
	mut data := 'THIS IS THE DATA'.bytes()

	println('generating cipher')
	cipher := aes.new_cipher(key)

	println('performing encryption')
	mut encrypted := []u8{len: aes.block_size}
	cipher.encrypt(mut encrypted, data)
	println(encrypted)

	println('performing decryption')
	mut decrypted := []u8{len: aes.block_size}
	cipher.decrypt(mut decrypted, encrypted)
	println(decrypted)

	assert decrypted == data
}

JWT:

import crypto.hmac
import crypto.sha256
import encoding.base64
import json
import time

struct JwtHeader {
	alg string
	typ string
}

struct JwtPayload {
	sub  string
	name string
	iat  int
}

fn main() {
	sw := time.new_stopwatch()
	secret := 'your-256-bit-secret'
	token := make_token(secret)
	ok := auth_verify(secret, token)
	dt := sw.elapsed().microseconds()
	println('token: ${token}')
	println('auth_verify(secret, token): ${ok}')
	println('Elapsed time: ${dt} uS')
}

fn make_token(secret string) string {
	header := base64.url_encode(json.encode(JwtHeader{'HS256', 'JWT'}).bytes())
	payload := base64.url_encode(json.encode(JwtPayload{'1234567890', 'John Doe', 1516239022}).bytes())
	signature := base64.url_encode(hmac.new(secret.bytes(), '${header}.${payload}'.bytes(),
		sha256.sum, sha256.block_size))
	jwt := '${header}.${payload}.${signature}'
	return jwt
}

fn auth_verify(secret string, token string) bool {
	token_split := token.split('.')
	signature_mirror := hmac.new(secret.bytes(), '${token_split[0]}.${token_split[1]}'.bytes(),
		sha256.sum, sha256.block_size)
	signature_from_token := base64.url_decode(token_split[2])
	return hmac.equal(signature_from_token, signature_mirror)
}