Add support for attaching metadata to Authorization

This allows to add arbitrary metadata to an `Authorization` for use in
client code.

Author: kdambekalns

Classes/Authorization.php

@@ -77,6 +77,12 @@ class Authorization
      */
     protected $encryptedSerializedAccessToken;
 
+    /**
+     * @var string
+     * @ORM\Column(nullable = true, type = "text")
+     */
+    protected $metadata;
+
     /**
      * @Flow\Transient
      * @var EncryptionService
@@ -287,4 +293,14 @@ public function setExpires(\DateTimeImmutable $expires): void
     {
         $this->expires = $expires;
     }
+
+    public function getMetadata(): ?string
+    {
+        return $this->metadata;
+    }
+
+    public function setMetadata(string $metadata): void
+    {
+        $this->metadata = $metadata;
+    }
 }

Classes/OAuthClient.php

@@ -483,6 +483,26 @@ public function renderFinishAuthorizationUri(): string
         }
     }
 
+    /**
+     * Helper method to set metadate on an Authorization instance, makes sure the
+     * change is persisted.
+     *
+     * @param string $authorizationId
+     * @param string $metadata
+     * @return void
+     */
+    public function setAuthorizationMetadata(string $authorizationId, string $metadata): void
+    {
+        $authorization = $this->getAuthorization($authorizationId);
+        if ($authorization === null) {
+            throw new \RuntimeException('Authorization not found', 1631821719);
+        }
+        $authorization->setMetadata($metadata);
+
+        $this->entityManager->persist($authorization);
+        $this->entityManager->flush();
+    }
+
     /**
      * @param string $clientId
      * @param string $clientSecret

Migrations/Mysql/Version20210916194112.php

@@ -0,0 +1,32 @@
+<?php
+declare(strict_types=1);
+
+namespace Neos\Flow\Persistence\Doctrine\Migrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+/**
+ * Add metedata column on Authorization table
+ */
+final class Version20210916194112 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Add metedata column on Authorization table';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->abortIf($this->connection->getDatabasePlatform()->getName() !== 'mysql', 'Migration can only be executed safely on \'mysql\'.');
+
+        $this->addSql('ALTER TABLE flownative_oauth2_client_authorization ADD metadata LONGTEXT DEFAULT NULL');
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->abortIf($this->connection->getDatabasePlatform()->getName() !== 'mysql', 'Migration can only be executed safely on \'mysql\'.');
+
+        $this->addSql('ALTER TABLE flownative_oauth2_client_authorization DROP metadata');
+    }
+}