Skip to content

Commit 9bf103d

Browse files
quextentheMickster
andauthored
Update guidance on licensing cert (#803)
* Update guidance on licensing cert * Further cleanup * Fix warning * Apply feedback * Update docs/getting-started/server/guide.md Co-authored-by: Mick Letofsky <mletofsky@bitwarden.com> --------- Co-authored-by: Mick Letofsky <mletofsky@bitwarden.com>
1 parent 7ee4b2b commit 9bf103d

1 file changed

Lines changed: 19 additions & 13 deletions

File tree

docs/getting-started/server/guide.md

Lines changed: 19 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -301,23 +301,29 @@ up-to-date. See [MSSQL Database](./database/mssql/index.md) for more information
301301
## Install licensing certificate
302302
303303
To run your local server environment as a licensed instance, you will need to download the
304-
`Licensing Certificate - Dev` from the shared Engineering collection and install it. This can be
305-
done by double-clicking on the downloaded certificate.
304+
`Licensing Certificate - Dev` from the shared Engineering collection.
306305
307-
:::note
306+
1. Log in to your company-issued Bitwarden account
307+
2. On the "Vaults" page, scroll down to the "Licensing Certificate - Dev" item
308+
3. View attachments and only download `dev.pfx`
309+
4. Create a `~/.secrets/` folder and place `dev.pfx` inside
310+
5. Add the following under `globalSettings` in `secrets.json`, substituting your own path to
311+
`dev.pfx` and the password from the "Licensing Certificate - Dev" vault item:
312+
313+
```json
314+
"licenseCertificatePath": "/Users/<your name>/.secrets/dev.pfx",
315+
"licenseCertificatePassword": "<password from the vault item>"
316+
```
308317
309-
Mac users: When prompted to save the downloaded certificate and PFX file in Keychain Access be sure
310-
to select "Default Keychain > login" from the dropdown otherwise they will not be found when
311-
attempting to "Build and Run the Server".
318+
6. Re-run `setup_secrets.ps1` to apply the new values to every server project — see
319+
[Configure user secrets](#configure-user-secrets).
312320
313-
:::
321+
:::warning
314322
315-
1. Log in to your company-issued Bitwarden account
316-
2. On the "Vaults" page, scroll down to the "Licensing Certificate - Dev" item
317-
3. View attachments and download both files
318-
4. Go to Keychain Access and set the dev.cer certificate to "Always Trust"
319-
5. The dev.pfx file will ask for a password. You can get this by clicking and opening the Licensing
320-
Certificate - Dev item in the vault
323+
Do not import the "Licensing Certificate - Dev" into your keychain. Doing so may compromise all TLS
324+
traffic on your development machine.
325+
326+
:::
321327
322328
</Bitwarden>
323329

0 commit comments

Comments
 (0)