IdStory Identity Manager - tutorial:dev

Systems - Groups synchronization workflow

Anonymous (anonymous@undisclosed.example.com) — 2021-03-11T21:05:58+00:00

Systems - Groups synchronization workflow workflow ad ldap roles groups synchronization member memberof extras moduleis highly recommended This tutorial is intended as a guide to modify workflow for synchronization groups from Active Directory. After modifying this workflow, synchronization of groups can: * create automatic roles by:

Authentication - create a new authentication method

Anonymous (anonymous@undisclosed.example.com) — 2021-01-19T14:15:36+00:00

Authentication - create a new authentication method This tutorial shows, how to add a new authentication method to CzechIdM. The authentication will be typically done by some external authority, such as OpenAM, OAuth, Facebook, Google etc. Supported authentication methods are implemented in several

Add support for a new entity in general report

Anonymous (anonymous@undisclosed.example.com) — 2020-03-10T13:36:46+00:00

Add support for a new entity in general report Genral entity report is a tool which enables users to export data tables from CzechIdM. If you want you entity to support this feature, you need to meet these requirements: * Entity must support bulk actions

Add localization test to a module

Anonymous (anonymous@undisclosed.example.com) — 2018-03-09T13:59:35+00:00

Add localization test to a module It is a good idea to test completeness of localization files. Such tests prevent incomplete and incorrect app localization. In CzechIdM, we use localization files .json to define text descriptions in application for different languages.

Application architecture

Anonymous (anonymous@undisclosed.example.com) — 2017-10-03T08:11:47+00:00

Application architecture This page describes the CzechIdM application architecture. Overview CzechIdM consists of two major components, a backend (BE) and a frontend (FE). Backend is realized as a Java application running from within the Tomcat container. Frontend is a HTML5+JS single-page application.

Systems - Database: creating a test DB system and connection to CzechIdM via REST

Anonymous (anonymous@undisclosed.example.com) — 2017-11-14T14:31:12+00:00

Systems - Database: creating a test DB system and connection to CzechIdM via REST This tutorial will show you, how to create simple database table that you can then connect to CzechIdM via REST endpoint. Create table Create new table in database of your CzechIdM.

Build CzechIdM Backend

Anonymous (anonymous@undisclosed.example.com) — 2024-01-09T08:28:49+00:00

Build CzechIdM Backend Requirements Install OpenJDK 11 (OpenJDK 21 for CzechIdm 13.1.0+). Install Maven. - Required version is 3.1 or higher Install Tomcat 9.0.*. Tested versions: 9.0.80 Modules Project modules [mandatory] * parent Maven parent of all following submodules with common dependencies

Build CzechIdM Frontend

Anonymous (anonymous@undisclosed.example.com) — 2019-07-30T12:12:49+00:00

Build CzechIdM Frontend this tutorial

Button - Implementing responsive filter button

Anonymous (anonymous@undisclosed.example.com) — 2017-11-04T23:33:34+00:00

Button - Implementing responsive filter button Description When we have filled some information in filter table than button with label “Filter” in top right corner changes its color to light blue instead of gray. It will help us recognize if the table below have all data we need and no filter is set.

Connector - Implementation of a new ConnID connector

Anonymous (anonymous@undisclosed.example.com) — 2026-02-25T14:41:45+00:00

Connector - Implementation of a new ConnID connector In this tutorial, we will see how to implement connector. Our example is CSV Connector. 1. Generate connector from archetype First option without downloading Other option is to use this command to generate skeleton for new connector. You don't need to clone the repository and this should work, because the connector-archetype artifact is available in standard maven repository.

Module - creating a CzechIdM module

Anonymous (anonymous@undisclosed.example.com) — 2018-07-17T10:41:03+00:00

Module - creating a CzechIdM module Please follow tutorial in idm-module-archetype project. Archetype generates for you backend and frontend. There is tutorial: Archetype tutorial

Reports module - Creating a report

