Revert "GitBook: [master] 24 pages modified"

This reverts commit bcd5bba.

Author: Spomky

SUMMARY.md

@@ -31,8 +31,6 @@
     * [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,4 +1,2 @@
 # Encrypted tokens and
 
-
-

advanced-topics/nested-tokens.md

@@ -7,8 +7,6 @@ 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,12 +98,15 @@ 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(),
-    new Serializer\JSONFlattenedSerializer(),
-    new Serializer\JSONGeneralSerializer(),
+    new Serializer\CompactSerializer($jsonConverter),
+    new Serializer\JSONFlattenedSerializer($jsonConverter),
+    new Serializer\JSONGeneralSerializer($jsonConverter),
 ]);
 
 // Serializes the second signature (index = 1) of the variable $jws (JWS object) into JSON Flattened serialization mode.
@@ -191,12 +194,15 @@ 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(),
-    new Serializer\JSONFlattenedSerializer(),
-    new Serializer\JSONGeneralSerializer(),
+    new Serializer\CompactSerializer($jsonConverter),
+    new Serializer\JSONFlattenedSerializer($jsonConverter),
+    new Serializer\JSONGeneralSerializer($jsonConverter),
 ]);
 
 // 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,4 +1,2 @@
 # Signed tokens and
 
-
-

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

