Panel | ||
---|---|---|
| ||
The purpose of this module is to:
|
Panel | ||
---|---|---|
| ||
|
Overview
The first steps when setting up delegated role and user management:
- Define what types of services and organizations this system will manage
- Define what roles these services and organizations need to operate
- Migrate customer organizations from e.g. existing CRM system
- Create organization users using role invitation by email. The user confirms their own email address by clicking the link and sets their own password
Configure organization types
- You can use organization types to model:
- A customer organization with various roles
- An online service (MySmartPlan) with various roles
- Outcome: Organization type to be used when creating companies
There are two types of organizations: physical and virtual.
- Organizations are used to for storing user accounts
- Virtual organizations are used to model a organizations and services.
- In virtual organizations, the users are not physically located in any of the projects but they are part of them through roles.
The system will read the correct values from eidm2_generated.properties file. During system setup, the file eidm2_generated.properties is read first and the eidm2.properties is read and overwrites any settings in eidm2_generated.properties.
Tip | ||
---|---|---|
| ||
eidm is obsolete name for CustomerID. It meant "extranet Identity Management" |
Part 1: Configuring Organization Types
Step 1: Configuring Customer Organizations
company
to hold customer organization userscompany
organization has two roles, Contact Person and Representative, represented by the technical names mainuser and user respectively.Edit customerid\application\custom\eidm2.properties
Code Block title eidm2.properties organization.type.name.1 = company organization.type.company.1 = mainuser organization.type.company.2 = user
Copy C:\Program Files\Ubisecure\customerid\tools\examples\custom\messages_en.properties to \customerid\application\custom\ and then add the following lines to the file.
Code Block title messages_en.properties org.label.company = Customer Organization org.label.company.plural = Customer Organizations
Edit customerid\application\custom\roles.properties
Code Block title roles.properties en.friendlyName.mainuser = Contact Person en.friendlyName.user = Representative
Step 2: Configuring Service Organizations
Create a new organization type to hold MySmartPlan roles
This service has three roles: Owner, Member and Visitor
Edit customerid\application\custom\eidm2.properties
Code Block title eidm2.properties organization.type.name.2 = site organization.type.site.1 = owner organization.type.site.2 = member organization.type.site.3 = visitor
Edit customerid\application\custom\messages_en.properties
Code Block title messages_en.properties org.label.site = Service org.label.site.plural = Services
Edit customerid\application\custom\roles.properties to define what each role name is
Code Block title roles.properties en.friendlyName.owner = Owner en.description.owner = Owner of this site with manager rights en.friendlyName.member = Member en.description.member = Member of the site en.friendlyName.visitor = Visitor en.description.visitor = Read only access
Activate all changes by restarting Wildfly
Note |
---|
Restart of Wildfly is required when changes are made to CustomerID system configuration and localization text files |
Part 2: Configuring Organization and user attributes
Step 1: Create Custom Organization Attributes
Custom organization attributes are added dynamically to the schema as used. If used, localization must be given.
Define default language text key for the new attribute in customerid\application\custom\messages_en.properties
Code Block title messages_en.properties organization.crmid = CRM ID registerWizard.organization.crmid = CRM ID
Define the order of displaying custom fields on the organization info page by modifying: customerid\application\custom\eidm2.properties
Code Block title eidm2.properties ui.admin.organizationinfo.fields.order = technicalname, friendlyname, crmid
Restart Wildfly
Log in and select an organization. Observe the order of attributes:
As you can observe, there are only administrative organizations such as "Users." The next step is to create customer organizations (companies) in the system.
Part 3: Migrate customer organizations
Step 1: Customer Data Integration with Import Tool
- City Group
- Electric Green Cabs
The VAT number (such as 2184053-5) of the customer organization will be used as the unique identifier.
Go to directory C:\Program Files\Ubisecure\customerid\tools\examples\importtool and create file crm.import containing the entries shown on the next table
Code Block title crm.import # City Group entity: organization id: 2184053-5 organizationType: company crmid: 73476543 friendlyName: City Group Inc. # Electric Green Cabs entity: organization id: 4638229-4 organizationType: company crmid: 33241231 friendlyName: Electric Green Cabs Inc.
In customerid\tools directory, run the following command:
Code Block import.cmd examples\importtool\crm.import
Successful execution will show a message like this:
ImportTool 5.0.31
Create '2184053-5': OK
Create '4638229-4': OK
- Now log in, find the newly created organization "Electric Green Cabs." Observe its attributes and their order as at the end of Part 2 (Technical name, Name, CRM ID).
Part 4: Create users by email-based invitation
- by system or organization administrator using the administration user interface or
- by REST interface
- User Self-registration
- Using Import tool