Skip to content

Commit b096441

Browse files
committed
Cleanups
1 parent 2d18e8d commit b096441

File tree

1 file changed

+14
-7
lines changed

1 file changed

+14
-7
lines changed

tutorials/browser-certificate-setup-guide.mdx

Lines changed: 14 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,9 @@ description: This tutorial describes how to set up web browsers to access resour
99

1010
Certificate-based authentication in web browsers
1111
offers excellent security characteristics, thanks to mutual TLS.
12-
1312
However, the user experience has traditionally been poor,
14-
with mysterious certificate errors,
15-
confusing certificate authentication dialogs,
13+
with mysterious TLS errors,
14+
confusing certificate selection dialogs,
1615
and differing behaviors between browsers.
1716

1817
Smallstep addresses these issues
@@ -23,10 +22,16 @@ so the user can have a seamless experience.
2322

2423
Smallstep browser certificates are available for macOS, Windows, and Linux devices.
2524

25+
## Before you begin
26+
2627
Before you begin, make sure:
2728

28-
1. Your devices are [added to Smallstep](https://smallstep.com/docs/platform/enrollment-guide/).
29-
2. Someone from [our support team](https://support.smallstep.com/kb-tickets/new) has helped you get set up. Your Smallstep team is configured properly for the resource that you are using client certificates to protect.
29+
1. Your devices are [enrolled into your Smallstep inventory](https://smallstep.com/docs/platform/enrollment-guide/).
30+
2. Someone from [our support team](https://support.smallstep.com/kb-tickets/new) has helped you get set up. Client certificates can be used in several ways. Confirm that your Smallstep team is configured for the resource that you are using client certificates to protect.
31+
32+
You will need a list of URLs that will require a client certificate on your devices.
33+
34+
These URLs will vary by use case.
3035

3136
## macOS
3237

@@ -167,8 +172,8 @@ For Chrome and Edge, we can use the [`AutoSelectCertificateForUrls`](https://chr
167172
5. Restart the browser.
168173
6. Confirm the policy change.
169174

170-
- In Chrome, check <a href="chrome://policy">chrome://policy</a>.
171-
- In Edge, check <a href="edge://policy">edge://policy</a>.
175+
- In Chrome, check <a href="chrome://policy">chrome://policy</a>.
176+
- In Edge, check <a href="edge://policy">edge://policy</a>.
172177

173178
To test the certificate, restart the browser and visit one your target URLs.
174179
You should not see any certificate selection dialogs.
@@ -208,6 +213,8 @@ Don't see it? Check that the Smallstep agent is installed correctly.
208213
To test the certificate, restart the browser and visit one your target URLs.
209214
You should not see any certificate selection dialogs.
210215

216+
### Firefox
217+
211218
#### Client certificate auto-selection
212219

213220
Use the <a href="about:certificate">about:certificate</a> URL to see all of the client certificates installed in Firefox's certificate database.

0 commit comments

Comments
 (0)