Anonymous (anonymous@undisclosed.example.com) — 2020-09-11T11:44:44+00:00

Reports module - Creating a report report Reports module was added in CzechIdM 7.6.0. The aim of this tutorial is to show the way, how to create your own report. We will be creating a new report with all identities in xlsx format and we want to have report with enabled / disabled identities, so we want to search identities by their enabled status. This filter parameter will be optional - all identities will be in report, if activity is not selected.

Creating a development environment

Anonymous (anonymous@undisclosed.example.com) — 2026-02-19T12:39:47+00:00

Creating a development environment This text is intended as a tutorial for CzechIdM developers with the goal to set up IDE, build CzechIdM in it and run the system. If you prefer quick glance at the code or need to start quickly, you can use Quick start with devstack. 1. Install Java and Maven

Entity - create a new CzechIdM entity and its management

Anonymous (anonymous@undisclosed.example.com) — 2018-09-27T09:06:43+00:00

Entity - create a new CzechIdM entity and its management This tutorial shows, how to add a new agenda for reading, creating, editing and deleting a new entity. Source code for this tutorial can be found in the example module: * backend * frontend Backend We start from the persistence layer - add a new entity

Customize password change form

Anonymous (anonymous@undisclosed.example.com) — 2019-04-10T06:35:35+00:00

Customize password change form Password change can be customized by component descriptor. If you want add or remove components in user password change it is possible by module descriptor, example: { 'id': 'basic-password-change', 'type': 'password-change-component', 'component': require('./src/components/advanced/PasswordChangeComponent/PasswordChangeComponent'), 'disabled': false, 'order': 0, 'col': 6 }

Vývojové prostředí: Instalace Node, Javy a NX Console

Anonymous (anonymous@undisclosed.example.com) — 2025-06-30T15:29:15+00:00

Vývojové prostředí: Instalace Node, Javy a NX Console Tato stránka popisuje postup, jak si vývojář může připravit vývojové prostředí se správnými verzemi Node.js a Javy, jak používat soubory `.nvmrc` a `.sdkmanrc`, a jak v IDE používat nástroj

Dynamic form - localization

Anonymous (anonymous@undisclosed.example.com) — 2018-06-07T07:03:21+00:00

Dynamic form - localization configuration eav form The aim of this tutorial is show the way, how to add localization for dynamic form. What do you need before you start * You need to install CzechIdM 8.1.0 (and higher). We have CzechIdM installed for this tutorial on server . *

EAV - create a new form attribute

Anonymous (anonymous@undisclosed.example.com) — 2020-02-26T12:53:32+00:00

EAV - create a new form attribute How to implement creation of a new form attribute (EAV) of a specific type? Code list type Following snippet creates a new EAV with the code and name "mailType" in the main IdmIdentity form definition. The values of the EAV attribute will be taken from a code list with the code "possibleMailTypes".

Groovy Scripts Tips & Tricks

Anonymous (anonymous@undisclosed.example.com) — 2021-04-07T19:42:34+00:00

Groovy Scripts Tips & Tricks Tips and trics for writing groovy scripts in CzechIdM. Scripts: * Convert objectSID (byte[]) to String * Convert String to LocalDate * Custom filter for synchronization * Get EAV for users inherited from the organization structure * Get EAV of code list item. * Get identity by personal number (externalCode) * Get manager of users * getFullname - create fullname * Script to restart stuck tasks - extras status lrt cancel Add new "Script" entry:

Class - Add a new attribute into a class

Anonymous (anonymous@undisclosed.example.com) — 2017-11-04T23:36:51+00:00

Class - Add a new attribute into a class Sometimes we wonder how to add a property into a class. For example the property started into LongRunningTask. 1) First of all we add this property into class where we need it. Let's use our example: @Column(name = "task_started") private DateTime taskStarted;

Table in GUI - create a new

Anonymous (anonymous@undisclosed.example.com) — 2018-02-28T11:29:58+00:00

