Table of contents

This article aims to provide you with information regarding what custom user attributes are and how to create them.

Custom_User_Attributes_1.png

What are custom user attributes and how do they work?

Custom attributes include additional information shown within your Happeo user profile / card aside from the standard Google or Okta Directory Fields.

This additional information allows for much richer profiles (e.g. details about interests, skill sets, preferred pronouns, etc.) and faster searches.

Custom_User_Attributes_2.png

Furthermore, only public attributes will be displayed on Happeo while attributes only visible to administrators will not be shown.

How often are custom attributes synced?

The synchronization happens automatically every 24 hours.

How to create a custom attribute in Google

Below, you can find a tutorial from Google:

  1. You can create a custom user attributes schema here by clicking on Manage custom attributesCustom_User_Attributes_1.png
  2. Select Add custom attribute
  3. Add fields into the created schema. These fields should make the organization's visible fields available only for sync and visible in Happeo 
    1. The info type should be set to Text
    2. The visibility should be set to Visible to organization
    3. The number of values should be set to Single or Multiple valueCustom_User_Attributes_2.png
  4. By completing the previous steps, a user or administrator is then able to edit newly created fields
    1. For instance, if you navigate back to here
    2. Click on your user profile
    3. Click on the downward arrow on the right side of User information
    4. And scroll down until you see your recently created custom attribute
    5. You can click on the pencil / edit symbol on the right side of it (it will appear once you hover over it)
    6. And you can write whatever you like in the field
  5. After Happeo synchronizes with Google Workspace, the custom attributes become searchable and available on the user’s card. Moreover, the name of the schema becomes the section title

How to create a custom attribute in Okta

From the Dashboard in Okta, click on Directory from the navigation menu and Profile editor

Custom_User_Attributes_3.png

From the Users tab, select the Happeo App (by clicking on the application name).

Then, click on Add attribute

  • Data type – Set to string
  • Display name – The label you wish to display (e.g. skills, hobbies, favorite music genre, etc.)
  • Variable name – This is used to refer to the attribute in profile mappings and expressions (e.g. skills, hobbies, etc.)
  • External namespace – Fill in as: urn:ietf:params:scim:schemas:extension:happeo:2.0:User
  • Description – A description of the label you are displaying (e.g. the user’s skills)
  • Enum – Needs to be checked if there are only predefined fields that users can choose from (e.g. Monday, Tuesday….Sunday)
  • Attribute length – The customizable length of an attribute
  • Attribute required – Needs to be checked when creating a user or a group
  • Scope – Check the box User personal

Custom_User_Attributes_4.png

After filling in the necessary information, you can click on Save

On the Profile editor page, you can scroll down the Attributes list to find the new attribute you created.

Custom_User_Attributes_5.png

To add the attribute to your Happeo environment, click on Mappings under the Attributes tab. 

Custom_User_Attributes_6.png

Then, click on Okta User to Happeo, scroll down and click on Choose an attribute or enter an expression. You can then add the mapping related to the attribute you created.

Custom_User_Attributes_7.png

Make sure to preview the mapping to ensure that it maps properly. You can do this by entering an Okta user in the Preview field at the bottom of the page. 

Once everything looks good, you can click on Save Mappings

Custom_User_Attributes_3.png

Custom_User_Attributes_8.png

If users are already assigned to the Happeo app, we should receive an update from Okta as soon as you start adding values to the new attribute.

If they are not assigned to the app, we would get the whole user profile together with the custom attribute when this is synched in Happeo.

Once the users have been updated, you can find the new attributes under the Additional Info tab in the User Card. 

Custom_User_Attributes_4.png

Custom_User_Attributes_9.png

How to create a custom attribute in Azure AD

First, open your Azure Active Directory portal.

If your custom user attribute is not yet present in the User profile, then you can go to:

  1. External Identities
  2. Custom user attributes
  3. And click on Add

Custom_User_Attributes_10.png

Then, navigate to Enterprise Applications, open the Provisioning tab of the Happeo Enterprise Application, and click on Edit provisioning.

Custom_User_Attributes_11.png

From there, you can create a new custom attribute with happeo attributes naming: 

Custom_User_Attributes_5.png

Then, you can add the new Attribute Mappings to the previously created attribute.

Custom_User_Attributes_12.png

Custom_User_Attributes_13.png

Once the users have been updated, you can find the new attributes under the Additional Info tab in the User Card. 

Custom_User_Attributes_6.png

 

Previous
Next
8044551594129