GitBook: [master] 24 pages modified

Author: Spomky

SUMMARY.md

@@ -31,6 +31,8 @@
     * [JWE creation](symfony-bundle/encrypted-tokens/jwe-creation.md)
     * [JWE decryption](symfony-bundle/encrypted-tokens/jwe-decryption.md)
   * [Configuration Helper](symfony-bundle/configuration-helper.md)
+  * [Events](symfony-bundle/events.md)
+  * [Profiling/Debugging](symfony-bundle/profiling-debugging.md)
 * [Console](console/README.md)
   * [Standalone Application](console/standalone.md)
   * [Symfony Console](console/symfony-console.md)

advanced-topics/encrypted-tokens-and/README.md

@@ -1,2 +1,4 @@
 # Encrypted tokens and
 
+
+

advanced-topics/nested-tokens.md

@@ -7,6 +7,8 @@ The `NestedTokenLoader` and `NestedTokenBuilder` classes will help you to create
 * `web-token/jwt-checker`
 * `web-token/jwt-signature`
 
+**New in version 2.0**: a new package is available: `web-token/jwt-nested-token`. This package contains all the classes and dependencies will be directly managed by composer. You can install it if needed.
+
 ## Nested Token Loading
 
 To instantiate the `NestedTokenLoader`, you need a `JWSLoader` and a `JWELoader`.

advanced-topics/serialization.md

@@ -98,15 +98,12 @@ The serializer manager can be helpful when your application deals more than one
 
 require_once 'vendor/autoload.php';
 
-use Jose\Component\Core\Converter\StandardConverter;
 use Jose\Component\Signature\Serializer;
 
-$jsonConverter = new StandardConverter();
-
 $manager = Serializer\JWSSerializerManager::create([
-    new Serializer\CompactSerializer($jsonConverter),
-    new Serializer\JSONFlattenedSerializer($jsonConverter),
-    new Serializer\JSONGeneralSerializer($jsonConverter),
+    new Serializer\CompactSerializer(),
+    new Serializer\JSONFlattenedSerializer(),
+    new Serializer\JSONGeneralSerializer(),
 ]);
 
 // Serializes the second signature (index = 1) of the variable $jws (JWS object) into JSON Flattened serialization mode.
@@ -194,15 +191,12 @@ The serializer manager can be helpful when your application deals more than one
 
 require_once 'vendor/autoload.php';
 
-use Jose\Component\Core\Converter\StandardConverter;
 use Jose\Component\Encryption\Serializer;
 
-$jsonConverter = new StandardConverter();
-
 $manager = Serializer\JWESerializerManager::create([
-    new Serializer\CompactSerializer($jsonConverter),
-    new Serializer\JSONFlattenedSerializer($jsonConverter),
-    new Serializer\JSONGeneralSerializer($jsonConverter),
+    new Serializer\CompactSerializer(),
+    new Serializer\JSONFlattenedSerializer(),
+    new Serializer\JSONGeneralSerializer(),
 ]);
 
 // Serializes the second recipient (index = 1) of the variable $jwe (JWE object) into JSON Flattened serialization mode.

advanced-topics/signed-tokens-and/README.md

@@ -1,2 +1,4 @@
 # Signed tokens and
 
+
+

advanced-topics/signed-tokens-and/detached-payload.md

@@ -10,33 +10,28 @@ There is not much difference between the creation of a JWS with or without detac
 <?php
 
 use Jose\Component\Core\AlgorithmManager;
-use Jose\Component\Core\Converter\StandardConverter;
 use Jose\Component\Core\JWK;
 use Jose\Component\Signature\Algorithm\HS256;
 use Jose\Component\Signature\JWSBuilder;
 
 // The algorithm manager with the HS256 algorithm.