Table in GUI - create a new Table: We will use one of components in Advanced folder. It is Table component. We can find this component in Basic too, but it's better to use Advanced for its "advanced" features such as sorting of columns. It is used like this:

Dynamic form - creating a new attribute renderer

Anonymous (anonymous@undisclosed.example.com) — 2019-02-04T09:29:42+00:00

Dynamic form - creating a new attribute renderer In this tutorial we will describe how to create a new attribute renderer for a dynamic form attribute. A new render will be used for a persistent type INT. Renderer define a new face PRIORITY-SELECT and an input will be represented as five radio buttons.

Authorization - Create a new evaluator

Anonymous (anonymous@undisclosed.example.com) — 2017-11-04T23:30:37+00:00

Authorization - Create a new evaluator Step 1. create evaluator The most easiest way is to copy some existing evaluator and just refactor its name, package, constructor and everything you need. Good for copy is for example RoleGuaranteeEvaluator, this evaluator returns all roles, of which the logged user is the guarantee.

Release a hotfix

Anonymous (anonymous@undisclosed.example.com) — 2017-11-28T12:19:52+00:00

Release a hotfix In this tutorial we will describe how to release a hotfix. 01 - Prerequisites * We need clone of git repository with checkout actual branch with hotfix, during the process, we will need the right to write to this repository, example: # clone respository $ git clone git@github.com:bcvsolutions/CzechIdMng.git # change folder $ cd CzechIdMng # checkouthotfix $ git checkout hotfix/

Run multiple CzechIdM instances using IntelliJ Idea and Gulp as a developer

Anonymous (anonymous@undisclosed.example.com) — 2021-04-14T07:03:39+00:00

Run multiple CzechIdM instances using IntelliJ Idea and Gulp as a developer If you somehow find yourself in a situation, when you need to run multiple CzechIdM instances for development (for example when testing CzechIdM's cloud capabilities), you may consider doing this using you IDE as it provides you some neat advantages over running separate virtual machines:

Module - creating a new dashboard button

Anonymous (anonymous@undisclosed.example.com) — 2019-04-10T11:52:21+00:00

Module - creating a new dashboard button In this tutorial we will describe how to create and register new button on identity dashboard. What do you need before you start * You need to install CzechIdM 9.6.0 (and higher). We have CzechIdM installed for this tutorial on server

Module - creating a new icon

Anonymous (anonymous@undisclosed.example.com) — 2019-02-04T11:08:53+00:00

Module - creating a new icon In this tutorial we will describe how to create, register and use a new icon in our module. What do you need before you start * You need to install CzechIdM 9.4.0 (and higher). We have CzechIdM installed for this tutorial on server

Release CzechIdM

Anonymous (anonymous@undisclosed.example.com) — 2023-04-20T09:34:20+00:00

Release CzechIdM WARNING: This page is deprecated. Current release process documentation: https://github.com/bcvsolutions/CzechIdMng/blob/develop/RELEASE.md In this tutorial we will describe how to release a new version of CzechIdM. 01 - Prerequisites

Processor - implement a new processor

Anonymous (anonymous@undisclosed.example.com) — 2020-04-28T21:28:47+00:00

Processor - implement a new processor Important notes In this tutorial, we will describe how to create a new processor. Before we begin to build a new processor, there is a little bit of background of what exactly the processor is. Here is documentation about processors:

DTO - find it by its identifier

Anonymous (anonymous@undisclosed.example.com) — 2018-06-15T05:36:32+00:00

DTO - find it by its identifier AbstractDto can be identified by uuid identifier and if dto implements Codeable interface, then by it's string code too. Codeable interface is typically used for identity, role, system etc. => for dtos with some unique code. In this tutorial we will describe how to simple find single dto (or entity) by an identifier.

Module - Test configurations

Anonymous (anonymous@undisclosed.example.com) — 2019-09-23T14:10:48+00:00

Module - Test configurations The aim of this tutorial is show the way, how to test module provided configurations (and all registrable configurable components). Every module provide it's configuration properties. In CzechIdM 9.7.7 was added support to test this configurations - "formal" test are implemented:

Module - Preparing a new CzechIdM module

Anonymous (anonymous@undisclosed.example.com) — 2018-07-17T10:42:02+00:00

Module - Preparing a new CzechIdM module Basic application skeleton you can create by archetype, please follow this tutorial: Archetype tutorial. CzechIdM is a modular application built by Maven. Modules often have really similar structure consisting of: * Java source code

Module - Result codes

Anonymous (anonymous@undisclosed.example.com) — 2018-06-04T11:03:34+00:00

Module - Result codes The aim of this tutorial is show the way, how to define result codes in custom module and how to expose list of codes on frontend. What do you need before you start * You need to install CzechIdM 8.1.0 (and higher). We have CzechIdM installed for this tutorial on server

Module - Overriding a filter in a custom module

Anonymous (anonymous@undisclosed.example.com) — 2019-03-01T10:37:37+00:00

Module - Overriding a filter in a custom module A mechanism for dynamic registry and composing of filters has been developed in the application for searching the data in IdM (identities, roles, tree structure components, etc.). A new filter can be registered for existing REST services in any module.

How to override a spring service

Anonymous (anonymous@undisclosed.example.com) — 2019-09-11T14:18:29+00:00

How to override a spring service override service primary priority bean Spring service (or other bean) overriding is typically used when we want to change the default behavior of a basic service implementation in a product or in another module. In this case, we want to replace the default implementation with our new one. In this tutorial, we'll look at the basic ways we can do this.

Prepare CzechIdM build on projects - with custom module

Anonymous (anonymous@undisclosed.example.com) — 2018-07-17T10:38:15+00:00

Prepare CzechIdM build on projects - with custom module In this tutorial, I'll be using Eclipse, so if you are using another IDE is possible that some name will be different. Archetype tutorial Step by step Backend (I'll be using project name CGL) * create a new workspace

