Manage custom properties for your profile

You may need to set custom properties in your profile service.

Why set custom properties?

Custom properties can be retrieved by any Genero application protected by the Genero Identity Provider (GIP). Starting the application sets an environment variable with the custom property value, where the name of the environment variable is the custom property name appended to "OIDC_", all in uppercase.

For example, if the custom property is "my_property", the environment variable becomes "OIDC_MY_PROPERTY". An application protected by the GIP can retrieve the value:
LET my_property = fgl_getenv("OIDC_MY_PROPERTY")
Tip: Use this same method to retrieve standard OIDC properties, such as OIDC_FAMILY_NAME or OIDC_GIVEN_NAME. For an additional example, see Retrieve the OpenID Connect user identifier.

Access your profile

Follow these steps to access the area of your profile to manage your custom properties.

  1. Log in to the ConsoleApp.
  2. Select Users > Update me.
  3. Click Profile.
    You can see the Properties section of the form. It provides five functions: Append, Copy, Update, Delete, and Delete all.
  4. Verify you have values in all required fields.
    Required fields are marked with an asterisk (*). These fields must contain values before you can add a property.

Add a custom property

If the property you need doesn't exist in the list, you can add the property.

You have already accessed your profile. Follow these steps to add a custom property to your user profile.

  1. Click Append.
  2. Enter the property Name and property Value in the provided fields.
  3. Click OK.

The custom property name-value pair are listed in your user profile custom properties list.

Copy a custom property

You have already accessed your profile. Follow these steps to copy and paste a custom property in your user profile.

  1. Select the row containing the property to copy.
  2. Click Copy.
    The row is duplicated, and a unique name has been provided for the copied property. The cursor is in the Name field, to allow you to easily edit the new property's name.
  3. When you have completed your edits, click OK.

The custom property name-value pair are listed in your user profile custom properties list.

Update a custom property

You have already accessed your profile. Follow these steps to update a custom property to your user profile.

  1. Select the row containing the property to update.
  2. Click Update.
    The property row becomes editable. The cursor is in the Value field, to allow you to easily edit the new property's value. You can switch to the Name field to edit the property name.
  3. When you have completed your edits, click OK.

The custom property name-value pair are listed in your user profile custom properties list.

Delete a custom property

You have already accessed your profile. Follow these steps to delete a custom property from your user profile.

  1. Select the row containing the property to delete.
  2. Click Delete.
  3. A dialog asks you to confirm the delete. Click Yes.

The custom property name-value pair are removed from your user profile custom properties list.

Delete all custom properties

You have already accessed your profile. Follow these steps to delete all custom properties from your user profile.

  1. Click Delete all.
  2. A dialog asks you to confirm the delete. Click Yes.

All custom property name-value pairs are removed from your user profile custom properties list.