From 2376ef8b8ce9f62ff97bbfd0439beac1158b8508 Mon Sep 17 00:00:00 2001
From: RMidhunSuresh <hi@midhun.dev>
Date: Tue, 6 Sep 2022 01:26:45 +0530
Subject: [PATCH] Write plugin for Dex

---
 cypress/plugins/dex/index.ts             | 132 +++++++++++++++++++++++
 cypress/plugins/dex/template/config.yaml |  56 ++++++++++
 cypress/plugins/dex/template/dev.db      | Bin 0 -> 110592 bytes
 cypress/plugins/index.ts                 |   2 +
 cypress/support/dex.ts                   |  51 +++++++++
 cypress/support/e2e.ts                   |   1 +
 6 files changed, 242 insertions(+)
 create mode 100644 cypress/plugins/dex/index.ts
 create mode 100755 cypress/plugins/dex/template/config.yaml
 create mode 100755 cypress/plugins/dex/template/dev.db
 create mode 100644 cypress/support/dex.ts

diff --git a/cypress/plugins/dex/index.ts b/cypress/plugins/dex/index.ts
new file mode 100644
index 00000000..b07a78e8
--- /dev/null
+++ b/cypress/plugins/dex/index.ts
@@ -0,0 +1,132 @@
+/*
+Copyright 2022 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+/// <reference types="cypress" />
+
+import * as path from "path";
+import * as os from "os";
+import * as fse from "fs-extra";
+
+import PluginEvents = Cypress.PluginEvents;
+import PluginConfigOptions = Cypress.PluginConfigOptions;
+import {dockerRun, dockerStop } from "../docker";
+
+// A cypress plugins to add command to start & stop dex instances
+
+interface DexConfig {
+    configDir: string;
+    baseUrl: string;
+    port: number;
+    host: string;
+}
+
+export interface DexInstance extends DexConfig {
+    dexId: string;
+}
+
+const dexConfigs = new Map<string, DexInstance>();
+let env;
+
+async function produceConfigWithSynapseURLAdded(): Promise<DexConfig> {
+    const templateDir = path.join(__dirname, "template");
+
+    const stats = await fse.stat(templateDir);
+    if (!stats?.isDirectory) {
+        throw new Error(`Template directory at ${templateDir} not found!`);
+    }
+    const tempDir = await fse.mkdtemp(path.join(os.tmpdir(), 'hydrogen-testing-dex-'));
+
+    // copy the contents of the template dir, omitting config.yaml as we'll template that
+    console.log(`Copy ${templateDir} -> ${tempDir}`);
+    await fse.copy(templateDir, tempDir, { filter: f => path.basename(f) !== 'config.yaml' });
+
+    // now copy config.yaml, applying substitutions
+    console.log(`Gen ${path.join(templateDir, "config.yaml")}`);
+    let hsYaml = await fse.readFile(path.join(templateDir, "config.yaml"), "utf8");
+    const synapseAddress = `${env.SYNAPSE_IP_ADDRESS}:${env.SYNAPSE_PORT}`;
+    hsYaml = hsYaml.replace(/{{SYNAPSE_ADDRESS}}/g, synapseAddress);
+    const host = env.DEX_IP_ADDRESS;
+    const port = env.DEX_PORT;
+    const dexAddress = `${host}:${port}`;
+    hsYaml = hsYaml.replace(/{{DEX_ADDRESS}}/g, dexAddress);
+    await fse.writeFile(path.join(tempDir, "config.yaml"), hsYaml);
+
+    const baseUrl = `http://${host}:${port}`;
+    return {
+        host,
+        port,
+        baseUrl,
+        configDir: tempDir,
+    };
+}
+
+async function dexStart(): Promise<DexInstance> {
+    const dexCfg = await produceConfigWithSynapseURLAdded();
+    console.log(`Starting dex with config dir ${dexCfg.configDir}...`);
+    const dexId = await dockerRun({
+        image: "bitnami/dex:latest",
+        containerName: "dex",
+        dockerParams: [
+            "--rm",
+            "-v", `${dexCfg.configDir}:/data`,
+            `--ip=${dexCfg.host}`,
+            "-p", `${dexCfg.port}:5556/tcp`,
+            "--network=hydrogen"
+        ],
+        applicationParams: [
+            "serve",
+            "data/config.yaml",
+        ]
+    });
+
+    console.log(`Started dex with id ${dexId} on port ${dexCfg.port}.`);
+
+    const dex: DexInstance = { dexId, ...dexCfg };
+    dexConfigs.set(dexId, dex);
+    return dex;
+}
+
+async function dexStop(id: string): Promise<void> {
+    const dexCfg = dexConfigs.get(id);
+    if (!dexCfg) throw new Error("Unknown dex ID");
+    await dockerStop({ containerId: id, });
+    await fse.remove(dexCfg.configDir);
+    dexConfigs.delete(id);
+    console.log(`Stopped dex id ${id}.`);
+    // cypress deliberately fails if you return 'undefined', so
+    // return null to signal all is well, and we've handled the task.
+    return null;
+}
+
+/**
+ * @type {Cypress.PluginConfig}
+ */
+export function dexDocker(on: PluginEvents, config: PluginConfigOptions) {
+    env = config.env;
+
+    on("task", {
+        dexStart,
+        dexStop,
+    });
+
+    on("after:spec", async (spec) => {
+        for (const dexId of dexConfigs.keys()) {
+            console.warn(`Cleaning up dex ID ${dexId} after ${spec.name}`);
+            await dexStop(dexId);
+        }
+    });
+}
+
diff --git a/cypress/plugins/dex/template/config.yaml b/cypress/plugins/dex/template/config.yaml
new file mode 100755
index 00000000..f773eb76
--- /dev/null
+++ b/cypress/plugins/dex/template/config.yaml
@@ -0,0 +1,56 @@
+issuer: http://{{DEX_ADDRESS}}/dex
+
+storage:
+  type: sqlite3
+  config:
+    file: data/dev.db
+
+
+# Configuration for the HTTP endpoints.
+web:
+  http: 0.0.0.0:5556
+  # Uncomment for HTTPS options.
+  # https: 127.0.0.1:5554
+  # tlsCert: /etc/dex/tls.crt
+  # tlsKey: /etc/dex/tls.key
+
+# Configuration for telemetry
+telemetry:
+  http: 0.0.0.0:5558
+  # enableProfiling: true
+
+staticClients:
+- id: synapse
+  secret: secret
+  redirectURIs:
+  - 'http://{{SYNAPSE_ADDRESS}}/_synapse/client/oidc/callback'
+  name: 'Synapse'
+connectors:
+- type: mockCallback
+  id: mock
+  name: Example
+# - type: google
+#   id: google
+#   name: Google
+#   config:
+#     issuer: https://accounts.google.com
+#     # Connector config values starting with a "$" will read from the environment.
+#     clientID: $GOOGLE_CLIENT_ID
+#     clientSecret: $GOOGLE_CLIENT_SECRET
+#     redirectURI: http://127.0.0.1:5556/dex/callback
+#     hostedDomains:
+#     - $GOOGLE_HOSTED_DOMAIN
+
+# Let dex keep a list of passwords which can be used to login to dex.
+enablePasswordDB: true
+
+# A static list of passwords to login the end user. By identifying here, dex
+# won't look in its underlying storage for passwords.
+#
+# If this option isn't chosen users may be added through the gRPC API.
+staticPasswords:
+- email: "admin@example.com"
+  # bcrypt hash of the string "password": $(echo password | htpasswd -BinC 10 admin | cut -d: -f2)
+  hash: "$2a$10$2b2cU8CPhOTaGrs1HRQuAueS7JTT5ZHsHSzYiFPm1leZck7Mc8T4W"
+  username: "admin"
+  userID: "08a8684b-db88-4b73-90a9-3cd1661f5466"
diff --git a/cypress/plugins/dex/template/dev.db b/cypress/plugins/dex/template/dev.db
new file mode 100755
index 0000000000000000000000000000000000000000..95a42aedb495111cfc33e6e614237d869a7373da
GIT binary patch
literal 110592
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
GzxjV@@^wuB

