Configuring a user registration configuration for external users
- UpdatedJan 30, 2025
- 5 minutes to read
- Yokohama
- Platform Security
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.
Before you begin
- Role required: admin
- Activating External User Self-Registration
Procedure
- Navigate to All > External User Self-Registration > User Registration Configurations and click New.
-
On the form, fill in the fields.
Table 1. User registration configuration form Field Description Name Name of the registration form. For example, a student parking registration might be Parking Management Students. Roles assigned to provisioned users 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. Enable terms and conditions Option to add a terms and conditions URL to the registration page. Terms and conditions URL The publicly accessible URL which contains the terms and conditions of the registration form. This field appears only when Enable terms and conditions is selected. Description 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. Note: You can only add a description after you save or update a user registration configuration.Application Application containing this record. The application is automatically set to Global. Active Option which makes the user registration configuration active. This option is selected by default. Enable CAPTCHA Option to add a CAPTCHA to the registration form. The default CAPTCHA provider is Google reCAPTCHA. Note: To enable CAPTCHA for user registration, follow the steps in Configure Google reCAPTCHA for external user self-registration. -
Click Submit.
A user registration configuration with the default settings is created.
- (Optional)
Configure the Registration tab to show fields and the
order that they appear:
Table 2. Registration Form Fields Column Description Display in Registration Form Set any field you want to display as True. Order Set an order number to display fields on your form. Mandatory Set any field you want to make it mandatory as True. Validation only field Set any field you want to use only for validation. For example, registration code. You can choose to display the default form fields or you can add custom form fields to the Registration Form. For more information, see Default registration form fields.
Figure 1. Registration tab You can also add custom registration form fields. For more information, see Add a custom registration form field.
- (Optional)
Configure
the Verification 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.
Table 3. Verification tab fields Field Description Requires user verification Option to trigger a user verification subflow which runs after user registration. The subflow is for user identity verification. User verification flow The subflow used to verify the identity of the user. The subflow triggers only when you enable user verification. The External User Verification subflow is available by default. You can create a copy of the default subflow in Workflow Studio and modify it according to your requirements. For more information, seeFlow Designer .
Note: To preview the External User Verification subflow in a new tab use the following shortcuts:- Macintosh: Command + Click
- Windows: Control + Click
Activation link expiry time (in hours) The number of hours after which an activation link expires. The default value is 24. Figure 2. Verification tab - (Optional)
Configure the Transformation tab to map self-registered
users and activated users.
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 Transform maps.
Figure 3. Transformation tab -
Configure the Onboarding tab to trigger subflows for
onboarding activated users.
The default External User Onboarding 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.Note: When the External User Onboarding subflow triggers, the subflow sends an email to the user that contains a link to reset the password.
Figure 4. Onboarding tab - (Optional)
Configure the Advanced tab to map user tables and
redirection pages of the registration form.
Figure 5. Advanced tab Table 4. Advanced tab Field Description Registration table Name of the table where registration form information is saved. Registration form field configuration The record associated to the registration form in the Record Producer. Activation table Label and name of the table used for user activation. The activation table contains records of the users who have completed verification. User table Label and name of the user profile table. Activation success page The page to which a user redirects after the activation is successful. Activation error page The page to which a user redirects when the activation fails. Post registration redirect page The page to which user is redirected after registration. Registration link label The button name used for registration from the service portal. The default value is Register. While making changes or after completing all changes in the user registration configuration, you can use the Preview Registration Form button to preview changes in the registration form.
Figure 6. Registration Form Preview