Scott paragonie-scott

Changes to JOSE that will prevent insecurity

Deletions

JWS and JWE

Drop the `alg` header

Neither JOSE users nor JOSE library designers should be required to understand cryptography primitives. At a lower level, this can lead to badly implemented primitives. On a higher level, this can lead to reasoning by lego.

This is a more "how" to the "what": https://paragonie.com/blog/2016/10/guide-automatic-security-updates-for-php-developers

HTTPS + Digital Signatures

This is a minimalistic secure auto update approach.

Make an API call to a server to get the latest version information. This should be delivered over HTTPS, possibly with HPKP.
If an update is available, the client software should download the update file.
An Ed25519 signature should be available, either as a separate API call or as an HTTP header with the downloaded file.
Verify that the signature is valid for one of the hard-coded Ed25519 public keys.

	<?php
	namespace ChronicleClient;

	use GuzzleHttp\Client;
	use ParagonIE\Chronicle\Chronicle;
	use ParagonIE\ConstantTime\Base64UrlSafe;
	use ParagonIE\Sapient\Adapter\Guzzle;
	use ParagonIE\Sapient\CryptographyKeys\{
	SigningPublicKey,
	SigningSecretKey

	<?php

	/* Key generation */
	$keypair = openssl_pkey_new([
	"digest_alg" => "sha512",
	"private_key_type" => OPENSSL_KEYTYPE_RSA,
	'private_key_bits' => 1024
	]);
	$secret = null;
	if (!openssl_pkey_export($keypair, $secret)) {

	<?php

	define('DEFUSE_CRYPTO_BASEDIR', __DIR__.'/src/');

	/**
	* PSR-4 compatible autoloader
	*
	*/
	\spl_autoload_register(function ($class) {
	// Project-specific namespace prefix

	<?php
	declare(strict_types=1);

	class Foo
	{
	/**
	* Even if the code that calls isn't using strict_types, it will still TypeError
	* if the wrong type is passed.
	*/
	public function bar($param, $secondParam)

	<?php
	declare(strict_types=1);

	use ParagonIE\ConstantTime\Base64UrlSafe;

	class JWTKiller
	{
	public static function sign(string $message, Key $key): string
	{
	$mac = sodium_crypto_auth($message, $key->getRaw());

	<?php

	$message = random_bytes(1024);
	$key = random_bytes(32);
	$nonce = random_bytes(12);
	$tag = '';
	$aad = random_bytes(random_int(1, 127));

	$cipher = openssl_encrypt($message, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $nonce, $tag, $aad, 16);