Keycloak Node.js Adapter

Keycloak is an Open Source Identity and Access Management solution for modern Applications and Services.

This repository contains the source code for the Keycloak Node.js adapter. This module makes it simple to implement a Node.js Connect-friendly application that uses Keycloak for its authentication and authorization needs.

Changes made in this fork (keycloak-nodejs-connect)

Support configuration of authentication server URL that should be used for backend requests. The configuration is made using internal-auth-server-url in keycloak.json.

This is particulary useful when:

1. You using this keycloak-nodejs-connect to integrate a reverse proxy to Keycloak;
2. Keycloak itself is running behind your proxy;
3. You want the requests your reverse proxy makes to Keycloak bypass the proxy.

Example:

{
  "realm" : "nodejs-example",
  "auth-server-url" : "https://localhost/auth",
  "internal-auth-server-url" : "http://localhost:8080/auth",
  "ssl-required" : "external",
  "resource" : "nodejs-connect",
  "public-client" : true
}

Help and Documentation

• Documentation
• User Mailing List - Mailing list for help and general questions about Keycloak
• JIRA - Issue tracker for bugs and feature requests

Reporting Security Vulnerabilities

If you've found a security vulnerability, please look at the instructions on how to properly report it

Reporting an issue

If you believe you have discovered a defect in the Node.js adapter please open an issue in our Issue Tracker. Please remember to provide a good summary, description as well as steps to reproduce the issue.

Getting started

To run Node.js adapter examples please try one of our quickstarts.

For more details refer to the Keycloak Documentation.

Writing Tests

To write tests refer to the writing tests guide.

Contributing

Before contributing to Node.js adapter please read our contributing guidelines.

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 Gatekeeper - Proxy service to secure apps and services with Keycloak
• Keycloak Node.js Admin Client - Node.js library for Keycloak Admin REST API

License

• Apache License, Version 2.0