Adapter Node.js para integração com Keycloak
This repository is a fork of version 18.0.2 from the repository https://github.com/keycloak/keycloak-nodejs-connect. Further details about the implementation should be consulted in the original project.
Occasionally, companies may have restrictions on making the Keycloak administration console and its public keys available on a public URL.
Due to this restriction, only the URLs for token generation, based on the user's realm to be authenticated, are exposed through the API Gateway.
The need to modify the original version arises because the iss (Issuer Claim) address is different from the address where the token is validated.
For example, in the development environment, for the specific realm, the token is generated through the request curl --location 'https://auth-dev.company.com.br/users/realm-name/token' , and in this case, the JWT token's iss is https://auth-dev.company.com.br/realms/realm-name.
Therefore, the realmUrl property may contain a different base address from the iss because the token will be validated at the internal address of the K8S cluster (which is not publicly exposed).
Information about Publishing New Versions
Before publishing new versions of the package, please ensure you have the necessary access as an administrator to the CashGo organization's repository on NPM (https://www.npmjs.com/settings/cashgo).
Here are the steps to publish new versions:
1 - Log in to NPM using the terminal command npm login. Enter your NPM credentials when prompted.
2 - Whenever you make modifications to the package, increment the version following the Semantic Versioning format using the script ./set-version.sh x.y.z, where x.y.z represents the new version number.
3 - After incrementing the version, commit your changes to the repository.
4 - Finally, publish the new version to NPM using the script ./release.sh. This script will take care of the publishing process.
Following these steps will ensure that new versions of the package are properly incremented, committed, and published to the CashGo organization's repository on NPM. Always remember to follow the best practices for versioning and make sure to thoroughly test the changes before publishing a new version.
Version of nodejs
v19.7.0
Other Keycloak Projects
- Keycloak - Keycloak Server and Java adapters
- Keycloak Documentation - Documentation for Keycloak
- Keycloak QuickStarts - QuickStarts for getting started with Keycloak
- Keycloak Docker - Docker images for Keycloak
- Keycloak Node.js Admin Client - Node.js library for Keycloak Admin REST API