<h2>Configuring a user registration configuration for external users</h2><br/><div style="overflow-x:auto"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head><meta content="text/html; charset=UTF-8" /><meta name="copyright" content="(C) Copyright 2025" /><meta name="DC.rights.owner" content="(C) Copyright 2025" /><meta name="generator" content="DITA-OT" /><meta name="DC.type" content="task" /><meta name="DC.title" content="Configuring a user registration configuration for external users" /><meta name="abstract" content="Create a user registration configuration record to bootstrap the onboarding process of external users to custom ServiceNow applications. This form guides the external users through the self-registration process." /><meta name="description" content="Create a user registration configuration record to bootstrap the onboarding process of external users to custom ServiceNow applications. This form guides the external users through the self-registration process." /><meta name="DC.creator" content="ServiceNow" /><meta name="DC.date.created" content="2023-08-03" /><meta name="DC.date.modified" content="2024-02-01" /><meta name="DC.format" content="XHTML" /><meta name="DC.identifier" content="external-user-configuration" /><link rel="stylesheet" type="text/css" href="../../../CSS/commonltr.css" /><title>Configuring a user registration configuration for external users</title></head><body id="external-user-configuration"> <h1 class="title topictitle1" id="ariaid-title1">Configuring a user registration configuration for external users</h1> <div class="body taskbody"><p class="shortdesc">Create a user registration configuration record to bootstrap the onboarding process of external users to custom <span class="ph">ServiceNow</span> applications. This form guides the external users through the self-registration process.</p> <div class="section prereq p"> <ul class="ul" id="external-user-configuration__ul_yzf_zqn_gmb"><li class="li">Role required: admin</li><li class="li"><a class="xref" href="external-user-registration-plugin.html" title="You can activate the External User Self-Registration plugin (com.snc.external_user_self_registration) if you have the admin role.">Activating External User Self-Registration</a></li></ul> </div> <ol class="ol steps"><li class="li step stepexpand"> <span class="ph cmd">Navigate to <span class="ph menucascade"><span class="ph uicontrol">All</span> > <span class="ph uicontrol">External User Self-Registration</span> > <span class="ph uicontrol">User Registration Configurations</span></span> and click <span class="ph uicontrol">New</span>.</span> </li><li class="li step stepexpand"> <span class="ph cmd">On the form, fill in the fields.</span> <div class="itemgroup info"> <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="external-user-configuration__table_nxl_s1m_nlb" class="table" frame="border" border="1" rules="all"><caption><span class="tablecap"><span class="table--title-label">Table 1. </span>User registration configuration form</span></caption><colgroup><col style="width:25%" /><col style="width:75%" /></colgroup><thead class="thead" style="text-align:left;"><tr class="row"><th class="entry cellrowborder" style="vertical-align:top;" id="d234666e104">Field</th><th class="entry cellrowborder" style="vertical-align:top;" id="d234666e107">Description</th></tr></thead><tbody class="tbody"><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e104 ">Name</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e107 ">Name of the registration form. For example, a student parking registration might be Parking Management Students.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e104 ">Roles assigned to provisioned users</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e107 ">Roles assigned to the provisioned users. The specified roles have to extend or contains the snc_external role. The specified role can also be snc_external role. For external users, each role must have an snc_external to notate an external user. If you have pre-configured roles, the roles should be accessible when you unlock the roles and search for users.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e104 ">Enable terms and conditions</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e107 ">Option to add a terms and conditions URL to the registration page.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e104 ">Terms and conditions URL</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e107 ">The publicly accessible URL which contains the terms and conditions of the registration form. This field appears only when <span class="ph uicontrol">Enable terms and conditions</span> is selected.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e104 ">Description</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e107 ">The description of the registration form. This field appears only when you save or submit the configuration. You can add more information about the registration form in this field.<div class="note"><span class="notetitle">Note:</span> You can only add a description after you save or update a user registration configuration.</div> </td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e104 ">Application</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e107 ">Application containing this record. The application is automatically set to Global.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e104 ">Active</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e107 ">Option which makes the user registration configuration active. This option is selected by default.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e104 ">Enable CAPTCHA</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e107 ">Option to add a CAPTCHA to the registration form. The default CAPTCHA provider is Google reCAPTCHA.<div class="note"><span class="notetitle">Note:</span> To enable CAPTCHA for user registration, follow the steps in <a class="xref" href="configure-recaptcha-sp.html" title="To use the Google reCAPTCHA service, you must request an API key pair from Google and then configure the related system properties.">Configure Google reCAPTCHA for external user self-registration</a>.</div> </td></tr></tbody></table> </div> </div> </li><li class="li step stepexpand"> <span class="ph cmd">Click <span class="ph uicontrol">Submit</span>.</span> <div class="itemgroup stepresult">A user registration configuration with the default settings is created. <br /><img class="image" id="external-user-configuration__image_fmg_kfr_dlb" src="../images/user-registration-configuration.png" alt="User Registration Configuration form" /><br /> </div> </li><li class="li step stepexpand"><strong>Optional: </strong> <span class="ph cmd">Configure the <span class="ph uicontrol">Registration</span> tab to show fields and the order that they appear:</span> <div class="itemgroup info"> <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="external-user-configuration__table_wrf_vxn_gmb" class="table" frame="border" border="1" rules="all"><caption><span class="tablecap"><span class="table--title-label">Table 2. </span>Registration Form Fields</span></caption><colgroup><col style="width:50%" /><col style="width:50%" /></colgroup><thead class="thead" style="text-align:left;"><tr class="row"><th class="entry cellrowborder" style="vertical-align:top;" id="d234666e270">Column</th><th class="entry cellrowborder" style="vertical-align:top;" id="d234666e273">Description</th></tr></thead><tbody class="tbody"><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e270 ">Display in Registration Form</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e273 ">Set any field you want to display as True.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e270 ">Order</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e273 ">Set an order number to display fields on your form.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e270 ">Mandatory</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e273 ">Set any field you want to make it mandatory as True.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e270 ">Validation only field</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e273 ">Set any field you want to use only for validation. For example, registration code.</td></tr></tbody></table> </div> <p class="p" id="external-user-configuration__p_v5r_13f_dtb">You can choose to display the default form fields or you can add custom form fields to the Registration Form. For more information, see <a class="xref" href="../reference/default-reg-form-fields.html" title="You can use the default registration form fields or create custom registration form fields.">Default registration form fields</a>.</p> <div class="fig fignone" id="external-user-configuration__fig_lnv_dvv_llb"> <div class="p"><div class="fig fignone" id="external-user-configuration__fig_ohy_lwv_llb"><span class="figcap"><span class="fig--title-label">Figure 1. </span>Registration tab</span> <img class="image" id="external-user-configuration__image_phy_lwv_llb" src="../images/registration_tab_EU_self-registration.png" alt="Registration tab of User Registration Configuration" /> </div> </div> </div> <p class="p">You can also add custom registration form fields. For more information, see <a class="xref" href="add-custom-reg-form-field.html" title="You can add custom fields in the user self-registration form.">Add a custom registration form field</a>.</p> </div> </li><li class="li step stepexpand"><strong>Optional: </strong> <span class="ph cmd">Configure the <span class="ph uicontrol">Verification</span> tab to verify the identity of the registered users. When the user verification flow triggers, an activation link is sent to the user's registered email address.</span> <div class="itemgroup info"> <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="external-user-configuration__table_bwt_ckb_vlb" class="table" frame="border" border="1" rules="all"><caption><span class="tablecap"><span class="table--title-label">Table 3. </span>Verification tab fields</span></caption><colgroup><col style="width:50%" /><col style="width:50%" /></colgroup><thead class="thead" style="text-align:left;"><tr class="row"><th class="entry cellrowborder" style="vertical-align:top;" id="d234666e391">Field</th><th class="entry cellrowborder" style="vertical-align:top;" id="d234666e394">Description</th></tr></thead><tbody class="tbody"><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e391 ">Requires user verification</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e394 ">Option to trigger a user verification subflow which runs after user registration. The subflow is for user identity verification.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e391 ">User verification flow</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e394 ">The subflow used to verify the identity of the user. The subflow triggers only when you enable user verification.<p class="p">The <span class="ph uicontrol">External User Verification</span> subflow is available by default. You can create a copy of the default subflow in <span class="ph">Flow Designer</span> and modify it according to your requirements. For more information, see <a class="xref" href="../administer/flow-designer/concept/flow-designer.dita/flow-designer.html" target="_blank" rel="noopener noreferrer">Flow Designer</a>.</p> <div class="note"><span class="notetitle">Note:</span> To preview the <span class="ph uicontrol">External User Verification</span> subflow in a new tab use the following shortcuts:<ul class="ul" id="external-user-configuration__ul_yyf_1h5_gmb"><li class="li">Macintosh: Command + Click</li><li class="li">Windows: Control + Click</li></ul> </div> </td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e391 ">Activation link expiry time (in hours)</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e394 ">The number of hours after which an activation link expires. The default value is 24.</td></tr></tbody></table> </div> <div class="fig fignone" id="external-user-configuration__fig_f3f_pzr_mlb"><span class="figcap"><span class="fig--title-label">Figure 2. </span>Verification tab</span> <img class="image" id="external-user-configuration__image_fwh_kbs_mlb" src="../images/verf_tab_EU_self-reg.png" alt="Verification tab of User Registration Configuration" /> </div> </div> </li><li class="li step stepexpand"><strong>Optional: </strong> <span class="ph cmd">Configure the <span class="ph uicontrol">Transformation</span> tab to map self-registered users and activated users.</span> <div class="itemgroup info">There are two transformation maps (u_reg_xmap_[number]) which automatically map the registered users from the User Acti Req [number] table to the Self Registered User [number] table. You can create a copy of these default transformation maps and modify the map according to your requirements. For more information, see <a class="xref" href="../script/server-scripting/concept/c_CreatingNewTransformMaps.dita/c_CreatingNewTransformMaps.html" target="_blank" rel="noopener noreferrer">Transform maps</a>.<div class="fig fignone" id="external-user-configuration__fig_ggv_xwt_mlb"><span class="figcap"><span class="fig--title-label">Figure 3. </span>Transformation tab</span> <img class="image" id="external-user-configuration__image_trc_yxt_mlb" src="../images/transf_tab_eu_self-reg.png" alt="Transformation tab of User Registration Configuration" /> </div> </div> </li><li class="li step stepexpand"> <span class="ph cmd">Configure the <span class="ph uicontrol">Onboarding</span> tab to trigger subflows for onboarding activated users.</span> <div class="itemgroup info">The default <span class="ph uicontrol">External User Onboarding</span> subflow sends an email to the user that contains a link to reset their password. You can create a copy of the default subflow and modify it according to your requirements. <div class="note"><span class="notetitle">Note:</span> When the <span class="ph uicontrol">External User Onboarding</span> subflow triggers, the subflow sends an email to the user that contains a link to reset the password.</div> <div class="fig fignone" id="external-user-configuration__fig_qst_b4g_nlb"><span class="figcap"><span class="fig--title-label">Figure 4. </span>Onboarding tab</span> <img class="image" id="external-user-configuration__image_pzq_kpg_nlb" src="../images/onboard_tab_eu_self-reg.png" alt="Onboarding tab of User Registration Configuration" /> </div> </div> </li><li class="li step stepexpand"><strong>Optional: </strong> <span class="ph cmd">Configure the <span class="ph uicontrol">Advanced</span> tab to map user tables and redirection pages of the registration form.</span> <div class="itemgroup info"> <div class="fig fignone" id="external-user-configuration__fig_tks_gl3_nlb"><span class="figcap"><span class="fig--title-label">Figure 5. </span>Advanced tab</span> <img class="image" id="external-user-configuration__image_zrl_jl3_nlb" src="../images/advanced_tab_eu_self-reg.png" alt="Advanced tab of User Registration Configuration" /> </div> <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="external-user-configuration__table_oxz_sqd_tlb" class="table" frame="border" border="1" rules="all"><caption><span class="tablecap"><span class="table--title-label">Table 4. </span>Advanced tab</span></caption><colgroup><col style="width:50%" /><col style="width:50%" /></colgroup><thead class="thead" style="text-align:left;"><tr class="row"><th class="entry cellrowborder" style="vertical-align:top;" id="d234666e586">Field</th><th class="entry cellrowborder" style="vertical-align:top;" id="d234666e589">Description</th></tr></thead><tbody class="tbody"><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e586 ">Registration table</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e589 ">Name of the table where registration form information is saved.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e586 ">Registration form field configuration</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e589 ">The record associated to the registration form in the Record Producer.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e586 ">Activation table</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e589 ">Label and name of the table used for user activation. The activation table contains records of the users who have completed verification.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e586 ">User table</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e589 ">Label and name of the user profile table.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e586 ">Activation success page</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e589 ">The page to which a user redirects after the activation is successful.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e586 ">Activation error page</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e589 ">The page to which a user redirects when the activation fails.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e586 ">Post registration redirect page</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e589 ">The page to which user is redirected after registration.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e586 ">Registration link label</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d234666e589 ">The button name used for registration from the service portal. The default value is Register.</td></tr></tbody></table> </div> <p class="p">While making changes or after completing all changes in the user registration configuration, you can use the <span class="ph uicontrol">Preview Registration Form</span> button to preview changes in the registration form.</p> <div class="fig fignone" id="external-user-configuration__fig_rxn_f35_gmb"><span class="figcap"><span class="fig--title-label">Figure 6. </span>Registration Form Preview</span> <img class="image" id="external-user-configuration__image_skv_tnv_gmb" src="../images/preview_registration_form.png" alt="Registration Form Preview" /> </div> </div> </li></ol> </div> </body></html></div>