As of censhare 2021.2 censhare is released as censhare WP. Follow this chapter to install and upgrade censhare to 2021.2.x.

About

censhare WP brings performance improvements and increased speed for the web-based client application. It also allows for external authentication methods such as two-factor authentication, LDAP, and SAML as well as integrating your existing identity solutions. censhare WP uses Keycloak for external authentication. Keycloak is an open-source identity and access management solution. 

Discover the benefits and why you should update to censhare WP now.

Find answers to your use cases and what the update involves for your projects.

Guides

Installation

For new and update installations and configurations of censhare WP and Keycloak, follow the guides below.

Administrator guide to censhare WP and Keycloak

Follow this guide:

  • if you are a Solution Developer, Project Manager or censhare administrator
  • if you want to install and configure censhare WP on a staging or production system

Technical FAQ censhare WP and Keycloak

A technical Q&A around censhare WP, external authentication, and Keycloak topics.

Project FAQ censhare WP and Keycloak

Why censhare WP?

With censhare WP, censhare offers increased performance combined with lower latency for the web client. In conjunction with the external authentication options introduced with Keycloak support, these are key benefits that take censhare to the next level. 

censhare WP - Components and architecture

An overview of the components and architecture of censhare WP.

censhare WP - RPM-based installation

censhare WP uses Webpack technology and requires Keycloak for identity management. Follow this tutorial to set up censhare WP.

censhare WP - Initial configuration

Initial configuration of censhare WP, including Webpack and the required Keycloak settings.

censhare WP and Keycloak - Monitor and logging

Monitor and log the censhare WP and Keycloak related services.

Keycloak authentication

With Keycloak, censhare provides an external authentication solution that can integrate existing authentication methods. Keycloak is available in combination with censhare WP.

  • Install Keycloak — Learn how to install a fresh Keycloak instance or use an existing one with censhare WP.
  • Upgrade Keycloak — Learn about the steps to upgrade Keycloak to a later version. 
  • Configure Keycloak for external authentication — censhare WP requires external authentication using Keycloak as identity broker. Keycloak runs on a dedicated authentication server.  Learn how to configure Keycloak to use it with censhare WP.
  • Configure Keycloak with censhare standard login — Learn how to add users to Keycloak. Keycloak can be configured with the censhare standard login. Keycloak verifies the user credentials and authenticates the users. Users can log into censhare Web, the censhare Client, and censhare Admin Client.
    • Add new users to Keycloak — Keycloak user authentication requires users to have an account in Keycloak or to be linked to it, for example via LDAP. Learn how to create an account directly in Keycloak.
    • Configure user group mapping — Learn how to configure user group mapping for censhare Server based on user information stored in Keycloak.
    • Migrate users to Keycloak — Learn how to migrate users with censhare standard login into Keycloak by script.
  • Configure Keycloak with LDAP — You can add an LDAP/AD service to Keycloak to log in users to censhare with their LDAP/AD user profile.
  • Configure Keycloak with SAML — The SAML protocol provides single sign-on to applications across organizational boundaries. Keycloak serves as an identity broker between censhare and an identity provider.
  • Enable password reset on login page — Learn how to enable users to reset their passwords on the Keycloak login page.
  • Enable password change — Learn how to enable password change for censhare Web and censhare Client via Keycloak.
  • Authorization mapper — The authorization mapper synchronizes the roles, domains, groups and other settings of a user from Keycloak with the user table of the censhare Server.

Developer guide to censhare WP and Keycloak

Follow this guide:

  • if you are a developer
  • if you want to install censhare WP on your local computer
  • if you want to develop, test, and commit changes to the censhare WP Git project

Local installation of censhare WP on macOS

This article describes the installation of censhare WP on a local machine for developing purposes.

Configure HTTPS for censhare WP

To access censhare WP via a secure protocol (HTTPS), the server and the components must be configured accordingly.

How to release censhare WP

This article explains how to release webpack.

Keycloak service

How to set up the Keycloak Service using the censhare Admin Client.

Custom branding (censhare WP)

Configure the look and feel of censhare Web with your organization's corporate design.

Create custom theme for Keycloak

Learn how to customize the Keycloak login page.

Static resource server repository

How to create a custom configuration of censhare Static Resource Server (SRS).

Install Google AI microservice (local)

If you set up censhare WP locally with Google AI services, the Google AI microservice must run in a local container.