-$algorithmManager = AlgorithmManager::create([
+$algorithmManager = new AlgorithmManager([
     new HS256(),
 ]);
 
 // Our key.
-$jwk = JWK::create([
+$jwk = new JWK([
     'kty' => 'oct',
     'k' => 'dzI6nbW4OcNF-AtfxGAmuyz7IpHRudBI0WgGjZWgaRJt6prBn3DARXgUR8NVwKhfL43QBIU2Un3AvCGCHRgY4TbEqhOi8-i98xxmCggNjde4oaW6wkJ2NgM3Ss9SOX9zS3lcVzdCMdum-RwVJ301kbin4UtGztuzJBeg5oVN00MGxjC2xWwyI0tgXVs-zJs5WlafCuGfX1HrVkIf5bvpE0MQCSjdJpSeVao6-RSTYDajZf7T88a2eVjeW31mMAg-jzAWfUrii61T_bYPJFOXW8kkRWoa1InLRdG6bKB9wQs9-VdXZP60Q4Yuj_WZ-lO7qV9AEFrUkkjpaDgZT86w2g',
 ]);
 
-// The JSON Converter.
-$jsonConverter = new StandardConverter();
-
 // We instantiate our JWS Builder.
 $jwsBuilder = new JWSBuilder(
-    $jsonConverter,
     $algorithmManager
 );
 
 // The payload we want to sign
-$payload = $jsonConverter->encode([
+$payload = json_encode([
     'iat' => time(),
     'nbf' => time(),
     'exp' => time() + 3600,
@@ -61,36 +56,30 @@ The loading of a signed token with a detached payload is as easy as when the pay
 <?php
 
 use Jose\Component\Core\AlgorithmManager;
-use Jose\Component\Core\Converter\StandardConverter;
 use Jose\Component\Core\JWK;
 use Jose\Component\Signature\Algorithm\HS256;
 use Jose\Component\Signature\JWSVerifier;
 use Jose\Component\Signature\Serializer\JWSSerializerManager;
 use Jose\Component\Signature\Serializer\CompactSerializer;
 
 // The algorithm manager with the HS256 algorithm.
-$algorithmManager = AlgorithmManager::create([
+$algorithmManager = new AlgorithmManager([
     new HS256(),
 ]);
 
 // Our key.
-$jwk = JWK::create([
+$jwk = new JWK([
     'kty' => 'oct',
     'k' => 'dzI6nbW4OcNF-AtfxGAmuyz7IpHRudBI0WgGjZWgaRJt6prBn3DARXgUR8NVwKhfL43QBIU2Un3AvCGCHRgY4TbEqhOi8-i98xxmCggNjde4oaW6wkJ2NgM3Ss9SOX9zS3lcVzdCMdum-RwVJ301kbin4UtGztuzJBeg5oVN00MGxjC2xWwyI0tgXVs-zJs5WlafCuGfX1HrVkIf5bvpE0MQCSjdJpSeVao6-RSTYDajZf7T88a2eVjeW31mMAg-jzAWfUrii61T_bYPJFOXW8kkRWoa1InLRdG6bKB9wQs9-VdXZP60Q4Yuj_WZ-lO7qV9AEFrUkkjpaDgZT86w2g',
 ]);
 
-// The JSON Converter.
-$jsonConverter = new StandardConverter();
-
 // The serializer manager. We only use the JWS Compact Serialization Mode.
-$serializerManager = JWSSerializerManager::create([
-    new CompactSerializer($jsonConverter),
+$serializerManager = new JWSSerializerManager([
+    new CompactSerializer(),
 ]);
 
 // We instantiate our JWS Verifier.
-$jwsVerifier = new JWSVerifier(
-    $algorithmManager
-);
+$jwsVerifier = new JWSVerifier($algorithmManager);
 
 // The detached payload
 $payload = '{"iat":1507896992,"nbf":1507896992,"exp":1507900592,"iss":"My service","aud":"Your application"}';

advanced-topics/signed-tokens-and/multiple-signatures.md

@@ -17,16 +17,12 @@ $jws = $jwsBuilder
 The variable `$jws` will be a valid JWS object with all computed signatures. Next step is the serialization of these signatures.
 
 ```php
-use Jose\Component\Core\Converter\StandardConverter;
 use Jose\Component\Signature\Serializer;
 
-// The JSON Converter.
-$jsonConverter = new StandardConverter();
-
 $manager = Serializer\JWSSerializerManager::create([
-    new Serializer\CompactSerializer($jsonConverter),
-    new Serializer\JsonFlattenedSerializer($jsonConverter),
-    new Serializer\JsonGeneralSerializer($jsonConverter),
+    new Serializer\CompactSerializer(),
+    new Serializer\JsonFlattenedSerializer(),
+    new Serializer\JsonGeneralSerializer(),
 ]);
 
 $tokenWithAllSignatures = $manager->serialize('jws_json_general', $jws);

components/algorithm-management-jwa.md

@@ -21,7 +21,7 @@ use Jose\Component\Core\AlgorithmManager;
 use Jose\Component\Signature\Algorithm\PS256;
 use Jose\Component\Signature\Algorithm\ES512;
 
-$algorithm_manager = AlgorithmManager::create([
+$algorithm_manager = new AlgorithmManager([
     new PS256(),
     new ES512(),
 ]);

components/claim-checker.md

@@ -18,7 +18,7 @@ In the following example, we will create a manager able to check the `aud` \(Aud
 use Jose\Component\Checker\ClaimCheckerManager;
 use Jose\Component\Checker;
 
-$claimCheckerManager = ClaimCheckerManager::create(
+$claimCheckerManager = new ClaimCheckerManager(
     [
         new Checker\IssuedAtChecker(),
         new Checker\NotBeforeChecker(),
@@ -28,14 +28,10 @@ $claimCheckerManager = ClaimCheckerManager::create(
 );
 ```
 
-When instantiated, call the method `check` to check the claims of a JWT object. This method only accept an array. You have to retrieve this array by converting the JWT payload.
+When instantiated, call the method `check` to check the claims of a JWT object. This method only accept an associative array. You have to retrieve this array by converting the JWT payload.
 
 ```php
-use Jose\Component\Core\Converter\StandardConverter;
-
-$jsonConverter = new StandardConverter();
-
-$claims = $jsonConverter->decode($jwt->getPayload());
+$claims = json_decode($jwt->getPayload(), true);
 $claimCheckerManager->check($claims);
 ```
 

components/encrypted-tokens-jwe/encryption-algorithms.md

@@ -74,7 +74,7 @@ use Jose\Component\Encryption\Algorithm\KeyEncryption\A128KW;
 use Jose\Component\Encryption\Algorithm\KeyEncryption\PBES2HS256A128KW;
 use Jose\Component\Encryption\Algorithm\ContentEncryption\A128CBCHS256;
 
-$algorithmManager = AlgorithmManager::create([
+$algorithmManager = new AlgorithmManager([
     new A128KW(),
     new PBES2HS256A128KW(),
     new A128CBCHS256(),
@@ -96,7 +96,7 @@ Example with 16 bytes \(128 bits\) salt and 1024 counts:
 use Jose\Component\Core\AlgorithmManager;
 use Jose\Component\Encryption\Algorithm\KeyEncryption\PBES2HS256A128KW;
 
-$algorithmManager = AlgorithmManager::create([
+$algorithmManager = new AlgorithmManager([
     new PBES2HS256A128KW(16, 1024),
 ]);
 ```

components/encrypted-tokens-jwe/jwe-creation.md

@@ -4,41 +4,35 @@ The computation of a JWE is done by the `JWEBuilder` object. This object require
 
 * an algorithm manager with key encryption algorithms
 * an algorithm manager with content encryption algorithms
-* a compression method manager. No compression method is needed if you do not intent to compress the payload
-* and a JSON converter.
+* a compression method manager. No compression method is needed if you do not intent to compress the payload.
 
 ```php
 <?php
 
 use Jose\Component\Core\AlgorithmManager;
-use Jose\Component\Core\Converter\StandardConverter;
 use Jose\Component\Encryption\Algorithm\KeyEncryption\A256KW;
 use Jose\Component\Encryption\Algorithm\ContentEncryption\A256CBCHS512;
 use Jose\Component\Encryption\Compression\CompressionMethodManager;
 use Jose\Component\Encryption\Compression\Deflate;
 use Jose\Component\Encryption\JWEBuilder;
 
 // The key encryption algorithm manager with the A256KW algorithm.
-$keyEncryptionAlgorithmManager = AlgorithmManager::create([
+$keyEncryptionAlgorithmManager = new AlgorithmManager([
     new A256KW(),
 ]);
 
 // The content encryption algorithm manager with the A256CBC-HS256 algorithm.
-$contentEncryptionAlgorithmManager = AlgorithmManager::create([
+$contentEncryptionAlgorithmManager = new AlgorithmManager([
     new A256CBCHS512(),
 ]);
 
 // The compression method manager with the DEF (Deflate) method.
-$compressionMethodManager = CompressionMethodManager::create([
+$compressionMethodManager = new CompressionMethodManager([
     new Deflate(),
 ]);
 
-// The JSON Converter.
-$jsonConverter = new StandardConverter();
-
 // We instantiate our JWE Builder.
 $jweBuilder = new JWEBuilder(
-    $jsonConverter,
     $keyEncryptionAlgorithmManager,
     $contentEncryptionAlgorithmManager,
     $compressionMethodManager
@@ -51,13 +45,13 @@ Now let's create our first JWE object.
 use Jose\Component\Core\JWK;
 
 // Our key.
-$jwk = JWK::create([
+$jwk = new JWK([
     'kty' => 'oct',
     'k' => 'dzI6nbW4OcNF-AtfxGAmuyz7IpHRudBI0WgGjZWgaRJt6prBn3DARXgUR8NVwKhfL43QBIU2Un3AvCGCHRgY4TbEqhOi8-i98xxmCggNjde4oaW6wkJ2NgM3Ss9SOX9zS3lcVzdCMdum-RwVJ301kbin4UtGztuzJBeg5oVN00MGxjC2xWwyI0tgXVs-zJs5WlafCuGfX1HrVkIf5bvpE0MQCSjdJpSeVao6-RSTYDajZf7T88a2eVjeW31mMAg-jzAWfUrii61T_bYPJFOXW8kkRWoa1InLRdG6bKB9wQs9-VdXZP60Q4Yuj_WZ-lO7qV9AEFrUkkjpaDgZT86w2g',
 ]);
 
-// The payload we want to encrypt. The payload MUST be a string hence we use our JSON Converter.
-$payload = $jsonConverter->encode([
+// The payload we want to encrypt. It MUST be a string.
+$payload = json_encode([
     'iat' => time(),
     'nbf' => time(),
     'exp' => time() + 3600,
@@ -84,7 +78,7 @@ We will use the compact serialization mode. This is the most common mode as it i
 ```php
 use Jose\Component\Encryption\Serializer\CompactSerializer;
 
-$serializer = new CompactSerializer($jsonConverter); // The serializer
+$serializer = new CompactSerializer(); // The serializer
 
 $token = $serializer->serialize($jwe, 0); // We serialize the recipient at index 0 (we only have one recipient).
 ```

components/encrypted-tokens-jwe/jwe-loading.md

@@ -19,17 +19,17 @@ use Jose\Component\Encryption\Compression\Deflate;
 use Jose\Component\Encryption\JWEDecrypter;
 
 // The key encryption algorithm manager with the A256KW algorithm.
-$keyEncryptionAlgorithmManager = AlgorithmManager::create([
+$keyEncryptionAlgorithmManager = new AlgorithmManager([
     new A256KW(),
 ]);
 
 // The content encryption algorithm manager with the A256CBC-HS256 algorithm.
-$contentEncryptionAlgorithmManager = AlgorithmManager::create([
+$contentEncryptionAlgorithmManager = new AlgorithmManager([
     new A256CBCHS512(),
 ]);
 
 // The compression method manager with the DEF (Deflate) method.
-$compressionMethodManager = CompressionMethodManager::create([
+$compressionMethodManager = new CompressionMethodManager([
     new Deflate(),
 ]);
 
@@ -48,7 +48,6 @@ Now we can try to deserialize and decrypt the input we receive. We will continue
 ```php
 <?php
 
-use Jose\Component\Core\Converter\StandardConverter;
 use Jose\Component\Core\JWK;
 use Jose\Component\Encryption\Serializer\JWESerializerManager;
 use Jose\Component\Encryption\Serializer\CompactSerializer;
@@ -59,12 +58,9 @@ $jwk = JWK::create([
     'k' => 'dzI6nbW4OcNF-AtfxGAmuyz7IpHRudBI0WgGjZWgaRJt6prBn3DARXgUR8NVwKhfL43QBIU2Un3AvCGCHRgY4TbEqhOi8-i98xxmCggNjde4oaW6wkJ2NgM3Ss9SOX9zS3lcVzdCMdum-RwVJ301kbin4UtGztuzJBeg5oVN00MGxjC2xWwyI0tgXVs-zJs5WlafCuGfX1HrVkIf5bvpE0MQCSjdJpSeVao6-RSTYDajZf7T88a2eVjeW31mMAg-jzAWfUrii61T_bYPJFOXW8kkRWoa1InLRdG6bKB9wQs9-VdXZP60Q4Yuj_WZ-lO7qV9AEFrUkkjpaDgZT86w2g',
 ]);
 
-// The JSON Converter.
-$jsonConverter = new StandardConverter();
-
 // The serializer manager. We only use the JWE Compact Serialization Mode.
-$serializerManager = JWESerializerManager::create([
-    new CompactSerializer($jsonConverter),
+$serializerManager = new JWESerializerManager([
+    new CompactSerializer(),
 ]);
 
 // The input we want to decrypt

components/header-checker.md

@@ -28,7 +28,7 @@ use Jose\Component\Checker\HeaderCheckerManager;
 use Jose\Component\Checker\AlgorithmChecker;
 use Jose\Component\Signature\JWSTokenSupport;
 
-$headerCheckerManager = HeaderCheckerManager::create(
+$headerCheckerManager = new HeaderCheckerManager(
     [
         new AlgorithmChecker(['HS256']), // We check the header "alg" (algorithm)
     ],
@@ -87,6 +87,8 @@ The following header checkers are provided:
 
 If you need, you can create you own header checker. It must implement the interface `Jose\Component\Checker\HeaderChecker`. In the following example, we will check that the protected header parameter `custom` is an array with value `foo` or `bar`.
 
+{% code-tabs %}
+{% code-tabs-item title="Acme\\Checker\\CustomChecker.php" %}
 ```php
 <?php
 
@@ -95,9 +97,6 @@ namespace Acme\Checker;
 use Jose\Component\Checker\HeaderChecker;
 use Jose\Component\Checker\InvalidHeaderException;
 
-/**
- * Class CustomChecker.
- */
 final class CustomChecker implements HeaderChecker
 {
     public function checkHeader($value)
@@ -120,4 +119,6 @@ final class CustomChecker implements HeaderChecker
     }
 }
 ```
+{% endcode-tabs-item %}
+{% endcode-tabs %}