From 32dd5940298e5894d0d1d3ec5bbd13f6e0f97611 Mon Sep 17 00:00:00 2001
From: irenarindos <irena.rindos@gmail.com>
Date: Tue, 8 Mar 2022 16:00:44 -0500
Subject: [PATCH] docs(connections): Update domain model for session
 connections

---
 .../domain-model/session-connections.mdx      | 26 +++++++++++++++++++
 .../docs/concepts/domain-model/sessions.mdx   |  3 ++-
 website/data/docs-nav-data.json               |  4 +++
 3 files changed, 32 insertions(+), 1 deletion(-)
 create mode 100644 website/content/docs/concepts/domain-model/session-connections.mdx

diff --git a/website/content/docs/concepts/domain-model/session-connections.mdx b/website/content/docs/concepts/domain-model/session-connections.mdx
new file mode 100644
index 0000000000..596e068b3d
--- /dev/null
+++ b/website/content/docs/concepts/domain-model/session-connections.mdx
@@ -0,0 +1,26 @@
+---
+layout: docs
+page_title: Domain Model - Session Connections
+description: |-
+  The anatomy of a Boundary session connection
+---
+
+# Session Connections
+A session connection represents an authorized proxy between a [user][] and a [host][]. After the creation of a
+[session][], a user initiates a connection to a [target][] using the Boundary-provided
+proxy information and [credentials][] (if applicable).
+
+Users can create multiple connections to a [target][], so long as the [session][] has not expired or reached its maximum
+number of connections.
+
+Session connections terminate on user exit from the proxy, or on termination of the [session][].
+
+## Referenced By
+
+- [Session][]
+
+[credentials]: /docs/concepts/domain-model/credentials
+[host]: /docs/concepts/domain-model/hosts
+[session]: /docs/concepts/domain-model/sessions
+[target]: /docs/concepts/domain-model/targets
+[user]: /docs/concepts/domain-model/users
diff --git a/website/content/docs/concepts/domain-model/sessions.mdx b/website/content/docs/concepts/domain-model/sessions.mdx
index f66932a367..3d31974e51 100644
--- a/website/content/docs/concepts/domain-model/sessions.mdx
+++ b/website/content/docs/concepts/domain-model/sessions.mdx
@@ -8,7 +8,7 @@ description: |-
 # Sessions
 
 A session is
-a set of related connections
+a set of related [connections][]
 between a [user][] and a [host][].
 A session may include a set of [credentials][]
 which define the permissions granted to the [user][] on the [host][] for the duration
@@ -74,6 +74,7 @@ Changes to a user's permissions do not effect existing sessions.
 [accounts]: /docs/concepts/domain-model/accounts
 [authentication method]: /docs/concepts/domain-model/auth-methods
 [authentication methods]: /docs/concepts/domain-model/auth-methods
+[connections]: /docs/concepts/domain-model/session-connections
 [credential library]: /docs/concepts/domain-model/credential-libraries
 [credential libraries]: /docs/concepts/domain-model/credential-libraries
 [credential store]: /docs/concepts/domain-model/credential-stores
diff --git a/website/data/docs-nav-data.json b/website/data/docs-nav-data.json
index 349ee5e388..88803af4d1 100644
--- a/website/data/docs-nav-data.json
+++ b/website/data/docs-nav-data.json
@@ -193,6 +193,10 @@
             "title": "Sessions",
             "path": "concepts/domain-model/sessions"
           },
+          {
+            "title": "Session Connections",
+            "path": "concepts/domain-model/session-connections"
+          },
           {
             "title": "Targets",
             "path": "concepts/domain-model/targets"