Merge branch 'main' into draft-comprehensive-guide-to-passwordless-au…

…thentication

DocsDevREADME.md

@@ -230,7 +230,7 @@ Fruits were domesticated at different times.
 - OAuth and OAuth2
 - re-authentication
 - self-service
-- server-side
+- server-side (an adjective)
 - Spring Boot
 - third-party
 - two-factor

astro/public/sitemap.xml

@@ -186,6 +186,9 @@
     <url>
         <loc>https://fusionauth.io/download</loc>
     </url>
+    <url>
+        <loc>https://fusionauth.io/get-started</loc>
+    </url>
     <url>
         <loc>https://fusionauth.io/password-history</loc>
     </url>

astro/src/components/BlogNewsletterCTA.astro

@@ -1,7 +1,6 @@
 ---
 ---
 <div class="hidden mb-10 lg:block">
-  <h2 class="font-bold mb-3 text-slate-800 text-xl md:font-inter md:font-bold md:leading-tight md:text-xl">The FusionAuth Newsletter</h2>
   <hr class="bg-slate-200 border-t-0 h-0.5 mb-2"/>
   <p class="font-inter leading-6 mb-3 sm:text-base md:leading-7 md:text-lg lg:text-base">Get the best of FusionAuth. Once a month. Directly
     to your inbox.</p>

astro/src/components/SubscribeFooterCTA.astro

@@ -5,8 +5,7 @@
   <div
     class="2xl:p-20 border-2 border-indigo-600 border-solid container grid grid-cols-1 lg:flex lg:grid-cols-2 lg:p-10 lg:place-self-center lg:text-left m-auto max-w-8xl mx-auto px-4 py-8 rounded-lg sm:text-center xl:inline-flex xl:mx-20 xl:pt-10">
     <div class="mb-10 lg:mb-auto lg:pr-14 xl:mb-auto">
-      <h2 class="font-bold leading-6 mb-5 text-2xl text-white md:font-Inter md:font-bold md:leading-7 md:text-3xl md:tracking-tight">Subscribe to The FusionAuth Newsletter</h2>
-      <p class="font-Inter font-medium leading-6 text-md text-slate-300">A newsletter for developers covering techniques, technical guides, and the latest product innovations coming from FusionAuth.</p>
+      <p class="font-Inter font-medium leading-6 text-md text-slate-300">Get updates on techniques, technical guides, and the latest product innovations coming from FusionAuth.</p>
     </div>
     <div class="sm:place-self-center lg:justify-center lg:place-items-stretch xl:place-self-center xl:pr-14">
       <form class="flex flex-col mb-2 sm:flex-row" method="post" action="https://fusionauth.us1.list-manage.com/subscribe/post?u=e49fa3727e80f8a81984ec45e&amp;id=82607f973e">

astro/src/components/docs/operate/secure-and-monitor/opentelemetryDiagram1.astro

@@ -0,0 +1,34 @@
+---
+import Diagram from 'src/components/mermaid/FlowchartDiagram.astro';
+
+const { alt } = Astro.props;
+
+//language=Mermaid
+const code = `
+graph LR
+  subgraph I[Your server]
+    direction TB
+    subgraph G[Docker]
+      H[(PostgreSQL)]
+    end
+    subgraph C[Docker]
+      A(FusionAuth)
+    end
+    subgraph E[Docker]
+      F(Your app)
+    end
+  end
+  D(User)
+  D --> F
+  D --> A
+  C --> G
+  F --> A
+  style I fill:#999
+`;
+---
+<Diagram {code} alt={alt} />
+<style is:global>
+    foreignObject > div {
+        transform: translateY(-4px);
+    }
+</style>

astro/src/components/docs/operate/secure-and-monitor/opentelemetryDiagram2.astro