@@ -10,28 +10,33 @@ 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 = new AlgorithmManager([
+$algorithmManager = AlgorithmManager::create([
     new HS256(),
 ]);
 
 // Our key.
-$jwk = new JWK([
+$jwk = JWK::create([
     '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 = json_encode([
+$payload = $jsonConverter->encode([
     'iat' => time(),
     'nbf' => time(),
     'exp' => time() + 3600,
@@ -56,30 +61,36 @@ 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 = new AlgorithmManager([
+$algorithmManager = AlgorithmManager::create([
     new HS256(),
 ]);
 
 // Our key.
-$jwk = new JWK([
+$jwk = JWK::create([
     '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 = new JWSSerializerManager([
-    new CompactSerializer(),
+$serializerManager = JWSSerializerManager::create([
+    new CompactSerializer($jsonConverter),
 ]);
 
 // 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,12 +17,16 @@ $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(),
-    new Serializer\JsonFlattenedSerializer(),
-    new Serializer\JsonGeneralSerializer(),
+    new Serializer\CompactSerializer($jsonConverter),
+    new Serializer\JsonFlattenedSerializer($jsonConverter),
+    new Serializer\JsonGeneralSerializer($jsonConverter),
 ]);
 
 $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 = new AlgorithmManager([
+$algorithm_manager = AlgorithmManager::create([
     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 = new ClaimCheckerManager(
+$claimCheckerManager = ClaimCheckerManager::create(
     [
         new Checker\IssuedAtChecker(),
         new Checker\NotBeforeChecker(),
@@ -28,10 +28,14 @@ $claimCheckerManager = new ClaimCheckerManager(
 );
 ```
 
-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.
+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.
 
 ```php
-$claims = json_decode($jwt->getPayload(), true);
+use Jose\Component\Core\Converter\StandardConverter;
+
+$jsonConverter = new StandardConverter();
+
+$claims = $jsonConverter->decode($jwt->getPayload());
 $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 = new AlgorithmManager([
+$algorithmManager = AlgorithmManager::create([
     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 = new AlgorithmManager([
+$algorithmManager = AlgorithmManager::create([
     new PBES2HS256A128KW(16, 1024),
 ]);
 ```

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

@@ -4,35 +4,41 @@ 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.
+* a compression method manager. No compression method is needed if you do not intent to compress the payload
+* and a JSON converter.
 
 ```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 = new AlgorithmManager([
+$keyEncryptionAlgorithmManager = AlgorithmManager::create([
     new A256KW(),
 ]);
 
 // The content encryption algorithm manager with the A256CBC-HS256 algorithm.
-$contentEncryptionAlgorithmManager = new AlgorithmManager([
+$contentEncryptionAlgorithmManager = AlgorithmManager::create([
     new A256CBCHS512(),
 ]);
 
 // The compression method manager with the DEF (Deflate) method.
-$compressionMethodManager = new CompressionMethodManager([
+$compressionMethodManager = CompressionMethodManager::create([
     new Deflate(),
 ]);
 
+// The JSON Converter.
+$jsonConverter = new StandardConverter();
+
 // We instantiate our JWE Builder.
 $jweBuilder = new JWEBuilder(
+    $jsonConverter,
     $keyEncryptionAlgorithmManager,
     $contentEncryptionAlgorithmManager,
     $compressionMethodManager
@@ -45,13 +51,13 @@ Now let's create our first JWE object.
 use Jose\Component\Core\JWK;
 
 // Our key.
-$jwk = new JWK([
+$jwk = JWK::create([
     'kty' => 'oct',
     'k' => 'dzI6nbW4OcNF-AtfxGAmuyz7IpHRudBI0WgGjZWgaRJt6prBn3DARXgUR8NVwKhfL43QBIU2Un3AvCGCHRgY4TbEqhOi8-i98xxmCggNjde4oaW6wkJ2NgM3Ss9SOX9zS3lcVzdCMdum-RwVJ301kbin4UtGztuzJBeg5oVN00MGxjC2xWwyI0tgXVs-zJs5WlafCuGfX1HrVkIf5bvpE0MQCSjdJpSeVao6-RSTYDajZf7T88a2eVjeW31mMAg-jzAWfUrii61T_bYPJFOXW8kkRWoa1InLRdG6bKB9wQs9-VdXZP60Q4Yuj_WZ-lO7qV9AEFrUkkjpaDgZT86w2g',
 ]);
 
-// The payload we want to encrypt. It MUST be a string.
-$payload = json_encode([
+// The payload we want to encrypt. The payload MUST be a string hence we use our JSON Converter.
+$payload = $jsonConverter->encode([
     'iat' => time(),
     'nbf' => time(),
     'exp' => time() + 3600,
@@ -78,7 +84,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(); // The serializer
+$serializer = new CompactSerializer($jsonConverter); // 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 = new AlgorithmManager([
+$keyEncryptionAlgorithmManager = AlgorithmManager::create([
     new A256KW(),
 ]);
 
 // The content encryption algorithm manager with the A256CBC-HS256 algorithm.
-$contentEncryptionAlgorithmManager = new AlgorithmManager([
+$contentEncryptionAlgorithmManager = AlgorithmManager::create([
     new A256CBCHS512(),
 ]);
 
 // The compression method manager with the DEF (Deflate) method.
-$compressionMethodManager = new CompressionMethodManager([
+$compressionMethodManager = CompressionMethodManager::create([
     new Deflate(),
 ]);
 
@@ -48,6 +48,7 @@ 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;
@@ -58,9 +59,12 @@ $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 = new JWESerializerManager([
-    new CompactSerializer(),
+$serializerManager = JWESerializerManager::create([
+    new CompactSerializer($jsonConverter),
 ]);
 
 // 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 = new HeaderCheckerManager(
+$headerCheckerManager = HeaderCheckerManager::create(
     [
         new AlgorithmChecker(['HS256']), // We check the header "alg" (algorithm)
     ],
@@ -87,8 +87,6 @@ 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
 
@@ -97,6 +95,9 @@ namespace Acme\Checker;
 use Jose\Component\Checker\HeaderChecker;
 use Jose\Component\Checker\InvalidHeaderException;
 
+/**
+ * Class CustomChecker.
+ */
 final class CustomChecker implements HeaderChecker
 {
     public function checkHeader($value)
@@ -119,6 +120,4 @@ final class CustomChecker implements HeaderChecker
     }
 }
 ```
-{% endcode-tabs-item %}
-{% endcode-tabs %}