Replace content with rework content

Author: S3Prototype

app/routes/actions+/search.tsx

@@ -1,34 +1,35 @@
 import type { LoaderArgs } from "@vercel/remix";
 import { json } from "@vercel/remix";
-import { getPosts, getDocs } from '~/utils/blog.server';
-import {getDomainUrl} from '~/utils'
+import { getPosts, getDocs } from "~/utils/blog.server";
+import { getDomainUrl } from "~/utils";
 
 export let loader = async ({ request }: LoaderArgs) => {
-  const blogUrl = `${getDomainUrl(request)}`
-  
+  const blogUrl = `${getDomainUrl(request)}`;
+
   let url = new URL(request.url);
   let term = url.searchParams.get("term");
 
-  let [posts, docs] = await Promise.all([
-    getPosts(),
-    getDocs(),
-  ]);    
+  let [posts, docs] = await Promise.all([getPosts(), getDocs()]);
 
-  const postUrls = [...posts, ...docs].map( post => {
-    let url = post.url.replace("//", "/");
-    return {
+  const postUrls =
+    [...posts, ...docs].map((post) => {
+      let url = post.url.replace("//", "/");
+      return {
         url: `${blogUrl}${url}`,
-        title: post.attributes.meta.title,
+        title: post.attributes?.meta?.title ?? post.attributes?.title,
         body: post.body,
-        type: url.includes('docs/') ? 'Docs' : 'Blog',
-    } 
-  }) || []
-  
+        type: url.includes("docs/") ? "Docs" : "Blog",
+      };
+    }) || [];
+
   // this function should query the DB or fetch an API to get the users
-  const results = term ? postUrls.filter(
-    post => post.title.toLowerCase().includes( String(term) ) || 
-    post.body.toLowerCase().includes( String(term) ) 
-  ) : []
-  
+  const results = term
+    ? postUrls.filter(
+        (post) =>
+          post.title.toLowerCase().includes(String(term)) ||
+          post.body.toLowerCase().includes(String(term))
+      )
+    : [];
+
   return json({ results });
-};
+};

content/blog-cache.json

@@ -1 +1 @@
-[{"attributes":{"meta":{"title":"Hello World","description":"Isn't this awesome?"},"date":"2022-08-02T00:00:00","excerpt":"Hello","headers":{"Cache-Control":"no-cache"}},"body":"...","url":"/blog/hello-world"},{"attributes":{"meta":{"title":"Another Post","description":"Isn't this awesome?"},"date":"2021-10-02T00:00:00","excerpt":"Hello Gaseous cloud...","headers":{"Cache-Control":"no-cache"}},"body":"...","url":"/blog/another-post"},{"attributes":{"meta":{"title":"ABC","description":"Isn't this awesome?"},"date":"2021-10-02T00:00:00","excerpt":"Hello Gaseous cloud...","headers":{"Cache-Control":"no-cache"}},"body":"...","url":"/blog/hello-world/abc"},{"attributes":{"meta":{"title":"A test","description":"Isn't this awesome?"},"date":"2021-10-02T00:00:00","excerpt":"More Testin","headers":{"Cache-Control":"no-cache"}},"body":"...","url":"/blog/2022/test"},{"attributes":{"meta":{"title":"More Hello","description":"Isn't this awesome?"},"date":"2021-10-02T00:00:00","excerpt":"Hello Gaseous cloud...","headers":{"Cache-Control":"no-cache"}},"body":"...","url":"/blog/hello-world/more-hello"}]
+[{"attributes":{"meta":{"title":"Hello World","description":"Isn't this awesome?"},"date":"2022-08-02T00:00:00","excerpt":"Hello","headers":{"Cache-Control":"no-cache"}},"body":"...","url":"/blog/hello-world"},{"attributes":{"meta":{"title":"ABC","description":"Isn't this awesome?"},"date":"2021-10-02T00:00:00","excerpt":"Hello Gaseous cloud...","headers":{"Cache-Control":"no-cache"}},"body":"...","url":"/blog/hello-world/abc"},{"attributes":{"meta":{"title":"Another Post","description":"Isn't this awesome?"},"date":"2021-10-02T00:00:00","excerpt":"Hello Gaseous cloud...","headers":{"Cache-Control":"no-cache"}},"body":"...","url":"/blog/another-post"},{"attributes":{"meta":{"title":"A test","description":"Isn't this awesome?"},"date":"2021-10-02T00:00:00","excerpt":"More Testin","headers":{"Cache-Control":"no-cache"}},"body":"...","url":"/blog/2022/test"},{"attributes":{"meta":{"title":"More Hello","description":"Isn't this awesome?"},"date":"2021-10-02T00:00:00","excerpt":"Hello Gaseous cloud...","headers":{"Cache-Control":"no-cache"}},"body":"...","url":"/blog/hello-world/more-hello"}]

content/docs-cache.json

