@@ -301,23 +301,29 @@ up-to-date. See [MSSQL Database](./database/mssql/index.md) for more information
301301## Install licensing certificate
302302
303303To 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