SC-5304: merge SC5 overview into quickstart

Author: budziam

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 [shared tunnels section](/secure-connections/sauce-connect-5/quickstart/#shared-tunnels).

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

@@ -6,7 +6,7 @@ sidebar_label: Sharing Sauce Connect Proxy Tunnels
 
 You can share Sauce Connect Proxy tunnels based on the hierarchical structure of your [user roles](/basics/acct-team-mgmt/managing-user-info/#user-roles). You can also verify which tunnels are available on the **Tunnels** page in Sauce Labs.
 
-For instructions on running a job using a shared tunnel, refer to the [shared tunnels guide](/secure-connections/sauce-connect-5/guides/overview/#shared-tunnels).
+For instructions on running a job using a shared tunnel, refer to the [shared tunnels guide](/secure-connections/sauce-connect-5/quickstart/#shared-tunnels).
 
 | Role Creating Tunnel | Sharing Options (live testing or test automation)                                         | Use Tunnels (live testing or test automation)              | Stop options (from tunnels page)                  |
 | -------------------- | ----------------------------------------------------------------------------------------- | ---------------------------------------------------------- | ------------------------------------------------- |

docs/secure-connections.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/sauce-connect-5/guides/logging.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/overview.md

@@ -15,30 +15,71 @@ The Sauce Connect Proxy version 5 major release introduces CLI changes. Please r
 An [`sc legacy`](/dev/cli/sauce-connect-5/legacy/) command is introduced to help users transition from version 4.x.x to 5.0.x.
 :::
 
+:::note
+[Service accounts](/basics/acct-team-mgmt/managing-service-accounts) are not supported by Sauce Connect Proxy and cannot start or manage tunnels. Only user accounts can manage tunnels.
+:::
+
 ## What You'll Need
 
 - A Sauce Labs account ([Log in](https://accounts.saucelabs.com/am/XUI/#login/) or sign up for a [free trial license](https://saucelabs.com/sign-up)).
 - If you haven't already, make sure you can access the website or mobile app that you'll be testing from the Sauce Connect Proxy host.
 - Check to see if you have any [proxies](/secure-connections/sauce-connect-5/guides/proxies/) that are required to access the public Internet.
 
-## Installing Sauce Connect Proxy
+## Installation and Configuration
+
+- See the [installation instructions](/secure-connections/sauce-connect-5/installation/)
+- See the [configuration guide](/secure-connections/sauce-connect-5/guides/configuration/)
+
+### Run Sauce Connect Proxy
+
+Every Sauce Connect Proxy tunnel spins up a fresh virtual machine (VM) that is used only for your tests. Once the tunnel is closed, VMs are destroyed.
+
+1. Make sure that the directory containing the `sc` binary (or `sc.exe`, for Windows) is in the `$PATH`. Otherwise, you will have to specify the path to the binary in the command line, i.e. `/path/to/sc`
+2. Define environment variables containing sensitive data: your user name, access key, proxy authentication (if needed), etc.
+
+```bash
+SAUCE_USERNAME=<username>
+SAUCE_ACCESS_KEY=<your access key>
+```
+
+3. Start Sauce Connect Proxy
+
+<Tabs
+  defaultValue="Mac/Linux"
+  values={[
+    {label: 'Mac/Linux', value: 'Mac/Linux'},
+    {label: 'Windows', value: 'Windows'},
+  ]}>
+
+  <TabItem value="Mac/Linux">
+
+```bash
+sc run --tunnel-name $SAUCE_TUNNEL_NAME --region <us-west|us-east|eu-central>
+```
+
+Or without environment variables:
+
+```bash
+sc run --username <your user> --access-key <your access key> --region <us-west|us-east|eu-central> --tunnel-name $SAUCE_TUNNEL_NAME
+```
+
+  </TabItem>
+  <TabItem value="Windows">
 
-See the [installation instructions](/secure-connections/sauce-connect-5/installation/)
+```bash
+sc.exe run --tunnel-name $SAUCE_TUNNEL_NAME --region <us-west|us-east|eu-central>
+```
 
-## Starting Sauce Connect Proxy
+Or without environment variables:
 
-1. Make sure that the directory containing the `sc` binary (`sc.exe` for Windows) is in the `$PATH`. Otherwise, you will have to specify the path to the binary in the command line, `/path/to/sc`
-2. Log in to Sauce Labs.
-3. Go to the [**Tunnel Proxies**](https://app.saucelabs.com/tunnels) page.<br/><img src={useBaseUrl('img/sauce-connect/tunnelsPage.png')} alt="Sauce Connect Proxy Tunnels page" width="400"/>
-4. Under step 2, **Authenticate & connect**, copy the code snippet.<br/><img src={useBaseUrl('img/sauce-connect/configureAuth.png')} alt="Sauce Connect Proxy Tunnels page snippet" width="300"/>
-   <details>
-   <summary>What is this?</summary>
-   This snippet contains your authentication credentials (username and access key), selects a Sauce Labs Data Center, and applies a name to your tunnel. Optionally, you can rename your tunnel by replacing the value after the <code>--tunnel-name</code> flag.
-   </details>
-5. Paste the snippet into your terminal and run it. This will launch the tunnel.
-6. Follow the steps in the [setup instructions](/secure-connections/sauce-connect-5/guides/overview/#running-sauce-connect-proxy) to start Sauce Connect Proxy 5 using the username and the access key obtained in the previous step.
+```bash
+sc.exe run --username <your user> --access-key <your access key> --region <us-west|us-east|eu-central> --tunnel-name $SAUCE_TUNNEL_NAME
+```
 
-## Verify Connection
+  </TabItem>
+  </Tabs>
+
+### Verify Connection
 
 To confirm your tunnel is up, look for the confirmation message in your terminal:
 
@@ -48,7 +89,7 @@ Sauce Connect is up, you may start your tests
 
 Alternatively, you can check your list of active tunnels on the **Tunnel Proxies** page:<br/><img src={useBaseUrl('img/sauce-connect/tunnelsuccess-ui.png')} alt="Sauce Connect Tunnel Success" width="500"/>
 
-## Run Test
+### Run Test
 
 With your tunnel up and running, try doing a Live <!--or Automated--> local test.
 
@@ -92,7 +133,7 @@ With your tunnel up and running, try doing a Live <!--or Automated--> local test
 </TabItem>
 </Tabs>
 
-## Stop Tunnel
+### Stop Tunnel
 
 When you've finished testing, you can stop your tunnel from the terminal where Sauce Connect is running by entering Ctrl+C.
 If there are jobs that use Sauce Connect Proxy connection, it will wait for them to finish.
@@ -108,6 +149,49 @@ If there are jobs that use Sauce Connect Proxy connection, it will wait for them
 
 Alternatively, you can go to the **Tunnel Proxies** page and click one of the **Stop Tunnels** buttons.<br/><img src={useBaseUrl('img/sauce-connect/tunnelstop-ui.png')} alt="Sauce Connect Tunnel Stop" width="800"/>
 
+## Administration
+
+We recommend using a single Sauce Connect Proxy tunnel or tunnel pool for each test suite or build, and tearing it down at the end of your test. Your test automation framework should launch Sauce Connect Proxy before the test suite is triggered and shut it down when the suite finishes.
+
+### Security Considerations
+
+We recommend using a [config file](/secure-connections/sauce-connect-5/guides/configuration/#config-file)
+or [setting environment variables](/secure-connections/sauce-connect-5/guides/configuration/#environment-variables)
+to hide sensitive information like your password ([--access-key](/dev/cli/sauce-connect-5/run/#access-key))
+and proxy credentials. This way, they won't be visible in the list of running
+processes.
+
+[Sauce Connect Proxy white paper](https://saucelabs.com/resources/white-papers/sauce-connect-proxy-security-overview) contains an in-depth overview of the proxy and its security.
+
+### Shared Tunnels
+
+Sauce Connect Proxy tunnel can be shared between multiple accounts in the same
+organization. To share a tunnel, start Sauce Connect Proxy with the [`--shared all`](/dev/cli/sauce-connect-5/run/#shared)
+flag. For most Sauce Labs customers, your access to shared tunnels is determined
+by the permissions of the user who creates them. Organization admins can create
+tunnels that any user on any team can use. Team admins can create tunnels that
+any member of their team can use. Team members cannot share tunnels they create
+with any other team member.
+
+For more information about user roles and permissions, see [User Roles](/basics/acct-team-mgmt/managing-user-info).
+
+In order to use a tunnel that an admin or team member shares with you, you'll
+need to add [`tunnelOwner`](/dev/test-configuration-options/#tunnelowner)
+to your test capabilities and specify that person's username.
+
+### Monitoring Tunnels
+
+See the [monitoring overview](/secure-connections/sauce-connect-5/guides/monitoring)
+
+### Service Management Tools
+
+Running Sauce Connect Proxy as a service is recommended when your tests often require an active secure connection and, operationally, it's complicated to set up a tunnel just before each test suite.
+The following options are available:
+
+- [Running Sauce Connect Proxy in Kubernetes](/secure-connections/sauce-connect-5/installation/kubernetes).
+- [Running a containerized Sauce Connect Proxy](/secure-connections/sauce-connect/setup-configuration/docker/#running-the-sauce-connect-proxy-container-indefinitely-in-kubernetes).
+- Running a [systemd service](/secure-connections/sauce-connect-5/installation/linux/).
+
 ## More Information
 
 - [Sauce Connect Proxy Overview](/secure-connections/sauce-connect-5/)