other/BitBetter
1
0
Fork 0
mirror of https://github.com/jakeswenson/BitBetter.git synced 2025-07-13 06:53:25 +00:00
Code Issues Projects Releases Wiki Activity

Fixed Broken section Links

Browse Source
This commit is contained in:
Jeff Alyanak 2019-05-17 14:27:11 -04:00
parent 1182108026
commit 481193a1d6
No known key found for this signature in database
GPG Key ID: DD0CB89C105B276F
1 changed files with 13 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
README.md
View File

@ -7,24 +7,24 @@ _Beware! BitBetter does janky IL magic to rewrite the bitwarden core dll and ins
Credit to https://github.com/h44z/BitBetter and https://github.com/jakeswenson/BitBetter Credit to https://github.com/h44z/BitBetter and https://github.com/jakeswenson/BitBetter
# Table of Contents # Table of Contents
1. [Getting Started](#gettingstarted) 1. [Getting Started](#getting-started)
+ [Pre-requisites](#prereq) + [Pre-requisites](#pre-requisites)
+ [Setting up BitBetter](#setup) + [Setting up BitBetter](#setting-up-bitbetter)
+ [Building BitBetter](#building) + [Building BitBetter](#building-bitbetter)
+ [Generating Signed Licenses](#generating) + [Generating Signed Licenses](#generating-signed-licenses)
2. [FAQ](#faq) 2. [FAQ](#faq-questions-you-might-have-)
3. [Footnotes](#footnotes) 3. [Footnotes](#footnotes)
# Getting Started <a name=#gettingstarted></a> # Getting Started
The following instructions are for unix-based systems (Linux, BSD, macOS), it is possible to use a Windows systems assuming you are able to enable and install [WSL](https://docs.microsoft.com/en-us/windows/wsl/install-win10). The following instructions are for unix-based systems (Linux, BSD, macOS), it is possible to use a Windows systems assuming you are able to enable and install [WSL](https://docs.microsoft.com/en-us/windows/wsl/install-win10).
## Pre-requisites <a name=#prereq></a> ## Pre-requisites
Aside from docker, which you also need for Bitwarden, BitBetter requires the following: Aside from docker, which you also need for Bitwarden, BitBetter requires the following:
* openssl (probably already installed on most Linux or WSL systems) * openssl (probably already installed on most Linux or WSL systems)
* dotnet-sdk-2.1 (install instructions can be found [here](https://dotnet.microsoft.com/download/linux-package-manager/rhel/sdk-2.1.604)) * dotnet-sdk-2.1 (install instructions can be found [here](https://dotnet.microsoft.com/download/linux-package-manager/rhel/sdk-2.1.604))
## Setting up BitBetter <a name=#setup></a> ## Setting up BitBetter
With your pre-requisites installed, begin the installation of BitBetter by downloading it through Github or using the git command: With your pre-requisites installed, begin the installation of BitBetter by downloading it through Github or using the git command:
```bash ```bash
@ -51,7 +51,7 @@ openssl pkcs12 -export -out cert.pfx -inkey key.pem -in cert.pem -passin pass:te
Note that the password here must be `test`.<sup>[1](#f1)</sup> Note that the password here must be `test`.<sup>[1](#f1)</sup>
## Building BitBetter <a name=#building></a> ## Building BitBetter
Now that you've generated your own own self-signed certificate, you can run the main `BitBetter/build.sh` script to generate a modified version of the `bitwarden/api` docker image. Now that you've generated your own own self-signed certificate, you can run the main `BitBetter/build.sh` script to generate a modified version of the `bitwarden/api` docker image.
@ -72,7 +72,7 @@ You'll also want to edit the `/path/to/bwdata/scripts/run.sh` file. In the `func
You can now start or restart Bitwarden as normal and the modified api will be used. <b>It is now ready to accept self-issued licenses.</b> You can now start or restart Bitwarden as normal and the modified api will be used. <b>It is now ready to accept self-issued licenses.</b>
## Generating Signed Licenses <a name=#generating></a> ## Generating Signed Licenses
There is a tool included in the directory `src/licenseGen/` that will generate new individual and organization licenses. These licenses will be accepted by the modified Bitwarden because they will be signed by the certificate you generated in earlier steps. There is a tool included in the directory `src/licenseGen/` that will generate new individual and organization licenses. These licenses will be accepted by the modified Bitwarden because they will be signed by the certificate you generated in earlier steps.
@ -93,7 +93,7 @@ You'll need to get a user's <b>GUID</b> in order to generate an <b>invididual li
<b>The license generator will spit out a JSON-formatted license which can then be used within the Bitwarden web front-end to license your user or org!</b> <b>The license generator will spit out a JSON-formatted license which can then be used within the Bitwarden web front-end to license your user or org!</b>
# FAQ: Questions (you might have?) <a name=#faq></a> # FAQ: Questions (you might have?)
I'll work on updates in the next couple weeks, right now, I just wanted something to start with. I'll work on updates in the next couple weeks, right now, I just wanted something to start with.
@ -111,7 +111,7 @@ To be clear i'm totally happy to give them my money. Offer a perpetual server li
I'm still in the testing/evaluating phase. If I am hosting the server/data, let me license the server, period. How many licenses does one user need to have... I'm still in the testing/evaluating phase. If I am hosting the server/data, let me license the server, period. How many licenses does one user need to have...
# Footnotes <a name=#footnotes></a> # Footnotes
<a name="#f1"><sup>1</sup></a> If you wish to change this you'll need to change the value that `src/licenseGen/Program.cs` uses for it's `GenerateUserLicense` and `GenerateOrgLicense` calls, but this is really unnecessary as this certificate does not represent any type of security issue. <a name="#f1"><sup>1</sup></a> If you wish to change this you'll need to change the value that `src/licenseGen/Program.cs` uses for it's `GenerateUserLicense` and `GenerateOrgLicense` calls, but this is really unnecessary as this certificate does not represent any type of security issue.