literal 0
HcmV?d00001

diff --git a/cypress/plugins/index.ts b/cypress/plugins/index.ts
index 44dd93b8..27c8b9a3 100644
--- a/cypress/plugins/index.ts
+++ b/cypress/plugins/index.ts
@@ -20,6 +20,7 @@ import PluginEvents = Cypress.PluginEvents;
 import PluginConfigOptions = Cypress.PluginConfigOptions;
 import { performance } from "./performance";
 import { synapseDocker } from "./synapsedocker";
+import { dexDocker } from "./dex";
 import { webserver } from "./webserver";
 import { docker } from "./docker";
 import { log } from "./log";
@@ -31,6 +32,7 @@ export default function(on: PluginEvents, config: PluginConfigOptions) {
     docker(on, config);
     performance(on, config);
     synapseDocker(on, config);
+    dexDocker(on, config);
     webserver(on, config);
     log(on, config);
 }
diff --git a/cypress/support/dex.ts b/cypress/support/dex.ts
new file mode 100644
index 00000000..599eee26
--- /dev/null
+++ b/cypress/support/dex.ts
@@ -0,0 +1,51 @@
+/*
+Copyright 2022 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+/// <reference types="cypress" />
+
+import Chainable = Cypress.Chainable;
+import AUTWindow = Cypress.AUTWindow;
+import { DexInstance } from "../plugins/dex";
+
+declare global {
+    // eslint-disable-next-line @typescript-eslint/no-namespace
+    namespace Cypress {
+        interface Chainable {
+            /**
+             * Start the dex server
+             */
+            startDex(): Chainable<DexInstance>;
+
+            /**
+             * Stop the dex server
+             * @param dex the dex instance returned by startSynapse
+             */
+            stopDex(dex: DexInstance): Chainable<AUTWindow>;
+        }
+    }
+}
+
+function startDex(): Chainable<DexInstance> {
+    return cy.task<DexInstance>("dexStart");
+}
+
+function stopDex(dex?: DexInstance): Chainable<AUTWindow> {
+    if (!dex) return;
+    cy.task("dexStop", dex.dexId);
+}
+
+Cypress.Commands.add("startDex", startDex);
+Cypress.Commands.add("stopDex", stopDex);
diff --git a/cypress/support/e2e.ts b/cypress/support/e2e.ts
index 289319fe..d186c5a0 100644
--- a/cypress/support/e2e.ts
+++ b/cypress/support/e2e.ts
@@ -17,3 +17,4 @@ limitations under the License.
 /// <reference types="cypress" />
 
 import "./synapse";
+import "./dex";