API-1763: add a function to build an authentication only by app token

Author: tomglvng

README.md

@@ -72,6 +72,11 @@ $client->getToken();
 $client->getRefreshToken();
 ```
 
+If you are developing an App, authenticate with your app token.
+```php
+$client = $clientBuilder->buildAuthenticatedByAppToken('app_token');
+```
+
 ### Get a product
 
 ```php

spec/Search/SearchBuilderSpec.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace spec\Akeneo\Pim\ApiClient\Builder;
+namespace spec\Akeneo\Pim\ApiClient\Search;
 
 use Akeneo\Pim\ApiClient\Search\Operator;
 use Akeneo\Pim\ApiClient\Search\SearchBuilder;

spec/Security/AuthenticationSpec.php

@@ -31,4 +31,17 @@ function it_is_initializable_from_a_token()
         $this->getAccessToken()->shouldReturn('token');
         $this->getRefreshToken()->shouldReturn('refresh_token');
     }
+
+    function it_is_initializable_from_an_app_token()
+    {
+        $this->beConstructedThrough('fromAppToken', ['a_token']);
+        $this->shouldHaveType('Akeneo\Pim\ApiClient\Security\Authentication');
+
+        $this->getClientId()->shouldReturn(null);
+        $this->getSecret()->shouldReturn(null);
+        $this->getUsername()->shouldReturn(null);
+        $this->getPassword()->shouldReturn(null);
+        $this->getAccessToken()->shouldReturn('a_token');
+        $this->getRefreshToken()->shouldReturn(null);
+    }
 }

src/AkeneoPimClientBuilder.php

@@ -151,6 +151,13 @@ public function buildAuthenticatedByPassword(string $clientId, string $secret, s
         return $this->buildAuthenticatedClient($authentication);
     }
 
+    public function buildAuthenticatedByAppToken(string $token): AkeneoPimClientInterface
+    {
+        $authentication = Authentication::fromAppToken($token);
+
+        return $this->buildAuthenticatedClient($authentication);
+    }
+
     /**
      * Build the Akeneo PIM client authenticated by token.
      *

src/Security/Authentication.php

@@ -55,12 +55,20 @@ public static function fromToken(string $clientId, string $secret, string $acces
         return $authentication;
     }
 
-    public function getClientId(): string
+    public static function fromAppToken(string $accessToken): Authentication
+    {
+        $authentication = new static();
+        $authentication->accessToken = $accessToken;
+
+        return $authentication;
+    }
+
+    public function getClientId(): ?string
     {
         return $this->clientId;
     }
 
-    public function getSecret(): string
+    public function getSecret(): ?string
     {
         return $this->secret;
     }

tests/Api/ApiTestCase.php

@@ -47,7 +47,7 @@ protected function tearDown(): void
     /**
      * @return AkeneoPimClientInterface
      */
-    protected function createClient()
+    protected function createClientByPassword()
     {
         $clientBuilder = new AkeneoPimClientBuilder($this->server->getServerRoot());
 
@@ -59,6 +59,25 @@ protected function createClient()
         );
     }
 
+    protected function createClientByToken()
+    {
+        $clientBuilder = new AkeneoPimClientBuilder($this->server->getServerRoot());
+
+        return $clientBuilder->buildAuthenticatedByToken(
+            'client_id',
+            'secret',
+            'a_token',
+            'a_refresh_token'
+        );
+    }
+
+    protected function createClientByAppToken()
+    {
+        $clientBuilder = new AkeneoPimClientBuilder($this->server->getServerRoot());
+
+        return $clientBuilder->buildAuthenticatedByAppToken('a_token');
+    }
+
     private function getAuthenticatedJson()
     {
         return <<<JSON

tests/Api/Asset/GetAssetIntegration.php

@@ -22,7 +22,7 @@ public function test_get_asset()
             )
         );
 
-        $api = $this->createClient()->getAssetManagerApi();
+        $api = $this->createClientByPassword()->getAssetManagerApi();
         $asset = $api->get('packshot', 'battleship');
 
         Assert::assertSame($this->server->getLastRequest()->jsonSerialize()[RequestInfo::JSON_KEY_METHOD], 'GET');
@@ -41,7 +41,7 @@ public function test_get_unknown_asset()
         $this->expectException(\Akeneo\Pim\ApiClient\Exception\NotFoundHttpException::class);
         $this->expectExceptionMessage('Asset "peace-sheep" does not exist.');
 
-        $api = $this->createClient()->getAssetManagerApi();
+        $api = $this->createClientByPassword()->getAssetManagerApi();
         $api->get('packshot', 'peace-sheep');
     }
 

tests/Api/Asset/ListAllAssetsIntegration.php

@@ -22,7 +22,7 @@ public function test_list_per_page()
             )
         );
 
-        $api = $this->createClient()->getAssetManagerApi();
+        $api = $this->createClientByPassword()->getAssetManagerApi();
         $assetCursor = $api->all('packshot');
         $assets = iterator_to_array($assetCursor);
 

tests/Api/Asset/UpsertAssetIntegration.php

@@ -42,7 +42,7 @@ public function test_upsert_asset()
             ]
         ];
 
-        $api = $this->createClient()->getAssetManagerApi();
+        $api = $this->createClientByPassword()->getAssetManagerApi();
         $response = $api->upsert('packshot', 'sku_54628_telescope', $asset);
 
         Assert::assertSame($this->server->getLastRequest()->jsonSerialize()[RequestInfo::JSON_KEY_INPUT], json_encode($asset));

tests/Api/Asset/UpsertListAssetIntegration.php

@@ -87,7 +87,7 @@ public function test_upsert_a_list_of_assets()
             ],
         ];
 
-        $api = $this->createClient()->getAssetManagerApi();
+        $api = $this->createClientByPassword()->getAssetManagerApi();
         $responses = $api->upsertList('packshot', $assets);
 
         Assert::assertSame($this->server->getLastRequest()->jsonSerialize()[RequestInfo::JSON_KEY_INPUT], json_encode($assets));