@@ -0,0 +1,49 @@
+---
+import Diagram from 'src/components/mermaid/FlowchartDiagram.astro';
+
+const { alt } = Astro.props;
+
+//language=Mermaid
+const code = `
+graph LR
+  D(User)
+  subgraph I[Your server]
+    subgraph G[Docker]
+      H[(PostgreSQL)]
+    end
+    subgraph C[Docker]
+      A(FusionAuth)
+    end
+    subgraph P[Docker]
+      Q(OpenTelemetry Collector)
+    end
+    subgraph E[Docker]
+      B(Prometheus)
+    end
+    subgraph K[Docker]
+      L(bash script)
+    end
+    subgraph J[Docker]
+      F(Your app)
+    end
+  end
+  D --> J
+  D --> C
+  C --> G
+  F --> C
+  K --> |pushes metrics to| P
+  E --> |pulls metrics from| P
+  P --> |pull Prometheus metrics from| C
+  K --> |pull custom metrics from| C
+  style I fill:#999
+  style E fill:#944
+  style K fill:#944
+  style P fill:#944
+`;
+---
+<Diagram {code} alt={alt} />
+<style is:global>
+    foreignObject > div {
+        transform: translateY(-4px);
+    }
+</style>

astro/src/components/docs/operate/secure-and-monitor/prometheusDiagram1.astro

@@ -0,0 +1,33 @@
+---
+import Diagram from 'src/components/mermaid/FlowchartDiagram.astro';
+
+const { alt } = Astro.props;
+
+//language=Mermaid
+const code = `
+graph LR
+  D(User)
+  subgraph I[Your server]
+    subgraph G[Docker]
+      H[(PostgreSQL)]
+    end
+    subgraph C[Docker]
+      A(FusionAuth)
+    end
+    subgraph J[Docker]
+      F(Your app)
+    end
+  end
+  D --> J
+  D --> C
+  C --> G
+  F --> C
+  style I fill:#999
+`;
+---
+<Diagram {code} alt={alt} />
+<style is:global>
+    foreignObject > div {
+        transform: translateY(-4px);
+    }
+</style>

astro/src/components/docs/operate/secure-and-monitor/prometheusDiagram2.astro

@@ -0,0 +1,38 @@
+---
+import Diagram from 'src/components/mermaid/FlowchartDiagram.astro';
+
+const { alt } = Astro.props;
+
+//language=Mermaid
+const code = `
+graph LR
+  D(User)
+  subgraph I[Your server]
+    subgraph G[Docker]
+      H[(PostgreSQL)]
+    end
+    subgraph C[Docker]
+      A(FusionAuth)
+    end
+    subgraph E[Docker]
+      B(Prometheus)
+    end
+    subgraph J[Docker]
+      F(Your app)
+    end
+  end
+  D --> J
+  D --> C
+  C --> G
+  F --> C
+  E --> |Prometheus pulls metrics from FusionAuth| C
+  style I fill:#999
+  style E fill:#944
+`;
+---
+<Diagram {code} alt={alt} />
+<style is:global>
+    foreignObject > div {
+        transform: translateY(-4px);
+    }
+</style>

astro/src/components/docs/operate/secure-and-monitor/prometheusDiagram3.astro

@@ -0,0 +1,46 @@
+---
+import Diagram from 'src/components/mermaid/FlowchartDiagram.astro';
+
+const { alt } = Astro.props;
+
+//language=Mermaid
+const code = `
+graph LR
+  D(User)
+  N(Ntfy.sh)
+  subgraph I[Your server]
+    subgraph G[Docker]
+      H[(PostgreSQL)]
+    end
+    subgraph C[Docker]
+      A(FusionAuth)
+    end
+    subgraph E[Docker]
+      B(Prometheus)
+    end
+    subgraph K[Docker]
+      L(AlertManager)
+    end
+    subgraph J[Docker]
+      F(Your app)
+    end
+  end
+  D --> J
+  D --> C
+  C --> G
+  F --> C
+  E --> |Prometheus pulls metrics from FusionAuth| C
+  E --> K
+  K --> N
+  style I fill:#999
+  style E fill:#944
+  style K fill:#944
+  style N fill:#944
+`;
+---
+<Diagram {code} alt={alt} />
+<style is:global>
+    foreignObject > div {
+        transform: translateY(-4px);
+    }
+</style>

astro/src/components/docs/operate/secure-and-monitor/prometheusDiagram4.astro

