trickaugusto / nest-api

NestJS Api

Description

Welcome to my Nest API. This is a POC. In this project, exists POSTS and USERS records.

What i used?

All:

• Code first
• Authentication and Authorization and JWT passport strategy
• Guards, Pipes, etc

Techs:

• Nest
• Mongo/mongoose
• Docker

Configuration

I used mongodb database. So, if you want to test this project, you need to create a database in mongo. In src/database/environments you need to create an environments.ts based in environments.example.ts.

Obs: To generate JWT_SECRET, you can use a site to generate, like this https://www.javainuse.com/jwtgenerator. If you want, leave it the way it is.

Running project

Clone the project:

git clone [e-mail]:trickaugusto/nest-api.git

Go to project:

cd nest-api

Now, dont forget: you need to do Configuration step. If you dont created environments.ts, back and do.
If you created, lets go to next command:

Running with docker:

yarn start:docker

Tests

This topic is incomplete.

Authorization and Authentication

All routes have JWT Guard, to access this routes, you need authenticate in signin route, get accessToken and send like bearer token in header.

About the authorization, see all roles in src/auth/enums/user-roles.enum

Documentation

After run project, you can access full swagger documentation:
http://localhost:3000/api

Difficulties

I experienced some difficultes to implement authentication and authorization, but i win this reading documentation and this post: https://betterprogramming.pub/jwt-and-passport-jwt-strategy-for-your-nestjs-rest-api-project-cafa9dd59890