Quick start with devstack

Anonymous (anonymous@undisclosed.example.com) — 2018-01-29T08:57:49+00:00

Quick start with devstack When you want to try start explore CzechIdM from developer view and you don't have enough free time, is possible use our Docker with setup all necessary applications and service. Docker url: https://hub.docker.com/r/bcvsolutions/czechidm-dev/. Using this Docker container is very simple.

Scheduled task with parameters

Anonymous (anonymous@undisclosed.example.com) — 2021-02-18T18:34:05+00:00

Scheduled task with parameters scheduler CzechIdM supports three types of the so-called Scheduled tasks - business logic execution tasks running asynchronously outside of the main thread. There are following types: * Long Running task - run from code, cannot be scheduled

SCIM module - save extended form value

Anonymous (anonymous@undisclosed.example.com) — 2020-04-14T11:13:32+00:00

SCIM module - save extended form value scim SCIM module was added in CzechIdM 8.1.0. We want to create user (~IdM identity) with an extended attribute (~IdM form value). Extended attributes are defined as extended schema, which can be added to resources implementing

SCIM module - Creating a user with group assigned

Anonymous (anonymous@undisclosed.example.com) — 2019-02-05T12:56:05+00:00

SCIM module - Creating a user with group assigned scim SCIM module was added in CzechIdM 8.1.0. The aim of this tutorial is to create a new group (~ IdM role), a user (~ IdM identity) with contract (~ IdM identity contract). Then assign him a group (~IdM identity role).

Test: Test scenarios

Anonymous (anonymous@undisclosed.example.com) — 2019-05-13T10:06:02+00:00

Test: Test scenarios * Product * Password change on the target system * Modules: * Certificates * Password reset * Projects SYNCHRONIZATION * (TC 80) Identities: initial synchronization from a CSV file (zero state in IdM) * (TC-69) Tree-nodes: initial synchronization (zero state in IdM) SETTINGS * (TC-73) Generators: adding a new rule (login generator)