From 16d8d9e8f86ce8e852e3dbe1476a91d5720057de Mon Sep 17 00:00:00 2001
From: Simon Entholzer <simon.entholzer@tum.de>
Date: Fri, 21 Jun 2024 09:49:56 +0200
Subject: [PATCH 1/3] updated documentation for localVC ssh access

---
 docs/admin/setup/security.rst                | 12 +++++++++---
 docs/dev/setup/integrated-code-lifecycle.rst |  4 +---
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/docs/admin/setup/security.rst b/docs/admin/setup/security.rst
index b3bc860b2358..9f56bc899952 100644
--- a/docs/admin/setup/security.rst
+++ b/docs/admin/setup/security.rst
@@ -58,10 +58,15 @@ variables (`Spring relaxed binding <https://github.com/spring-projects/spring-bo
     possible for the system account that runs Artemis and administrators.
 
 
+.. _configure-ssh-access:
+
 SSH Access
 ----------
 
-Follow the following steps to create and manage SSH key pairs,
+To allow users to clone their programming exercises via SSH in the integrated code lifecycle setup, SSH must be
+configured correctly on the server.
+
+Follow the next steps to create and manage SSH key pairs,
 distribute them across multiple nodes via Ansible, configure the
 system to use these keys, and adapt Nginx to enable SSH routing.
 
@@ -74,11 +79,12 @@ using the ssh-keygen command. Here's how you can do it:
 .. code-block:: bash
 
     # Generate RSA key pair
-    ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa
+    ssh-keygen -t rsa -b 4096 -f ~/id_rsa
 
     # Generate Ed25519 key pair
-    ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519
+    ssh-keygen -t ed25519 -f ~/id_ed25519
 
+Make sure the keys have the standard name for the according key type. E.g. id_rsa for RSA.
 
 Adding Key Pairs to VM via Ansible
 """"""""""""""""""""""""""""""""""
diff --git a/docs/dev/setup/integrated-code-lifecycle.rst b/docs/dev/setup/integrated-code-lifecycle.rst
index 16870ab98f4b..78f6ca6c3cdc 100644
--- a/docs/dev/setup/integrated-code-lifecycle.rst
+++ b/docs/dev/setup/integrated-code-lifecycle.rst
@@ -121,9 +121,7 @@ To create a course with registered users, you can use the scripts from ``support
     </iframe>
 
 - Make sure that the result of your submission is displayed in the Artemis UI.
-
-.. HINT::
-   At the moment, the Local VC system only supports accessing repositories via HTTP(S) and Basic Auth. We plan to add SSH support in the future. For now, you need to enter your Artemis credentials (username and password) when accessing template, solution, test, and assignment repositories.
+- Users can access their repositories via HTTPS and SSH. For SSH to work, you must first :ref:`configure SSH <configure-ssh-access>`.
 
 For unauthorized access, your Git client will display the respective error message:
 

From fce6fbdc03434ff713bb962c25bccfab4990de87 Mon Sep 17 00:00:00 2001
From: Simon Entholzer <33342534+SimonEntholzer@users.noreply.github.com>
Date: Sat, 22 Jun 2024 16:57:20 +0200
Subject: [PATCH 2/3] Update docs/admin/setup/security.rst

Co-authored-by: Benedikt Fein <fein@fim.uni-passau.de>
---
 docs/admin/setup/security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/admin/setup/security.rst b/docs/admin/setup/security.rst
index 9f56bc899952..5b5d8eb4e246 100644
--- a/docs/admin/setup/security.rst
+++ b/docs/admin/setup/security.rst
@@ -79,7 +79,7 @@ using the ssh-keygen command. Here's how you can do it:
 .. code-block:: bash
 
     # Generate RSA key pair
-    ssh-keygen -t rsa -b 4096 -f ~/id_rsa
+    ssh-keygen -t rsa -b 4096 -f ~/artemis_ssh/id_rsa
 
     # Generate Ed25519 key pair
     ssh-keygen -t ed25519 -f ~/id_ed25519

From f4459f9f14b739dade2ad074d03ff2eb15c6ff4e Mon Sep 17 00:00:00 2001
From: Simon Entholzer <33342534+SimonEntholzer@users.noreply.github.com>
Date: Sat, 22 Jun 2024 16:57:29 +0200
Subject: [PATCH 3/3] Update docs/admin/setup/security.rst

Co-authored-by: Benedikt Fein <fein@fim.uni-passau.de>
---
 docs/admin/setup/security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/admin/setup/security.rst b/docs/admin/setup/security.rst
index 5b5d8eb4e246..4a7ef89c2aad 100644
--- a/docs/admin/setup/security.rst
+++ b/docs/admin/setup/security.rst
@@ -82,7 +82,7 @@ using the ssh-keygen command. Here's how you can do it:
     ssh-keygen -t rsa -b 4096 -f ~/artemis_ssh/id_rsa
 
     # Generate Ed25519 key pair
-    ssh-keygen -t ed25519 -f ~/id_ed25519
+    ssh-keygen -t ed25519 -f ~/artemis_ssh/id_ed25519
 
 Make sure the keys have the standard name for the according key type. E.g. id_rsa for RSA.