Account Mapping

Account Mappings allows users to utilize default mapping rules for accounts and identities.

img
Account mapping page view

To filter the table view, use the checkboxes to enable/disable view options, like

  • Create Rules: These rules are used to create an identity if matches are found.
  • Mapping Rules: These rules map accounts to identities.
  • Default Rules: These are Hydden’s out of the box default rules, they can be viewed, but not edited.
  • Custom Rules: These are rules created on your tenant.

Use Search to trim the view down to a specific context.

Creating an Account/Identity Mapping Rule

  1. Navigate to Configuration | Identify and select the Account Mapping tab.

  2. Click + Add Rule.

    img
    Add Custom Account Mapping Rule modal

  3. Specify the Rule Priority. A higher number specifies a higher priority in the evaluation order. By default the modal opens with a value of 20.

  4. Enter a Name and Description for your rule for organizational clarity.

  5. From the Category field, select if it is an Account or Identity mapping rule.

  6. From the Match Account Using field, select if the mapping should happen via Primary Email or Display Name.

  7. Under the Account Matching Requirements section, specify

    1. An Account Classification if configured. This is an optional field.
    2. A RegEx Pattern to be match by the rule.
    3. A RegEx Replacement to be used in the rule.
  8. Use Test to verify your rule works as intended.

  9. Once you are ready to use the rule in your environment, check the Enable Rule checkbox at the top of the modal. The Actions column indicates if a custom rule is enabled or disabled. It will either have a checkmark for enabled or an x for disabled. You may change the state by clicking the x or checkmark to enable or disable a rule without entering the Edit Custom or View Default Account Mapping Rule modals.

    img
    Action column indicating custom rule status

    Note: Mapping rules must be enabled on each data source separately to be active.

  10. Click Add to save and add the rule to your environment.

Testing a RegEx Rule

RegEx testing is available via the Test button on the add or edit account rule mapping modal. Save the test if you want to keep it associated with the rule.

img
Test RegEx modal

If you have an account with a display name of Jane Doe-admin, a RegEx of (.)\s-\s*admin$, and a test string of Doe-admin, the test returns a match and maps under the value Doe.

Mapping Migration

Previously account mapping defaulted to the following rules:

  • If matches were found on the primary email and account UPN.

With the advanced Account Mapping Rules, Hydden delivers the following default account mapping and identity creation rules.

NOTE: To use any of these rules, they need to be enabled on the configured Data Sources.

Map Account Rules: 13Create Identity Rules: 12
Match Any Email AliasCreate Identity: Requires 2+ Accounts & a configured email
Match Exact Display NameCreate Identity: Requires 2+ Accounts & a configured Email & a space between names
Match Name: first lastCreate Identity: Requires 2+ Accounts & a configured email or UPN
Match Name: first middle lastCreate Identity: Requires 2+ Accounts & a configured Email or UPN & a space between names
Match Name: first.lastCreate Identity: Requires 2+ Accounts & a configured UPN
Match Name: firstinital.secondinitial.lastCreate Identity: Requires 2+ Accounts & a configured UPN & a space between names
Match Name: firstinitial lastCreate Identity: Requires email
Match Name: firstinitial secondinitial lastCreate Identity: Requires Email & a space between names
Match Name: firstinitial.lastCreate Identity: Requires email or UPN
Match Name: last firstCreate Identity: Requires Email or UPN & a space between names
Match Name: last.firstCreate Identity: Requires UPN
Match Primary EmailCreate Identity: Requires UPN & a space between names
Match UPN