@@ -0,0 +1,249 @@
+---
+title: Agent TLS Termination
+---
+
+# Agent TLS Termination
+
+Agent TLS termination enables you to secure your traffic with end-to-end encryption without needing to reconfigure your server.
+
+:::tip
+If your service doesn't support TLS termination, you can still use Agent TLS termination with [Zero-Knowledge TLS](/traffic-policy/actions/terminate-tls/#zero-knowledge-tls).
+:::
+
+## Quickstart
+
+The following instructions will guide you through setting up Agent TLS termination with ngrok.
+
+### Prerequisites
+
+- [openssl](https://docs.openiam.com/docs-4.2.1.3/appendix/2-openssl)
+
+### **Step 1** – Generate a cert and key pair
+
+The following command:
+
+1. Generates a new certificate signing request (CSR) for a 4096-bit RSA key pair.
+   - The key is saved to `your-key.key`.
+1. Creates a self-signed certificate which:
+   - Is in x509 format and uses the SHA-256 hash algorithm.
+   - Is valid for 365 days.
+   - Is saved to `your-cert.crt`.
+
+```bash
+openssl req -new -newkey rsa:4096 -x509 -sha256 -days 365 -noenc -out your-cert.crt -keyout your-key.key
+```
+
+### **Step 2** – Configure your endpoint
+
+You can configure your endpoint with an [agent configuration file](/agent/config/). To create a new configuration file with your generated cert and key pair, run the following command:
+
+```bash
+ngrok config add-authtoken you-authtoken
+```
+
+Your generated configuration file should resemble the following:
+
+```yaml
+version: 3
+agent:
+  authtoken: your-authtoken
+endpoints:
+  - name: demo-tls
+    url: "tls://your-domain.ngrok.app"
+    upstream:
+      url: 12345
+    agent_tls_termination:
+      server_certificate: /path/to/your-cert.crt
+      server_private_key: /path/to/your-key.key
+```
+
+:::tip
+You can run `ngrok config edit` to open the configuration file in your default text editor. [Learn more about the `ngrok config` command](/agent/cli/#ngrok-config).
+:::
+
+### **Step 3** – Start your endpoint
+
+Next, use `ngrok start endpoint_name_here` in the terminal to start an endpoint using the settings in your agent configuration file, as shown below:
+
+```bash
+ngrok start demo-tls
+```
+
+### **Step 4** – Start your upstream server
+
+Start an upstream server on the specified port (e.g., `12345`) to handle incoming requests. The following example uses Python, but you can use any language or framework depending on your requirements.
+
+```python
+import socket
+
+host='127.0.0.1'
+port=12345
+server = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+server.bind((host, port))
+print(f"Server started on {host}:{port}")
+server.listen(1)
+
+while True:
+    client, client_address = server.accept()
+    print(f"Connection established with {client_address}")
+    client.sendall(b"hello, world!")
+    client.close()
+    print(f"Connection with {client_address} closed")
+```
+
+### **Step 5** – Try connecting to your endpoint
+
+The following example uses `openssl s_client` to initiate an SSL/TLS client connection to your upstream server without a certificate.
+
+```bash
+openssl s_client -quiet -connect your-domain.ngrok.app:443 -verify_return_error
+```
+
+```bash
+Connecting to 2600:1f16:d83:1200::6e:0
+depth=0 C=AU, ST=Some-State, O=Internet Widgits Pty Ltd, CN=your-domain.ngrok.app
+verify error:num=18:self-signed certificate
+408FB6F801000000:error:0A000086:SSL routines:tls_post_process_server_certificate:certificate verify failed:ssl/statem/statem_clnt.c:2093:
+```
+
+The following example uses `openssl s_client` to initiate an SSL/TLS client connection to your upstream server with a certificate.
+
+```bash
+openssl s_client -quiet -connect your-domain.ngrok.app:443 -verify_return_error -CAfile your-cert.crt
+```
+
+```bash
+Connecting to 2600:1f16:d83:1200::6e:0
+depth=0 C=AU, ST=Some-State, O=Internet Widgits Pty Ltd, CN=your-domain.ngrok.app
+verify return:1
+hello, world!%
+```
+
+:::note
+The extra arguments added to the command suppress most of the output so that only the data exchanged with the server will be displayed.
+:::
+
+## Mutual TLS example
+
+The following instructions will guide you through setting up Agent TLS termination using [Mutual TLS (mTLS)](/guides/other-guides/using-tls-mutual-authentication/) with ngrok.
+
+### **Step 1** – Generate a root CA private key and certificate
+
+```yaml
+openssl genpkey -algorithm RSA -out your-ca.key -pkeyopt rsa_keygen_bits:2048
+openssl req -x509 -new -nodes -key your-ca.key -sha256 -days 365 -out your-ca.crt -subj "/CN=YourDemoCA"
+```
+
+### **Step 2** – Generate server credentials
+
+The following terminal commands will generate these server credentials:
+
+- A server private key
+- A CSR
+- A signed certificate
+
+```bash
+openssl genpkey -algorithm RSA -out your-server.key -pkeyopt rsa_keygen_bits:2048
+openssl req -new -key your-server.key -out your-server.csr -subj "/CN=your-domain.ngrok.app"
+openssl x509 -req -in your-server.csr -CA your-ca.crt -CAkey your-ca.key -CAcreateserial -out your-server.crt -days 365 -sha256
+```
+
+### **Step 3** – Generate client credentials
+
+The following terminal command will generate these client credentials:
+
+- A private key
+- A CSR
+- A signed certificate
+
+```yaml
+openssl genpkey -algorithm RSA -out your-client.key -pkeyopt rsa_keygen_bits:2048
+openssl req -new -key your-client.key -out your-client.csr -subj "/CN=YourDemoCA"
+openssl x509 -req -in your-client.csr -CA your-ca.crt -CAkey your-ca.key -CAcreateserial -out your-client.crt -days 365 -sha256
+```
+
+### **Step 4** – Configure your mTLS endpoint
+
+Use the following command to create an agent configuration file with your generated certificates:
+
+```bash
+ngrok config add-authtoken you-authtoken
+```
+
+Your generated configuration file should resemble the following:
+
+```yaml
+version: 3
+agent:
+  authtoken: your-token
+endpoints:
+  - name: demo-mtls
+    url: "tls:/your-domain.ngrok.app"
+    upstream:
+      url: 8080
+    agent_tls_termination:
+      server_certificate: /path/to/your-cert.crt
+      server_private_key: /path/to/your-key.key
+      mutual_tls_certificate_authorities:
+        - /path/to/your-ca.crt
+```
+
+### **Step 5** – Start your mTLS endpoint
+
+Next, use `ngrok start endpoint_name_here` in the terminal to start an endpoint using the settings in your agent configuration file, as shown below:
+
+```bash
+ngrok start demo-mtls
+```
+
+### **Step 6** – Start your upstream server
+
+Start an upstream server on the specified port (e.g., `12345`) to handle incoming requests. The following example uses Python, but you can use any language or framework depending on your requirements.
+
+```python
+import socket
+
+host='127.0.0.1'
+port=12345
+server = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+server.bind((host, port))
+print(f"Server started on {host}:{port}")
+server.listen(1)
+
+while True:
+    client, client_address = server.accept()
+    print(f"Connection established with {client_address}")
+    client.sendall(b"hello, world!")
+    client.close()
+    print(f"Connection with {client_address} closed")
+```
+
+### **Step 7** – Try connecting to your mTLS endpoint
+
+The following example uses `openssl s_client` to initiate an SSL/TLS client connection to your upstream server without a certificate.
+
+```bash
+openssl s_client -quiet -connect your-domain.ngrok.app:443 -verify_return_error
+```
+
+```bash
+Connecting to 2600:1f16:d83:1200::6e:3
+depth=0 CN=your-domain.ngrok.app
+verify error:num=20:unable to get local issuer certificate
+408FB6F801000000:error:0A000086:SSL routines:tls_post_process_server_certificate:certificate verify failed:ssl/statem/statem_clnt.c:2093
+```
+
+The following example uses `openssl s_client` to initiate an SSL/TLS client connection to your upstream server with a certificate.
+
+```bash
+openssl s_client -quiet -connect your-domain.ngrok.app:443 -verify_return_error -CAfile your-ca.crt
+```
+
+```bash
+Connecting to 2600:1f16:d83:1200::6e:3
+depth=1 CN=YourDemoCA
+verify return:1
+depth=0 CN=your-domain.ngrok.app
+verify return:1
+hello, world!%
+```

content/docs/agent/agent-tls-termination.mdx

@@ -72,7 +72,7 @@ GET/api/tunnels
         {
             "name": "command_line",
             "uri": "/api/tunnels/command_line",
-            "public_url": "https://d95211d2.ngrok.io",
+            "public_url": "https://d95211d2.ngrok.app",
             "proto": "https",
             "config": {
                 "addr": "localhost:80",
@@ -188,7 +188,7 @@ GET/api/tunnels/:name
 {
     "name": "command_line",
     "uri": "/api/tunnels/command_line",
-    "public_url": "https://ac294125.ngrok.io",
+    "public_url": "https://ac294125.ngrok.app",
     "proto": "https",
     "config": {
         "addr": "localhost:80",
@@ -292,7 +292,7 @@ curl http://localhost:4040/api/requests/http?limit=50
                         "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/39.0.2171.71 Safari/537.36"
                     ],
                     "X-Original-Host": [
-                        "c159663f.ngrok.io"
+                        "c159663f.ngrok.app"
                     ]
                 },
                 "uri": "/favicon.ico",
@@ -392,7 +392,7 @@ GET/api/requests/http/:request_id
                 "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/39.0.2171.71 Safari/537.36"
             ],
             "X-Original-Host": [
-                "c159663f.ngrok.io"
+                "c159663f.ngrok.app"
             ]
         },
         "uri": "/favicon.ico",