diff --git a/nodejs/resource-server/README.md b/nodejs/resource-server/README.md new file mode 100644 index 0000000..b7968c4 --- /dev/null +++ b/nodejs/resource-server/README.md @@ -0,0 +1,108 @@ + +# 🪪 Keycloack Project v0 + +Use [Expressjs](https://expressjs.com/), and [Passport](https://www.passportjs.org/packages/) + + +Welcome to Episode 0 of the #keycloakSeries! + +Keycloak is an open-source Identity and Access Management (IAM) tool that helps secure services and applications by providing authentication. + +🔹 What's New in this APP? + + + In this hands-on tutorial, we’ll dive straight into + running Keycloak locally, setting the stage for + practical exploration. Our approach is simple: + install Keycloak, spin it up, and connect it to a + basic Node.js app to get familiar with its essentials. + Throughout this series, we’ll focus on practical + implementations while shedding light on the key + theoretical concepts that make it all work. + By the end, you’ll be equipped to seamlessly manage + authentication and authorization in your pplications. + +Ready to dive in? Check out the GitHub repository for full instructions and code: + +👉 Tutorial: [Seamless Auth with Auth0, Express, and Passport: A Quick Guide 🎉 +Learn how to integrate secure authentication in your Node.js app using Auth0, Express, and Passport with minimal setup]() + + +## Installation Guide + +Follow these steps to set up the project locally on your machine: +Prerequisites + +Make sure you have the following installed: + + Node.js (v14 or later) + npm (Node Package Manager, comes with Node.js) + Git (for cloning the repository) + +Steps to Install + +### 1 Clone the Repository + +Open your terminal and run the following command to clone the repository: + + + git clone https://github.com/giljr/keycloak_project.git + + +### 2 Navigate to the Project Directory + +Change your directory to the cloned project: + + cd keycloak_project/nodejs/resource-server + code . + exit + +### 3 Install Dependencies + +Run the following command to install the required dependencies: + + npm install + npm install keycloak-connect express-session + +### 4 Access keycloak Application on + + http://localhost:8080/ + + +### Additional Information + +For further configuration and usage details, please refer to the + +Keycloak — Identity Provider — Hello World! — [Episode 0](https://medium.com/jungletronics/keycloak-identity-provider-192ffd9a00ae) + +And Library: [passportjs.org](https://www.passportjs.org/concepts/authentication/sessions/) for Session Documentations. + +More files are available: +[Google Driver](https://drive.google.com/drive/folders/1Bz3Awz_zs-T5RpUsfgcSPMRCqM2aKyhI?usp=drive_link) + +```bash + Enjoy! +``` + + +## Acknowledgements +- [Aaron Parecki](https://aaronparecki.com/) - OAuth Working Group at the [IETF](https://datatracker.ietf.org/wg/oauth/about/). + + - [ Luiz Felipe Batista Moschini ](https://www.linkedin.com/in/luiz-felipe-batista-moschini-4938a0211) + +- [ Jeovan Farias ](https://github.com/jeovan) + +## Authors + +- [@j3](https://github.com/giljr) + + +## 🚀 About Me +I'm a Full Stack Developer with a degree in Computer Engineering. You can explore my work and projects on my GitHub repository: + +[GitHub Repo](https://github.com/giljr/fiscal_service_app) + +## License + +[MIT](https://choosealicense.com/licenses/mit/) +