Merge branch 'main' into fix-local-setup

Author: bahrimootaz

docs/basics/acct-team-mgmt/managing-service-accounts.md

@@ -141,4 +141,4 @@ Jobs run by service accounts are displayed on the [Automated Test Results page](
 
 ### Using Sauce Connect Proxy with a Service Account
 
-If you plan to run tests through a [Sauce Connect Proxy tunnel](/secure-connections/), be mindful of tunnel sharing options. Service accounts cannot create or manage tunnels, so you must use a tunnel that has been shared with the service account’s assigned team. For detailed configuration instructions, refer to the [shared tunnels section](/secure-connections/sauce-connect-5/guides/overview/#shared-tunnels).
+If you plan to run tests through a [Sauce Connect Proxy tunnel](/secure-connections/), be mindful of tunnel sharing options. Service accounts cannot create or manage tunnels, so you must use a tunnel that has been shared with the service account’s assigned team. For detailed configuration instructions, refer to the [sharing tunnel guide](/secure-connections/sauce-connect-5/guides/sharing-tunnel/).

docs/basics/acct-team-mgmt/sauce-connect-proxy-tunnels.md

@@ -66,7 +66,7 @@ This flag is, primarily, used by Sauce Labs to assign custom properties to the t
 
 Share the tunnel within the same org unit.
 Only the 'all' option is currently supported.
-See [here](/basics/acct-team-mgmt/sauce-connect-proxy-tunnels/).
+See [here](/secure-connections/sauce-connect-5/guides/sharing-tunnel/).
 
 ### `-t, --tunnel-pool` {#tunnel-pool}
 

docs/dev/cli/sauce-connect-5/sc_run.md

@@ -97,7 +97,7 @@ You can view the entire list of CLI options by running the `--help` flag.
 
 <p><small>| OPTIONAL | <span className="sauceGreen">4.8.x</span> <span className="sauceGreen">4.9.x</span> | </small></p>
 
-**Description**: Changes tunnel sharing permissions so that all users in an organization can use Sauce Connect Proxy tunnels, rather than just the tunnel owner (admin). For more information, see [Sharing Sauce Connect Proxy Tunnels](/basics/acct-team-mgmt/sauce-connect-proxy-tunnels).<br/>
+**Description**: Changes tunnel sharing permissions so that all users in an organization can use Sauce Connect Proxy tunnels, rather than just the tunnel owner (admin). For more information, see [Sharing Sauce Connect Proxy Tunnels](/secure-connections/sauce-connect-5/guides/sharing-tunnel/).<br/>
 **Environment variable**: `SAUCE_SHARED_TUNNEL`<br/>
 **Shorthand**: `-s`
 

docs/dev/cli/sauce-connect-proxy.md

@@ -15,21 +15,15 @@ To determine which solution is best for you, see [Overview of Sauce Labs Securit
 See our [Sauce Connect Proxy Security Overview](https://saucelabs.com/resources/white-papers/sauce-connect-proxy-security-overview) white paper for information about optimizing your network and development environment for Sauce Connect Proxy performance.
 
 <div className="box-wrapper" markdown="1">
-<div className="box box1 card">
-  <div className="container">
-  <h3><a href="/secure-connections/sauce-connect-5">Sauce Connect Proxy Overview</a></h3>
-  <p>Learn about Sauce Connect Proxy and why we recommend it over allowlisting individual IP addresses.</p>
-  </div>
-</div>
-<div className="box box2 card">
-  <div className="container">
-  <h3><a href="/secure-connections/sauce-connect-5/quickstart/">Quickstart</a></h3>
-  <p>Get up and running with Sauce Connect Proxy in minutes.</p>
-  </div>
-</div>
+    <div className="box box1 card">
+      <div className="container">
+      <h3><a href="/secure-connections/sauce-connect-5">Sauce Connect Proxy Overview</a></h3>
+      <p>Learn about Sauce Connect Proxy and why we recommend it over allowlisting individual IP addresses.</p>
+      </div>
+    </div>
     <div className="box box3 card">
       <div className="container">
-      <h3><a href="/secure-connections/sauce-connect-5/guides/overview">Setup and Configuration</a></h3>
+      <h3><a href="/secure-connections/sauce-connect-5/quickstart/">Quickstart</a></h3>
       <p>Learn how to launch a basic Sauce Connect Proxy tunnel configuration. Once you’re connected, use our code samples to run your first test.</p>
       </div>
     </div>

docs/secure-connections.md

@@ -302,7 +302,7 @@ To launch a tunnel using a **config.yml** file option.
   <TabItem value="Windows">
 
 ```bash
-sc.exe run -c %HOMEPATH%\sc\config.yml
+sauce-connect.exe run -c %HOMEPATH%\sc\config.yml
 ```
 
   </TabItem>
@@ -379,7 +379,7 @@ You can persist Sauce Connect Proxy environment variables by adding them to one
 6. Confirm that your environment variables have been set by typing `echo %SAUCE_USERNAME%` in your terminal. The response should be your username value. Then do the same for your access key.
 7. Starting a new Sauce Connect Proxy will not require adding required flags.
    ```bash
-   sc.exe
+   sauce-connect.exe
    ```
 
 </TabItem>

docs/secure-connections/sauce-connect-5/guides/configuration.md

@@ -18,7 +18,7 @@ Logs are automatically rotated when running Sauce Connect Proxy 5 as a Linux Sys
 For other setups, use the `logrotate` utility.
 
 :::note
-The logrotate integration in Linux and macOS is available in **Sauce Connect Proxy 5.1.2** and later.
+The logrotate integration in Linux and macOS is available since **Sauce Connect Proxy 5.1.2**.
 :::
 
 ### Linux

docs/secure-connections/sauce-connect-5/guides/logging.md

@@ -0,0 +1,30 @@
+---
+id: sharing-tunnel
+title: Sauce Connect Proxy Sharing Tunnel
+sidebar_label: Sharing Tunnel
+---
+
+import useBaseUrl from '@docusaurus/useBaseUrl';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+Sauce Connect Proxy supports tunnel sharing within an organization, enabling multiple users or service accounts to access the same tunnel.
+
+To enable sharing, start Sauce Connect Proxy with the [`--shared all`](/dev/cli/sauce-connect-5/run/#shared) flag.
+
+### Access Based on User Roles
+
+The ability to use a Sauce Connect Proxy tunnel depends on the role of the user who starts the tunnel.
+
+| **Role**           | **Can Share Tunnels With**       | **Can Use Tunnels Created By**                | **Can Stop Tunnels Created By**   |
+|--------------------|----------------------------------|-----------------------------------------------|-----------------------------------|
+| Organization Admin | Any user                         | Any user                                      | Any user                          |
+| Team Admin         | All members of their team        | Organization admins, team members, themselves | Themselves and other team members |
+| Team Member        | All members of their team        | Organization admins, team members, themselves | Only themselves                   |
+| Service Account    | ❌ Cannot create or share tunnels | Organization admins, team members             | ❌ Cannot stop any tunnels         |
+
+For details about user roles and permissions, see [User Roles](/basics/acct-team-mgmt/managing-user-info/#user-roles).
+
+### Using a Shared Tunnel
+
+To use a shared tunnel in your test, set the [`tunnelOwner`](/dev/test-configuration-options/#tunnelowner) capability in your test configuration to the **username** of the tunnel owner.

docs/secure-connections/sauce-connect-5/guides/overview.md

@@ -68,7 +68,7 @@ sc run --username $SAUCE_USERNAME --access-key $SAUCE_ACCESS_KEY \
 <TabItem value="windows">
 
 ```bash
-sc.exe run --username %SAUCE_USERNAME% --access-key %SAUCE_ACCESS_KEY% ^
+sauce-connect.exe run --username %SAUCE_USERNAME% --access-key %SAUCE_ACCESS_KEY% ^
   --tunnel-name tunnel_name_here ^
   --tunnel-pool
 ```

docs/secure-connections/sauce-connect-5/guides/sharing-tunnel.md

@@ -84,7 +84,7 @@ Sauce Connect provides `.zip` package that can be used on older Windows versions
 mkdir C:\sauce-connect
 Invoke-WebRequest -Uri https://saucelabs.com/downloads/sauce-connect/5.2.3/sauce-connect-5.2.3_windows.x86_64.zip -OutFile sauce-connect.zip
 Expand-Archive -Path sauce-connect.zip -DestinationPath C:\sauce-connect
-Rename-Item -Path C:\sauce-connect\sauce-connect.exe -NewName C:\sauce-connect\sc.exe
+Rename-Item -Path C:\sauce-connect\sauce-connect.exe -NewName C:\sauce-connect\sauce-connect.exe
 ```
 
 ### Edit Config File
@@ -96,7 +96,7 @@ Get the default configuration file:
 
 ```powershell
 cd C:\sauce-connect
-./sc.exe run config-file > sauce-connect.yaml
+./sauce-connect.exe run config-file > sauce-connect.yaml
 ```
 
 Edit the configuration file with your favorite editor:
@@ -108,5 +108,5 @@ notepad sauce-connect.yaml
 ### Start Sauce Connect
 
 ```powershell
-./sc.exe run --config-file sauce-connect.yaml
+./sauce-connect.exe run --config-file sauce-connect.yaml
 ```