Skip to content
135 changes: 135 additions & 0 deletions docs/dev/cli/sauce-connect-5/sc_run.md
Original file line number Diff line number Diff line change
Expand Up @@ -206,6 +206,7 @@
--proxy myproxy.org:3128 --proxy-sauce https://external.com:443 --auth user1:pass1@myproxy.org:3128,user2:pass2@external.com:*
```


### `--debug-address` {#debug-address}

* Environment variable: `SAUCE_DEBUG_ADDRESS`
Expand Down Expand Up @@ -283,6 +284,14 @@
Proxy for requests to Sauce Labs REST API and Sauce Connect servers only.
See the -x, --proxy flag for more details on the format.

### --proxy-sauce-enable-kerberos-auth {#proxy-sauce-enable-kerberos-auth}

Check warning on line 287 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L287

[sauce.Headings] '--proxy-sauce-enable-kerberos-auth {#proxy-sauce-enable-kerberos-auth}' should use title case capitalization.
Raw output
{"message": "[sauce.Headings] '--proxy-sauce-enable-kerberos-auth {#proxy-sauce-enable-kerberos-auth}' should use title case capitalization.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 287, "column": 5}}}, "severity": "WARNING"}

* Environment variable: `SAUCE_PROXY_SAUCE_ENABLE_KERBEROS_AUTH`
* Value Format: `<value>` (you can use empty command line switch to enable)
* Default Value: `false`

Authenticate to proxy specified in `--proxy-sauce` using Kerberos. Kerberos authentication must be enabled and configured for `sc`.

## DNS

### `--dns-round-robin` {#dns-round-robin}
Expand Down Expand Up @@ -466,6 +475,132 @@

Log level.

## Kerberos authentication

Check warning on line 478 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L478

[sauce.Headings] 'Kerberos authentication' should use title case capitalization.
Raw output
{"message": "[sauce.Headings] 'Kerberos authentication' should use title case capitalization.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 478, "column": 4}}}, "severity": "WARNING"}

### Introduction

Sauce Connect 5 supports Kerberos authentication both to the upstream proxy and tested applications.

`sc` client process connects to your Kerberos KDC server, authenticates as configured account ("principal name") and retrieves relevant Kerberos service tickets. Kerberos connection and authentication is only local to your `sc` client - Sauce Labs servers do not participate in it.

Check warning on line 484 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L484

[sauce.EOLWhitespace] Remove whitespace characters from the end of the line.
Raw output
{"message": "[sauce.EOLWhitespace] Remove whitespace characters from the end of the line.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 484, "column": 283}}}, "severity": "WARNING"}

It is also fully transparent to your tests as `sc` injects relevant HTTP headers with Kerberos authentication tokens automatically for all needed requests forwarded through the tunnel.

Supported modes:

* Kerberos authentication to the upstream proxy defined in `--proxy-sauce` - using `Proxy-Authorization` HTTP header
* Kerberos authentication to the upstream proxy defined in `--proxy` - using `Proxy-Authorization` HTTP header
* Kerberos authentication to tested web applications by injecting `Authorization` header to forwarded HTTP requests

It is possible to have combination of settings - for example when both upstream proxy and tested application require Kerberos authentication

Sauce Connect 5 generates SPNEGO tokens from relevant Kerberos tickets to pass in HTTP headers which is the most popular and standardized way of handling Kerberos HTTP authentication.

Implemented method is called "opportunistic authentication", it means `sc` does not try to detect `401` or `407` HTTP error codes and negotiate Kerberos authentication - it uses predefined host names needing Kerberos authentication and it's up to the user to know those hosts in advance. This greately improves performance and does not interfere with your tests which may require detection and custom handling of `401` and other error codes.

Current implementation uses HTTP request host (or configured proxy hostname) as SPN (Service Principal Name) used to request tickets from Kerberos KDC server. For example `app.example.com` is converted to SPN `HTTP/app.example.com` and such SPN is expected to be present in Kerberos KDC server.

To use Kerberos authentication mechanism you need to have both `krb5.conf` file which points to proper realms and Kerberos servers and keytab file accessible to `sc` client. Those are standardized format files used in most Kerberos related software suites and are not specific to Sauce Connect 5 client.

Check warning on line 502 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L502

[sauce.UnclearAntecedent] Instead of 'Those are', try starting this sentence with a specific subject and verb.
Raw output
{"message": "[sauce.UnclearAntecedent] Instead of 'Those are', try starting this sentence with a specific subject and verb.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 502, "column": 175}}}, "severity": "WARNING"}

### --kerberos-cfg-file {#kerberos-cfg-file}

Check warning on line 504 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L504

[sauce.Headings] '--kerberos-cfg-file {#kerberos-cfg-file}' should use title case capitalization.
Raw output
{"message": "[sauce.Headings] '--kerberos-cfg-file {#kerberos-cfg-file}' should use title case capitalization.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 504, "column": 5}}}, "severity": "WARNING"}

* Environment variable: `SAUCE_KERBEROS_CFG_FILE`
* Value Format: `<path>`

Path to krb5.conf configuration file with kerberos connection settings.

Check warning on line 509 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L509

[sauce.EOLWhitespace] Remove whitespace characters from the end of the line.
Raw output
{"message": "[sauce.EOLWhitespace] Remove whitespace characters from the end of the line.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 509, "column": 72}}}, "severity": "WARNING"}
File format reference:

https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html


### --kerberos-keytab-file {#kerberos-cfg-file}

Check warning on line 515 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L515

[sauce.Headings] '--kerberos-keytab-file {#kerberos-cfg-file}' should use title case capitalization.
Raw output
{"message": "[sauce.Headings] '--kerberos-keytab-file {#kerberos-cfg-file}' should use title case capitalization.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 515, "column": 5}}}, "severity": "WARNING"}

* Environment variable: `SAUCE_KERBEROS_KEYTAB_FILE`
* Value Format: `<path>`

Path to keytab file holding credentials to an account as which `sc` authenticates to a Kerberos KDC server.

Keytab files are in binary format and can be created and managed for example using `ktutil` tool distributed with MIT Kerberos software:
https://web.mit.edu/kerberos/krb5-latest/doc/admin/admin_commands/ktutil.html#ktutil-1


### --kerberos-user-name {#kerberos-user-name}

Check warning on line 526 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L526

[sauce.Headings] '--kerberos-user-name {#kerberos-user-name}' should use title case capitalization.
Raw output
{"message": "[sauce.Headings] '--kerberos-user-name {#kerberos-user-name}' should use title case capitalization.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 526, "column": 5}}}, "severity": "WARNING"}

* Environment variable: `SAUCE_KERBEROS_USER_NAME`
* Value Format: `<username>`

Name of the account username (principal name using Kerberos nomenclature) as which `sc` will authenticate to a Kerberos KDC server. User and its password (hashed) must be present in keytab file specified in `--kerberos-keytab-file`

### --kerberos-user-realm {#kerberos-user-realm}

Check warning on line 533 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L533

[sauce.Headings] '--kerberos-user-realm {#kerberos-user-realm}' should use title case capitalization.
Raw output
{"message": "[sauce.Headings] '--kerberos-user-realm {#kerberos-user-realm}' should use title case capitalization.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 533, "column": 5}}}, "severity": "WARNING"}

* Environment variable: `SAUCE_KERBEROS_USER_REALM`
* Value Format: `<domain name>`

Kerberos realm of the user specified in `--kerberos-user-name`. It depends on Kerberos settings in organisation but in most cases it's the company domain name.


### --kerberos-enabled-hosts {#kerberos-enabled-hosts}

Check warning on line 541 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L541

[sauce.Headings] '--kerberos-enabled-hosts {#kerberos-enabled-hosts}' should use title case capitalization.
Raw output
{"message": "[sauce.Headings] '--kerberos-enabled-hosts {#kerberos-enabled-hosts}' should use title case capitalization.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 541, "column": 5}}}, "severity": "WARNING"}

* Environment variable: `SAUCE_KERBEROS_ENABLED_HOSTS`
* Value Format: `host1,host2,host3....`

List of hosts for which Kerberos (SPNEGO) authorization tokens will be injected as `Authorization` header. If a forwarded HTTP request already has such header (or header is added by `sc` by means of other settings, like custom headers or credentials) - this header value will be overwritten by SPNEGO token.

Please note that this host list do not support wildcards.

Check notice on line 548 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L548

[sauce.WordsToAvoid] Avoid usage of 'Please'.
Raw output
{"message": "[sauce.WordsToAvoid] Avoid usage of 'Please'.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 548, "column": 1}}}, "severity": "INFO"}

Check notice on line 548 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L548

[sauce.WordsToAvoid] Avoid usage of 'note that'.
Raw output
{"message": "[sauce.WordsToAvoid] Avoid usage of 'note that'.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 548, "column": 8}}}, "severity": "INFO"}


### --kerberos-auth-upstream-proxy {#kerberos-auth-upstream-proxy}

Check warning on line 551 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L551

[sauce.Headings] '--kerberos-auth-upstream-proxy {#kerberos-auth-upstream-proxy}' should use title case capitalization.
Raw output
{"message": "[sauce.Headings] '--kerberos-auth-upstream-proxy {#kerberos-auth-upstream-proxy}' should use title case capitalization.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 551, "column": 5}}}, "severity": "WARNING"}

* Environment variable: `SAUCE_KERBEROS_AUTH_UPSTREAM_PROXY`
* Value Format: `<value>` (you can use empty command line switch to enable)
* Default Value: `false`

Authenticate to a configured upstream proxy with Kerberos (using `Proxy-Authorization` HTTP header). Please note that if `sc` configuration results in multiple proxies available (like PAC for example), `sc` will try to authenticate with Kerberos to each one of them.

Check notice on line 557 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L557

[sauce.WordsToAvoid] Avoid usage of 'Please'.
Raw output
{"message": "[sauce.WordsToAvoid] Avoid usage of 'Please'.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 557, "column": 102}}}, "severity": "INFO"}

Check notice on line 557 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L557

[sauce.WordsToAvoid] Avoid usage of 'note that'.
Raw output
{"message": "[sauce.WordsToAvoid] Avoid usage of 'note that'.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 557, "column": 109}}}, "severity": "INFO"}

To enable Kerberos authentication for `--proxy-sauce` specified proxy server, see: [--proxy-sauce-enable-kerberos-auth](#proxy-sauce-enable-kerberos-auth)


### --kerberos-run-diagnostics {#kerberos-run-diagnostics}

Check warning on line 562 in docs/dev/cli/sauce-connect-5/sc_run.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/dev/cli/sauce-connect-5/sc_run.md#L562

[sauce.Headings] '--kerberos-run-diagnostics {#kerberos-run-diagnostics}' should use title case capitalization.
Raw output
{"message": "[sauce.Headings] '--kerberos-run-diagnostics {#kerberos-run-diagnostics}' should use title case capitalization.", "location": {"path": "docs/dev/cli/sauce-connect-5/sc_run.md", "range": {"start": {"line": 562, "column": 5}}}, "severity": "WARNING"}

* Environment variable: `SAUCE_KERBEROS_RUN_DIAGNOSTICS`
* Value Format: `<value>` (you can use empty commant switch to enable)
* Default Value: `false`


Running `sc` with `--kerberos-run-diagnostics` switch will run basic Kerberos diagnostics and exit the process.

Diagnostics will print debugging information about Kerberos connection or known configuration errors - for example an error when there are discrepancies between supported encryption types and keytab entry:

```
msg="fatal error exiting" error="kerberos configuration potential problems: default_tkt_enctypes specifies 17 but this enctype is not available in the client's keytab\ndefault_tkt_enctypes specifies 23 but this enctype is not available in the client's keytab\npreferred_preauth_types specifies 17 but this enctype is not available in the client's keytab\npreferred_preauth_types specifies 15 but this enctype is not available in the client's keytab\npreferred_preauth_types specifies 14 but this enctype is not available in the client's keytab"
```

Diagnostics printout will allow you to match enctype number to string:

```
"DefaultTGSEnctypes": [
"aes256-cts-hmac-sha1-96",
"aes128-cts-hmac-sha1-96",
"des3-cbc-sha1",
"arcfour-hmac-md5",
"camellia256-cts-cmac",
"camellia128-cts-cmac",
"des-cbc-crc",
"des-cbc-md5",
"des-cbc-md4"
],
"DefaultTGSEnctypeIDs": [
18,
17,
23
],

