Skip to content

Commit

Permalink
chore: cleanup files and update README
Browse files Browse the repository at this point in the history
  • Loading branch information
PhearZero committed Apr 22, 2024
1 parent 3e34494 commit ce75747
Show file tree
Hide file tree
Showing 4 changed files with 6 additions and 107 deletions.
72 changes: 1 addition & 71 deletions CONTRIBUTING.md
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.

24 changes: 5 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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>
Expand All @@ -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

Expand All @@ -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:

Expand All @@ -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)

Expand Down
10 changes: 0 additions & 10 deletions docker-compose.developer.yml

This file was deleted.

7 changes: 0 additions & 7 deletions ngrok.template.yml

This file was deleted.

0 comments on commit ce75747

Please sign in to comment.