Empowering Empress with Fairlogin for Streamlined User Authentication

Guides & Tutorials
1

Introduction

Welcome to this guide on Fairlogin integration with Empress. Fairlogin is a user-friendly authentication tool developed by fairkom.eu, which adheres to the GDPR regulations. When integrated into your Empress instance, it provides a seamless, secure way for your users to log in.

What Does Fairlogin Do?

Fairlogin is based on Keycloak, a trusted open-source platform for identity and access management. By incorporating Fairlogin into your Empress system, you can streamline the process by which users gain access to your platform. This eliminates the need for multiple passwords and ensures extra security. Let’s dive into the setup process.

Configuring Keycloak

To integrate Fairlogin, we need to configure Keycloak within the Empress system. Here’s how:

  1. Go to Home > Integrations > Social Login Key on your Empress dashboard.
  2. Choose to create a new client.
  3. Select Open-ID for the client protocol.
  4. Input the address of your Empress instance in the Root URL, Redirect URL, and Base URL fields.

Note: Fairkom offers additional services to help with this process. They can add your Empress service as a client for you. To learn more, visit Fairkom Services.

Enabling Fairlogin in Empress

Next, we need to activate Fairlogin in Empress and configure a few settings:

  • Base URL: https://id.fairkom.net/auth/realms/fairlogin/
  • Authorize URL: https://id.fairkom.net/auth/realms/fairlogin/protocol/openid-connect/auth
  • Redirect URL: /api/method/frappe.integrations.oauth2*logins.login*via_fairlogin
  • Access Token URL: https://id.fairkom.net/auth/realms/fairlogin/protocol/openid-connect/token
  • API Endpoint: https://id.fairkom.net/auth/realms/fairlogin/protocol/openid-connect/userinfo

Once these settings are in place and the service is active, users can log in to your Empress instance using their Fairlogin accounts.

Please note that all new users are automatically assigned the role of Blogger. This role is currently set by default and cannot be changed.

Conclusion

Integrating Fairlogin with Empress not only enhances the security of your platform but also simplifies user login. This integration offers a win-win situation for both the users and administrators, making it a worthy addition to your Empress system. For further assistance, don’t hesitate to reach out to our support team or visit our resource center.