```

(17 is aes128-cts-hmac-sha1-96, etc)

Often having only one enctype in user configuration will work but can break at any time if hosts decide to negotiate something different than usual. For simplification you can restrict supported encryption types to 1-2 entries in krb5.conf file. Enctypes listed in diagnostics mode are sorted from most secure to least secure so in most cases first 1-2 positions are good enough to choose from and check if KDC server supports them. When in doubt - contact your ActiveDirectory/Kerberos administrator.


## Formatting Domains

Here are some guidelines to follow when formatting domain regular expressions:
Expand Down
20 changes: 10 additions & 10 deletions docs/secure-connections/sauce-connect-5/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@

If you prefer to perform a custom installation, you can download the Sauce Connect binaries from the following links.

SHA256 checksums are available [on this page](https://saucelabs.com/downloads/sauce-connect/5.3.1/checksums).
SHA256 checksums are available [on this page](https://saucelabs.com/downloads/sauce-connect/5.4.1/checksums).

Check warning on line 20 in docs/secure-connections/sauce-connect-5/installation.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/secure-connections/sauce-connect-5/installation.md#L20

[sauce.MeaningfulLinkWords] Improve SEO and accessibility by rewriting 'this page' in the link text.
Raw output
{"message": "[sauce.MeaningfulLinkWords] Improve SEO and accessibility by rewriting 'this page' in the link text.", "location": {"path": "docs/secure-connections/sauce-connect-5/installation.md", "range": {"start": {"line": 20, "column": 36}}}, "severity": "WARNING"}

<table>
<tr>
Expand All @@ -27,51 +27,51 @@
<tr>
<td rowspan="3">Linux x86_64</td>
<td>
<a href="https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_linux.x86_64.tar.gz">https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_linux.x86_64.tar.gz</a>
<a href="https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_linux.x86_64.tar.gz">https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_linux.x86_64.tar.gz</a>

Check warning on line 30 in docs/secure-connections/sauce-connect-5/installation.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/secure-connections/sauce-connect-5/installation.md#L30

[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.
Raw output
{"message": "[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.", "location": {"path": "docs/secure-connections/sauce-connect-5/installation.md", "range": {"start": {"line": 30, "column": 24}}}, "severity": "WARNING"}
</td>
</tr>
<tr>
<td>
<a href="https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect_5.3.1.linux_amd64.deb">https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect_5.3.1.linux_amd64.deb</a>
<a href="https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect_5.4.1.linux_amd64.deb">https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect_5.4.1.linux_amd64.deb</a>

Check warning on line 35 in docs/secure-connections/sauce-connect-5/installation.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/secure-connections/sauce-connect-5/installation.md#L35

[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.
Raw output
{"message": "[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.", "location": {"path": "docs/secure-connections/sauce-connect-5/installation.md", "range": {"start": {"line": 35, "column": 24}}}, "severity": "WARNING"}
</td>
</tr>
<tr>
<td>
<a href="https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_linux.x86_64.rpm">https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_linux.x86_64.rpm</a>
<a href="https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_linux.x86_64.rpm">https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_linux.x86_64.rpm</a>

Check warning on line 40 in docs/secure-connections/sauce-connect-5/installation.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/secure-connections/sauce-connect-5/installation.md#L40

[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.
Raw output
{"message": "[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.", "location": {"path": "docs/secure-connections/sauce-connect-5/installation.md", "range": {"start": {"line": 40, "column": 24}}}, "severity": "WARNING"}
</td>
</tr>
<tr>
<td rowspan="3">Linux arm64</td>
<td>
<a href="https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_linux.aarch64.tar.gz">https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_linux.aarch64.tar.gz</a>
<a href="https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_linux.aarch64.tar.gz">https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_linux.aarch64.tar.gz</a>

Check warning on line 46 in docs/secure-connections/sauce-connect-5/installation.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/secure-connections/sauce-connect-5/installation.md#L46

[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.
Raw output
{"message": "[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.", "location": {"path": "docs/secure-connections/sauce-connect-5/installation.md", "range": {"start": {"line": 46, "column": 24}}}, "severity": "WARNING"}
</td>
</tr>
<tr>
<td>
<a href="https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect_5.3.1.linux_arm64.deb">https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect_5.3.1.linux_arm64.deb</a>
<a href="https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect_5.4.1.linux_arm64.deb">https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect_5.4.1.linux_arm64.deb</a>

Check warning on line 51 in docs/secure-connections/sauce-connect-5/installation.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/secure-connections/sauce-connect-5/installation.md#L51

[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.
Raw output
{"message": "[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.", "location": {"path": "docs/secure-connections/sauce-connect-5/installation.md", "range": {"start": {"line": 51, "column": 24}}}, "severity": "WARNING"}
</td>
</tr>
<tr>
<td>
<a href="https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_linux.aarch64.rpm">https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_linux.aarch64.rpm</a>
<a href="https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_linux.aarch64.rpm">https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_linux.aarch64.rpm</a>

Check warning on line 56 in docs/secure-connections/sauce-connect-5/installation.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/secure-connections/sauce-connect-5/installation.md#L56

[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.
Raw output
{"message": "[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.", "location": {"path": "docs/secure-connections/sauce-connect-5/installation.md", "range": {"start": {"line": 56, "column": 24}}}, "severity": "WARNING"}
</td>
</tr>
<tr>
<td>macOS</td>
<td>
<a href="https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_darwin.all.zip">https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_darwin.all.zip</a>
<a href="https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_darwin.all.zip">https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_darwin.all.zip</a>

Check warning on line 62 in docs/secure-connections/sauce-connect-5/installation.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/secure-connections/sauce-connect-5/installation.md#L62

[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.
Raw output
{"message": "[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.", "location": {"path": "docs/secure-connections/sauce-connect-5/installation.md", "range": {"start": {"line": 62, "column": 24}}}, "severity": "WARNING"}
</td>
</tr>
<tr>
<td>Windows x86_64</td>
<td>
<a href="https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_windows.x86_64.zip">https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_windows.x86_64.zip</a>
<a href="https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_windows.x86_64.zip">https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_windows.x86_64.zip</a>

Check warning on line 68 in docs/secure-connections/sauce-connect-5/installation.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/secure-connections/sauce-connect-5/installation.md#L68

[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.
Raw output
{"message": "[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.", "location": {"path": "docs/secure-connections/sauce-connect-5/installation.md", "range": {"start": {"line": 68, "column": 24}}}, "severity": "WARNING"}
</td>
</tr>
<tr>
<td>Windows arm64</td>
<td>
<a href="https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_windows.aarch64.zip">https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_windows.aarch64.zip</a>
<a href="https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_windows.aarch64.zip">https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_windows.aarch64.zip</a>

Check warning on line 74 in docs/secure-connections/sauce-connect-5/installation.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/secure-connections/sauce-connect-5/installation.md#L74

[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.
Raw output
{"message": "[sauce.WordList] Use 'Sauce Labs' instead of 'saucelabs'.", "location": {"path": "docs/secure-connections/sauce-connect-5/installation.md", "range": {"start": {"line": 74, "column": 24}}}, "severity": "WARNING"}
</td>
</tr>
</table>
12 changes: 6 additions & 6 deletions docs/secure-connections/sauce-connect-5/installation/linux.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,15 +24,15 @@ defaultValue="ARM64"
<TabItem value="ARM64">

```bash
curl -L -o sauce-connect.deb https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect_5.3.1.linux_arm64.deb
curl -L -o sauce-connect.deb https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect_5.4.1.linux_arm64.deb
sudo dpkg -i sauce-connect.deb
```
</TabItem>

<TabItem value="x86-64">

```bash
curl -L -o sauce-connect.deb https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect_5.3.1.linux_amd64.deb
curl -L -o sauce-connect.deb https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect_5.4.1.linux_amd64.deb
sudo dpkg -i sauce-connect.deb
```

Expand Down Expand Up @@ -83,14 +83,14 @@ defaultValue="ARM64"
<TabItem value="ARM64">

```bash
sudo rpm -i https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_linux.aarch64.rpm
sudo rpm -i https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_linux.aarch64.rpm
```
</TabItem>

<TabItem value="x86-64">

```bash
sudo rpm -i https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_linux.x86_64.rpm
sudo rpm -i https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_linux.x86_64.rpm
```

</TabItem>
Expand Down Expand Up @@ -136,7 +136,7 @@ defaultValue="ARM64"
<TabItem value="ARM64">

```bash
curl -L -o sauce-connect.tar.gz https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_linux.aarch64.tar.gz
curl -L -o sauce-connect.tar.gz https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_linux.aarch64.tar.gz
sudo mkdir -p /opt/sauce-connect
sudo tar -C /opt/sauce-connect -xzf sauce-connect.tar.gz
```
Expand All @@ -145,7 +145,7 @@ sudo tar -C /opt/sauce-connect -xzf sauce-connect.tar.gz
<TabItem value="x86-64">

```bash
curl -L -o sauce-connect.tar.gz https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_linux.x86_64.tar.gz
curl -L -o sauce-connect.tar.gz https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_linux.x86_64.tar.gz
sudo mkdir -p /opt/sauce-connect
sudo tar -C /opt/sauce-connect -xzf sauce-connect.tar.gz
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ Sauce Connect provides `.zip` package with a signed binary that can be used on a
### Unpack the zip file

```bash
curl -L -o sauce-connect.zip https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_darwin.all.zip
curl -L -o sauce-connect.zip https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_darwin.all.zip
sudo mkdir -p /opt/sauce-connect
sudo unzip -d /opt/sauce-connect sauce-connect.zip
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,7 @@ Sauce Connect provides `.zip` package that can be used on older Windows versions

```powershell
mkdir C:\sauce-connect
Invoke-WebRequest -Uri https://saucelabs.com/downloads/sauce-connect/5.3.1/sauce-connect-5.3.1_windows.x86_64.zip -OutFile sauce-connect.zip
Invoke-WebRequest -Uri https://saucelabs.com/downloads/sauce-connect/5.4.1/sauce-connect-5.4.1_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\sauce-connect.exe
```
Expand Down