diff --git a/pages/_meta.json b/pages/_meta.json index f2e6ac3..3b7a0cd 100644 --- a/pages/_meta.json +++ b/pages/_meta.json @@ -6,9 +6,5 @@ "guide": { "title": "User Guide", "type": "page" - }, - "knowledge": { - "title": "Knowledge Base", - "type": "page" } } \ No newline at end of file diff --git a/pages/guide/_meta.json b/pages/guide/_meta.json index 5de7d21..08d1355 100644 --- a/pages/guide/_meta.json +++ b/pages/guide/_meta.json @@ -1,6 +1,8 @@ { "index": "Overview", "getting-started": "Getting Started", + "concepts": "Core Concepts", "certificates": "Certificate Operations", - "integrations": "Integrations" + "integrations": "Integrations", + "troubleshooting": "Troubleshooting" } \ No newline at end of file diff --git a/pages/knowledge/fundamentals/_meta.json b/pages/guide/concepts/_meta.json similarity index 100% rename from pages/knowledge/fundamentals/_meta.json rename to pages/guide/concepts/_meta.json diff --git a/pages/knowledge/fundamentals/index.mdx b/pages/guide/concepts/index.mdx similarity index 100% rename from pages/knowledge/fundamentals/index.mdx rename to pages/guide/concepts/index.mdx diff --git a/pages/knowledge/fundamentals/pki-intro.mdx b/pages/guide/concepts/pki-intro.mdx similarity index 100% rename from pages/knowledge/fundamentals/pki-intro.mdx rename to pages/guide/concepts/pki-intro.mdx diff --git a/pages/knowledge/troubleshooting/_meta.json b/pages/guide/troubleshooting/_meta.json similarity index 100% rename from pages/knowledge/troubleshooting/_meta.json rename to pages/guide/troubleshooting/_meta.json diff --git a/pages/guide/troubleshooting/browser-errors.mdx b/pages/guide/troubleshooting/browser-errors.mdx new file mode 100644 index 0000000..d6d2dc8 --- /dev/null +++ b/pages/guide/troubleshooting/browser-errors.mdx @@ -0,0 +1,43 @@ +import { Callout, Cards, Card } from 'nextra/components' +import { AlertTriangle, Globe, Calendar, XCircle, HelpCircle } from 'lucide-react' + +# Common Browser Errors + +When using internal certificates, browsers are very strict. Below are the most common error codes and how to resolve them. + +### `NET::ERR_CERT_AUTHORITY_INVALID` + +}> + **The Logic:** The browser simply **does not know** the "TrustLab Root CA" that signed your website's certificate, so it assumes it's fake. + + +**Solution:** +You have not installed the Root CA on your device yet. +* [**Install Root CA Guide**](/guide/getting-started/install-root-ca) + +--- + +### `NET::ERR_CERT_COMMON_NAME_INVALID` + +}> + **The Logic:** You are visiting `app.local`, but the certificate was only issued for `api.local`. The names **do not match**. + + +**Solution:** +The domain is missing from the certificate's **SANs (Subject Alternative Names)**. +1. Click the **"Not Secure"** icon > **Certificate**. +2. Check the **DNS Name** or SAN field. +3. If missing, you must **[Generate a New Certificate](/guide/certificates/request-new)** that includes the correct domain. + +--- + +### `NET::ERR_CERT_DATE_INVALID` + +}> + **The Logic:** The certificate has expired, OR your computer's clock is set to the wrong date (past/future). + + +**Solution:** +1. Check your system clock first. +2. If the clock is correct, the certificate is truly expired. +3. **[Renew the Certificate](/guide/certificates/renewal)** immediately. diff --git a/pages/knowledge/_meta.json b/pages/knowledge/_meta.json deleted file mode 100644 index cb392b3..0000000 --- a/pages/knowledge/_meta.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "index": "Overview", - "fundamentals": "Fundamentals", - "troubleshooting": "Troubleshooting" -} \ No newline at end of file diff --git a/pages/knowledge/index.mdx b/pages/knowledge/index.mdx deleted file mode 100644 index 893214c..0000000 --- a/pages/knowledge/index.mdx +++ /dev/null @@ -1,7 +0,0 @@ -# Knowledge Base - -Understand the concepts behind Public Key Infrastructure (PKI) and find solutions to common problems. - -## Fundamentals - -- [What is PKI?](/knowledge/fundamentals/what-is-pki) diff --git a/pages/knowledge/troubleshooting/browser-errors.mdx b/pages/knowledge/troubleshooting/browser-errors.mdx deleted file mode 100644 index b34d3df..0000000 --- a/pages/knowledge/troubleshooting/browser-errors.mdx +++ /dev/null @@ -1,32 +0,0 @@ -# Common Browser Errors - -When using internal certificates, browsers are very strict. Here are common error codes and what they mean. - -## NET::ERR_CERT_AUTHORITY_INVALID hiding - -**Cause:** -The browser does not recognize the Root CA that issued the certificate. - -**Solution:** -You have not installed the TrustLab Root CA on your device. --> [Go to Installation Guide](/guide/getting-started/install-root-ca) - -## NET::ERR_CERT_COMMON_NAME_INVALID - -**Cause:** -The domain name you are visiting (e.g., `app.local`) does not match the names listed in the certificate. - -**Solution:** -Check the **SANs (Subject Alternative Names)** of the certificate. -1. Click the "Not Secure" icon in the address bar. -2. View Certificate. -3. Check "DNS Names". If the domain is missing, you must **Re-issue** the certificate. - -## NET::ERR_CERT_DATE_INVALID - -**Cause:** -The certificate has expired or the system clock is wrong. - -**Solution:** -1. Check your computer's date and time. -2. If time is correct, the certificate is expired. [Renew the certificate](/guide/certificates/renewal).