@@ -0,0 +1,43 @@
+---
+import Diagram from 'src/components/mermaid/FlowchartDiagram.astro';
+
+const { alt } = Astro.props;
+
+//language=Mermaid
+const code = `
+graph LR
+  D(User)
+  subgraph I[Your server]
+    subgraph G[Docker]
+      H[(PostgreSQL)]
+    end
+    subgraph C[Docker]
+      A(FusionAuth)
+    end
+    subgraph E[Docker]
+      B(Prometheus)
+    end
+    subgraph J[Docker]
+      F(Your app)
+    end
+    subgraph M[Docker]
+      O(Grafana)
+    end
+  end
+  D --> J
+  D --> C
+  C --> G
+  F --> C
+  E --> |Prometheus pulls metrics from FusionAuth| C
+  M --> E
+  style I fill:#999
+  style E fill:#944
+  style M fill:#944
+`;
+---
+<Diagram {code} alt={alt} />
+<style is:global>
+    foreignObject > div {
+        transform: translateY(-4px);
+    }
+</style>

astro/src/components/docs/operate/secure-and-monitor/prometheusDiagram5.astro

@@ -0,0 +1,63 @@
+---
+import Diagram from 'src/components/mermaid/FlowchartDiagram.astro';
+
+const { alt } = Astro.props;
+
+//language=Mermaid
+const code = `
+graph LR
+  D(User)
+  N(Ntfy.sh)
+  subgraph I[Your server]
+    subgraph G[Docker]
+      H[(PostgreSQL)]
+    end
+    subgraph C[Docker]
+      A(FusionAuth)
+    end
+    subgraph E[Docker]
+      B(Prometheus)
+    end
+    subgraph K[Docker]
+      L(AlertManager)
+    end
+    subgraph P[Docker]
+      Q(Loki)
+    end
+    subgraph R[Docker]
+      S(Promtail)
+    end
+    subgraph J[Docker]
+      F(Your app)
+    end
+    subgraph M[Docker]
+      O(Grafana)
+    end
+  end
+  D --> J
+  D --> C
+  C --> G
+  F --> C
+  E --> C
+  E --> K
+  K --> N
+  M --> E
+  E --> |Prometheus reads Loki logs| P
+  R --> |Promtail reads FusionAuth logs| C
+  R --> |Promtail sends logs to Loki| P
+  M --> |Grafana queries Loki logs| P
+  style I fill:#999
+  style E fill:#944
+  style K fill:#944
+  style N fill:#944
+  style M fill:#944
+  style P fill:#944
+  style R fill:#944
+`;
+---
+<Diagram {code} alt={alt} />
+<style is:global>
+    foreignObject > div {
+        transform: translateY(-4px);
+    }
+</style>

astro/src/components/docs/operate/secure-and-monitor/whatIsOpentelemetry.mdx

@@ -0,0 +1,9 @@
+[OpenTelemetry](https://opentelemetry.io/docs) is an open-source framework (suite of apps) and a protocol for collecting information about a running application.
+
+You can either use an OpenTelemetry library as a module in your code, which you call manually to send it application-specific metrics (instrumentation), or you can use a stock OpenTelemetry instrumentation agent, like the Java Virtual Machine agent, that collects general information about your application as it runs.
+
+You could also collect metrics about your application through another tool and send them to an OpenTelemetry Collector service through OTLP (OpenTelemetry Protocol), a standardized way of exchanging telemetry data between tools. The collector acts as a central point to receive all metrics, potentially do some simple filtering, and forward the metrics to other services.
+
+OpenTelemetry does not handle storage, data aggregation (counting things), or visualization (dashboards).
+
+For example, you could run the OpenTelemetry Java agent before running your app. The agent would monitor the RAM use of your app as a metric and send it to an OpenTelemetry Collector, which would forward the metric to another service for saving, counting, and displaying in a dashboard.

astro/src/components/icon/GreenCheck.astro

@@ -0,0 +1,4 @@
+---
+
+---
+<i class="fa-solid fa-check text-green-600 font-bold"></i>

astro/src/components/icon/RedX.astro

@@ -0,0 +1,4 @@
+---
+
+---
+<i class="fa-solid fa-xmark text-red-700 font-bold"></i>