docs(debugging): trust self-signed SSL cert on end-user machines (KOB-51426)#497
Open
tungmhoang wants to merge 2 commits into
Open
docs(debugging): trust self-signed SSL cert on end-user machines (KOB-51426)#497tungmhoang wants to merge 2 commits into
tungmhoang wants to merge 2 commits into
Conversation
… (KOB-51426) Migrate the end-user portion of the Confluence "Deploy SSL cert to end-user machines" section into the public docs. - Add a Linux tab (Debian-based and Arch/Fedora trust steps). - Add a note to restart Chrome, Kobiton CLI, virtualUSB, or any AI coding assistant connected through the Kobiton MCP server after import. - Broaden the page intro and section note from virtualUSB-only to Portal Web, virtualUSB, Kobiton CLI, and Kobiton MCP server. - Align the macOS step to trust the root CA certificate, matching the Windows/Linux tabs and the source.
tungmhoang
marked this pull request as draft
June 22, 2026 04:04
…use it for MCP server
| After creating the file, continue with either OAuth or API key authentication. | ||
| After creating the file, continue with either <<oauth-authentication,OAuth>> or <<api-key-authentication,API key authentication>> . For Standalone customer with self-signed SSL certificate, trust the certificate before authenticating. | ||
|
|
||
| == Trust self-signed SSL certificate (Standalone/On-Prem only) |
Contributor
There was a problem hiding this comment.
Don't use slash terms as per Microsoft style. "On-Prem" is an internal-sounding term. Users will know this type as "Standalone". You could say something like "Standalone (on premises deployment)" if you think clarification is needed, but only once near the beginning.
| Replace `\https://api-custom-domain.kobiton.com/mcp` with the actual URL of your Kobiton MCP server. | ||
|
|
||
| After creating the file, continue with either OAuth or API key authentication. | ||
| After creating the file, continue with either <<oauth-authentication,OAuth>> or <<api-key-authentication,API key authentication>> . For Standalone customer with self-signed SSL certificate, trust the certificate before authenticating. |
Contributor
There was a problem hiding this comment.
The brackets are unnecessary. Restore to plain text "OAuth or API key authentication".
| == Install local plugin | ||
|
|
||
| Run the commands in the table below in a command-line tool on your machine according to the AI platform. Replace `/path/to/automate` with the actual path to the `automate` or `automate-main` folder. | ||
| Run the commands in the table below in a command-line tool on your machine according to the AI Agent tool. Replace `/path/to/automate` with the actual path to the `automate` or `automate-main` folder. |
Contributor
There was a problem hiding this comment.
Don't use "machine" to refer to a computer as per Microsoft style.
I find this line confusing.
| :tabs-sync-option: | ||
|
|
||
| Learn how to configure your personal computer for Standalone Portal with SSL, so you can debug local or private devices using virtualUSB. | ||
| Configure your personal computer to trust a Standalone/On-Prem Portal that uses a self-signed SSL certificate. Trusting the certificate is required to access the Portal Web and to use virtualUSB. |
Contributor
There was a problem hiding this comment.
Why is this a "personal" computer? Shouldn't it be their org's computer?
tiffany-kobiton
requested changes
Jun 22, 2026
tiffany-kobiton
left a comment
tiffany-kobiton
left a comment
Contributor
There was a problem hiding this comment.
Feedback in comments.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Issues
Changes
update-ca-certificates) and Arch/Fedora (update-ca-trust) trust steps.root.crt/ca.crt), matching the Windows/Linux tabs and the source.