WIP Move to SSP UI

Author: cicnavi

README.md

@@ -34,7 +34,7 @@ PHP version requirement changes in minor releases for SimpleSAMLphp.
 
 ### Upgrading?
 
-If you are upgrading from a previous version, checkout the [upgrade guide](UPGRADE.md).
+If you are upgrading from a previous version, make sure to check the [upgrade guide](UPGRADE.md).
 
 ## Installation
 
@@ -107,14 +107,12 @@ SimpleSAMLphp configuration file, `config/config.php`.
         'oidc' => true,
     ],
 
-This is required the enable the module on the _Federation_ tab in the admin web interface, which can be used in the
-next two steps to finalize the installation.
+Once the module is enabled, the database migrations must be run.
 
 ### Run database migrations
 
 The module comes with some default SQL migrations which set up needed tables in the configured database. To run them,
-open the _Federation_ tab from your _SimpleSAMLphp_ installation and select the option _OpenID Connect Installation_
-inside the _Tools_ section. Once there, all you need to do is press the _Install_ button and the schema will be created.
+go to `OIDC` > `Database Migrations`, and press the available button.
 
 Alternatively, in case of automatic / scripted deployments, you can run the 'install.php' script from the command line:
 
@@ -124,8 +122,7 @@ Alternatively, in case of automatic / scripted deployments, you can run the 'ins
 
 The module lets you manage (create, read, update and delete) approved RPs from the module user interface itself.
 
-Once the database schema has been created, you can open the _Federation_ tab from your _SimpleSAMLphp_ installation
-and select the option _OpenID Connect Client Registry_ inside the _Tools_ section.
+Once the database schema has been created, you can go to `OIDC` > `Client Registry`. 
 
 Note that clients can be marked as confidential or public. If the client is not marked as confidential (it is public),
 and is using Authorization Code flow, it will have to provide PKCE parameters during the flow.

UPGRADE.md

@@ -79,7 +79,12 @@ key `authproc.oidc`
 
 ## Low impact changes
 
-Below are some internal changes that should not have impact for the OIDC OP implementors. However, if you are using
+In an effort to move to SimpleSAMLphp way of working with user interface (UI), the client management UI was updated
+to extend from the SimpleSAMLphp base template. In addition, we have also introduced some configuration overview pages
+where you can take a quick view of some of the configuration values for the module. OIDC related pages are now available
+from the main SimpleSAMLphp menu in Administration area.  
+
+Below are also some internal changes that should not have impact for the OIDC OP implementors. However, if you are using
 this module as a library or extending from it, you will probably encounter breaking changes, since a lot of code
 has been refactored:
 

docs/oidc.png

@@ -20,7 +20,7 @@ function oidc_hook_adminmenu(Template &$template): void
 
     $oidcMenuEntry = [
         ModuleConfig::MODULE_NAME => [
-            'url' => $moduleConfig->getModuleUrl(RoutesEnum::AdminConfigProtocol->value),
+            'url' => $moduleConfig->getModuleUrl(RoutesEnum::AdminMigrations->value),
             'name' => Translate::noop('OIDC'),
         ],
     ];

hooks/hook_adminmenu.php

@@ -16,6 +16,7 @@
 
 use SimpleSAML\Locale\Translate;
 use SimpleSAML\Module;
+use SimpleSAML\Module\oidc\ModuleConfig;
 use SimpleSAML\Module\oidc\Services\DatabaseMigration;
 use SimpleSAML\XHTML\Template;
 
