Affinidi Uaf Service Lib

This is a repository that contains all the necessary configuration you need to successfully start development of a new service according to the standards defined by our group.

Run the application

Add line to ~/.npmrc where TOKEN is your Github personal access token: to include affinityProject relative common libs //npm.pkg.github.com/:_authToken=TOKEN Howto create your Github personal access token.

$ npm install
$ npm run dev

How to use this

1. Clone the project to a new folder
2. Edit package.json to indicate the correct package name, description and author, and make sure you are using the correct or most current stable versions of the Affinity packages
3. Remove .git folder if you need a clean history, otherwise it's going to contain an initial commit reference
4. Initialize a new git repository if you deleted the .git folder
5. Delete example folder, it's there just so you can see the simplest setup
6. Update the file ./config/app.yaml to config your service:
   • Protect custom routes with API Key Check Middleware apikeyMiddlewareEnabled: true
   • Add publicPaths to array to overpass API Key check
7. Update the file ./config/errors.yaml to have custom errors for your service

CD and Infra Settings

Terrafrom/Terragrunt

Info

Terraform/Terragrunt is our tool of choice to manage the entire lifecycle of infrastructure using infrastructure as code. That means declaring infrastructure components in configuration files that are then used by Terraform to provision, adjust and tear down infrastructure in cloud provider. Terragrunt is a thin wrapper that provides extra tools for keeping your configurations DRY, working with multiple Terraform modules, and managing remote state.

How to

For launching infra using Terragrant, please see manual. Current project provides predefined infrastructure under the folder terraform. Please, delete terraform folder if current infra part not needed.

AWS-CLI/AWS-Vault

Info

AWS Vault is a tool to securely store and access AWS credentials in a development environment. Firstly AWS CLI needed to be installed.

How to

To set up and configure AWS CLI and AWS-Vault on local machine, please see manual.

API Gateway

KrakenD

Info

KrakenD is a high-performance open source API Gateway.

KrakenD supports flexible configuration that lets us use templating to create a final krakend.json.

We use this feature to separate endpoint definitions of team APIs to have better maintainability.

How to

Each API of the team should have its own configuration file stored under config/settings folder. If your new backend service need to be connected to the API gateway, please create JSON file with settings at api-gateway repo using following the naming standard of config/settings/api_$name.json where $name is a short name describing the API. Example: config/settings/api_.json

Settings have to match the following structure:

{
  "default_backend_host": "http://affinidi-uaf-service-lib",
  "endpoint_prefix": "/affinidi-uaf-service-lib/",
  "endpoints": [
    {
      "endpoint": "/v1/somepath/{id}",
      "backend": [
        {
          "url_pattern": "/api/v1/somepath/{id}"
        }
      ]
    }
  ]
}

Frameworks and tools

1. Typescript
2. Express for REST APIs
3. tsoa for OpenAPI spec generation
4. dotenv for .env file configuration
5. pino for logging
6. ESLint for code analysis
7. husky for git hooks
8. jest for testing