-
Notifications
You must be signed in to change notification settings - Fork 6
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
chore: cleanup files and update README
- Loading branch information
Showing
4 changed files
with
6 additions
and
107 deletions.
There are no files selected for viewing
This file contains 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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,73 +1,3 @@ | ||
# Overview | ||
# Overview[WIP] | ||
|
||
This is a guide on how to get the project running and how to contribute | ||
|
||
|
||
## Getting started | ||
|
||
### Prerequisites | ||
- Node.js 20 | ||
- Docker | ||
|
||
#### Clone the project | ||
|
||
```bash | ||
git clone [email protected]:algorandfoundation/liquid-auth.git && cd liquid-auth | ||
``` | ||
|
||
#### Install package dependencies | ||
|
||
```bash | ||
npm install | ||
``` | ||
|
||
#### Build Dependencies | ||
|
||
```bash | ||
npm run build | ||
``` | ||
|
||
WebAuthn requires a secure context (HTTPS) to work and this will not allow you to test the FIDO2 feature in your local machine. | ||
|
||
### NGROK | ||
|
||
Sign up for a free account at [ngrok](https://ngrok.com/) and install the ngrok package. | ||
Configure a Static Domain for your ngrok account and update the [.env](services/liquid-auth-api-js/README.md) file with the following keys with the values from ngrok: | ||
|
||
|
||
#### Configure NGROK | ||
|
||
```bash | ||
cp ./ngrok.template.yml ngrok.yml | ||
``` | ||
|
||
Make sure to update the `authtoken` and `domain` in the `ngrok.yml` file with your ngrok details. | ||
|
||
```yaml | ||
version: 2 | ||
authtoken: <NGROK_AUTH_TOKEN> | ||
tunnels: | ||
website: | ||
addr: liquid-demo:5173 | ||
proto: https | ||
domain: <NGROK_STATIC_DOMAIN> | ||
``` | ||
#### Update the Service's .docker.env file | ||
```bash | ||
#.docker.env | ||
HOSTNAME=<NGROK_STATIC_DOMAIN> | ||
ORIGIN=https://<NGROK_STATIC_DOMAIN> | ||
``` | ||
|
||
#### Start services | ||
|
||
Run the following command to start the backend: | ||
|
||
```bash | ||
docker-compose up -d | ||
``` | ||
|
||
Navigate to the ngrok URL in your browser to test the FIDO2 feature. | ||
|
This file contains 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
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -11,8 +11,6 @@ This project holds the standard FIDO2 api endpoints and the Proof of Knowledge f | |
The api is a stateful session-based architecture with endpoint guards. | ||
A user must prove ownership of a private key to associate PublicKeyCredentials | ||
|
||
|
||
|
||
## Getting started | ||
|
||
### Prerequisites | ||
|
@@ -27,16 +25,6 @@ git clone [email protected]:algorandfoundation/liquid-auth.git && cd liquid-auth | |
|
||
#### Install package dependencies | ||
|
||
```bash | ||
npm install | ||
``` | ||
|
||
#### Build Dependencies | ||
|
||
```bash | ||
npm run build | ||
``` | ||
|
||
WebAuthn requires a secure context (HTTPS) to work and this will not allow you to test the FIDO2 feature in your local machine. | ||
|
||
### NGROK | ||
|
@@ -47,12 +35,9 @@ Configure a Static Domain for your ngrok account and update the [.env](services/ | |
|
||
#### Configure NGROK | ||
|
||
```bash | ||
cp ./ngrok.template.yml ngrok.yml | ||
``` | ||
|
||
Make sure to update the `authtoken` and `domain` in the `ngrok.yml` file with your ngrok details. | ||
Add a `ngrok.yml` configuration to the root directory. | ||
|
||
##### Example Configuration | ||
```yaml | ||
version: 2 | ||
authtoken: <NGROK_AUTH_TOKEN> | ||
|
@@ -63,6 +48,7 @@ tunnels: | |
domain: <NGROK_STATIC_DOMAIN> | ||
|
||
``` | ||
*Make sure to update the `authtoken` and `domain` in the `ngrok.yml` file with your ngrok details.* | ||
|
||
#### Update the Service's .docker.env file | ||
|
||
|
@@ -71,7 +57,7 @@ HOSTNAME=<NGROK_STATIC_DOMAIN> | |
ORIGIN=https://<NGROK_STATIC_DOMAIN> | ||
``` | ||
|
||
#### Start services | ||
### Start services | ||
|
||
Run the following command to start the backend: | ||
|
||
|
@@ -84,7 +70,7 @@ Navigate to the ngrok URL in your browser to test the FIDO2 feature. | |
|
||
## Using the app | ||
|
||
#### Install the [Android client]() to your device and navigate to https://nest-fido2.onrender.com/. | ||
#### Install the [Android client](https://github.com/awesome-algorand/android-authentication-client) to your device. | ||
|
||
![Step-1.png](.docs%2FStep-1.png) | ||
|
||
|
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.