@@ -24,12 +25,17 @@
  */
 function oidc_hook_federationpage(Template $template): void
 {
-    $href = Module::getModuleURL('oidc/admin-clients/index.php');
-    $text = Translate::noop('OpenID Connect Registry');
+    $routes = new Module\oidc\Utils\Routes(
+        new ModuleConfig(),
+        new Module\oidc\Bridges\SspBridge(),
+    );
+
+    $href = $routes->urlAdminClients();
+    $text = Translate::noop('OIDC Client Registry');
 
     if (! (new DatabaseMigration())->isMigrated()) {
-        $href = Module::getModuleURL('oidc/install.php');
-        $text = Translate::noop('OpenID Connect Installation');
+        $href = $routes->urlAdminMigrations();
+        $text = Translate::noop('OIDC Installation');
     }
 
     if (!is_array($template->data['links'])) {

hooks/hook_federationpage.php

@@ -115,6 +115,6 @@ table.client-table {
 
 .confirm-action {}
 
-form.pure-form-stacked input {
+form.pure-form-stacked .full-width {
     width: 100%;
 }

public/assets/css/src/default.css

@@ -0,0 +1,22 @@
+(function () {
+    'use strict';
+
+    // Handle enabling and disabling input for 'allowed origins', based on client type radio input.
+    function toggleAllowedOrigins() {
+        if (radioOptionPublic.checked) {
+            inputAllowedOrigin.disabled = false; // Enable the input field
+        } else if (radioOptionConfidential.checked) {
+            inputAllowedOrigin.disabled = true; // Disable the input field
+        }
+    }
+
+    // Get references to the radio buttons and the input field
+    const radioOptionPublic = document.getElementById("radio-option-public");
+    const radioOptionConfidential = document.getElementById("radio-option-confidential");
+    const inputAllowedOrigin = document.getElementById("frm-allowed_origin");
+
+    radioOptionPublic.addEventListener("change", toggleAllowedOrigins);
+    radioOptionConfidential.addEventListener("change", toggleAllowedOrigins);
+
+    toggleAllowedOrigins();
+})();

public/assets/js/src/client-form.js

@@ -47,6 +47,9 @@
     $routes->add(RoutesEnum::AdminClientsShow->name, RoutesEnum::AdminClientsShow->value)
         ->controller([ClientController::class, 'show'])
         ->methods([HttpMethodsEnum::GET->value]);
+    $routes->add(RoutesEnum::AdminClientsEdit->name, RoutesEnum::AdminClientsEdit->value)
+        ->controller([ClientController::class, 'edit'])
+        ->methods([HttpMethodsEnum::GET->value, HttpMethodsEnum::POST->value]);
     $routes->add(RoutesEnum::AdminClientsResetSecret->name, RoutesEnum::AdminClientsResetSecret->value)
         ->controller([ClientController::class, 'resetSecret'])
         ->methods([HttpMethodsEnum::POST->value]);

routing/routes/routes.php

@@ -19,6 +19,7 @@ enum RoutesEnum: string
 
     case AdminClients = 'admin/clients';
     case AdminClientsShow = 'admin/clients/show';
+    case AdminClientsEdit = 'admin/clients/edit';
     case AdminClientsAdd = 'admin/clients/add';
     case AdminClientsResetSecret = 'admin/clients/reset-secret';
     case AdminClientsDelete = 'admin/clients/delete';

src/Codebooks/RoutesEnum.php

@@ -168,7 +168,7 @@ public function add(): Response
 
             $owner = $this->authorization->isAdmin() ? null : $this->authorization->getUserId();
 
-            $client = $this->buildClientFromFormData(
+            $client = $this->buildClientEntityFromFormData(
                 $form,
                 $this->sspBridge->utils()->random()->generateID(),
                 $this->sspBridge->utils()->random()->generateID(),
@@ -179,6 +179,8 @@ public function add(): Response
                 $owner,
             );
 
+            // TODO mivanci Check if the entity identifier already exists.
+
             $this->clientRepository->add($client);
 
             // Also persist allowed origins for this client.
@@ -209,11 +211,75 @@ public function add(): Response
         );
     }
 
+    /**
+     * @throws \SimpleSAML\Error\ConfigurationError
+     * @throws \SimpleSAML\Module\oidc\Server\Exceptions\OidcServerException
+     * @throws \SimpleSAML\Error\Exception
+     * @throws \SimpleSAML\Module\oidc\Exceptions\OidcException
+     * @throws \JsonException
+     */
+    public function edit(Request $request): Response
+    {
+        $originalClient = $this->getClientFromRequest($request);
+        $clientAllowedOrigins = $this->allowedOriginRepository->get($originalClient->getIdentifier());
+        $form = $this->formFactory->build(ClientForm::class);
+
+        $clientData = $originalClient->toArray();
+        $clientData['allowed_origin'] = $clientAllowedOrigins;
+        $form->setDefaults($clientData);
+
+        if ($form->isSuccess()) {
+            $updatedAt = $this->helpers->dateTime()->getUtc();
+
+            $updatedClient = $this->buildClientEntityFromFormData(
+                $form,
+                $originalClient->getIdentifier(),
+                $originalClient->getSecret(),
+                $originalClient->getRegistrationType(),
+                $updatedAt,
+                $originalClient->getCreatedAt(),
+                $originalClient->getExpiresAt(),
+                $originalClient->getOwner(),
+            );
+
+            // TODO mivanci Check if the entity identifier already exists for other client.
+
+            $this->clientRepository->update($updatedClient);
+
+            // Also persist allowed origins for this client.
+            is_array($allowedOrigins = $form->getValues('array')['allowed_origin'] ?? []) ||
+            throw new OidcException('Unexpected value for allowed origins.');
+            /** @var string[] $allowedOrigins */
+            $this->allowedOriginRepository->set($originalClient->getIdentifier(), $allowedOrigins);
+
+            $this->sessionMessagesService->addMessage(Translate::noop('Client has been updated.'));
+
+            return $this->routes->getRedirectResponseToModuleUrl(
+                RoutesEnum::AdminClientsShow->value,
+                [ParametersEnum::ClientId->value => $originalClient->getIdentifier()],
+            );
+        }
+
+        return $this->templateFactory->build(
+            'oidc:clients/edit.twig',
+            [
+                'originalClient' => $originalClient,
+                'form' => $form,
+                'actionRoute' => $this->routes->urlAdminClientsEdit($originalClient->getIdentifier()),
+                'regexUri' => ClientForm::REGEX_URI,
+                'regexAllowedOriginUrl' => ClientForm::REGEX_ALLOWED_ORIGIN_URL,
+                'regexHttpUri' => ClientForm::REGEX_HTTP_URI,
+                'regexHttpUriPath' => ClientForm::REGEX_HTTP_URI_PATH,
+            ],
+            RoutesEnum::AdminClients->value,
+        );
+    }
+
     /**
      * TODO mivanci Move to ClientEntityFactory::fromRegistrationData on dynamic client registration implementation.
      * @throws \SimpleSAML\Module\oidc\Exceptions\OidcException
      */
-    protected function buildClientFromFormData(
+    protected function buildClientEntityFromFormData(
         Form $form,
         string $identifier,
         string $secret,