{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":40534,"path":"platform-security/authentication/external-user-configuration.md","title":"Configure a user registration configuration for external users","bundle":null,"doc_type":null,"release":"australia","body":"\n# Configure a user registration configuration for external users\n\nCreate 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.\n\n## Before you begin\n\n-   Role required: external\\_user\\_self\\_registration\\_admin\n-   [Activate External User Self-Registration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-security/authentication/external-user-registration-plugin.md)\n\n## Procedure\n\n1.  Navigate to **All** &gt; **External User Self-Registration** &gt; **User Registration Configurations** and click **New**.\n\n2.  On the form, fill in the fields.\n\n<table id=\"table_nxl_s1m_nlb\"><thead><tr><th>\n\nField\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nName\n\n</td><td>\n\nName of the registration form. For example, a student parking registration might be Parking Management Students.\n\n</td></tr><tr><td>\n\nRoles assigned to provisioned users\n\n</td><td>\n\nRoles 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.\n\n</td></tr><tr><td>\n\nEnable terms and conditions\n\n</td><td>\n\nOption to add a terms and conditions URL to the registration page.\n\n</td></tr><tr><td>\n\nTerms and conditions URL\n\n</td><td>\n\nThe publicly accessible URL which contains the terms and conditions of the registration form. This field appears only when **Enable terms and conditions** is selected.\n\n</td></tr><tr><td>\n\nDescription\n\n</td><td>\n\nThe 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.\n\n</td></tr><tr><td>\n\nApplication\n\n</td><td>\n\nApplication containing this record. The application is automatically set to `Global`.\n\n</td></tr><tr><td>\n\nActive\n\n</td><td>\n\nOption which makes the user registration configuration active. This option is selected by default.\n\n</td></tr><tr><td>\n\nEnable CAPTCHA\n\n</td><td>\n\nOption 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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-security/authentication/configure-recaptcha-sp.md).\n\n</td></tr></tbody>\n</table>3.  Click **Submit**.\n\n    A user registration configuration with the default settings is created.\n\n    \\[Omitted image \"user-registration-configuration.png\"\\] Alt text: User Registration Configuration form\n\n4.  Configure the **Registration** tab to show fields and the order that they appear:\n\n    |Column|Description|\n    |------|-----------|\n    |Display in Registration Form|Set any field you want to display as `True`.|\n    |Order|Set an order number to display fields on your form.|\n    |Mandatory|Set any field you want to make it mandatory as `True`.|\n    |Validation only field|Set any field you want to use only for validation. For example, registration code.|\n\n    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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-security/authentication/default-reg-form-fields.md).\n\n    \\[Omitted image \"registration\\_tab\\_EU\\_self-registration.png\"\\] Alt text: Registration tab of User Registration Configuration\n\n    You can also add custom registration form fields. For more information, see [Add a custom registration form field](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-security/authentication/add-custom-reg-form-field.md).\n\n5.  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.\n\n<table id=\"table_bwt_ckb_vlb\"><thead><tr><th>\n\nField\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nRequires user verification\n\n</td><td>\n\nOption to trigger a user verification subflow which runs after user registration. The subflow is for user identity verification.\n\n</td></tr><tr><td>\n\nUser verification flow\n\n</td><td>\n\nThe 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, see[Flow Designer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/application-development/flow-designer.md) .\n\n **Note:** To preview the **External User Verification** subflow in a new tab use the following shortcuts:\n\n-   Macintosh: Command + Click\n-   Windows: Control + Click\n\n\n</td></tr><tr><td>\n\nActivation link expiry time \\(in hours\\)\n\n</td><td>\n\nThe number of hours after which an activation link expires. The default value is 24.\n\n</td></tr></tbody>\n</table>    \\[Omitted image \"verf\\_tab\\_EU\\_self-reg.png\"\\] Alt text: Verification tab of User Registration Configuration\n\n6.  Configure the **Transformation** tab to map self-registered users and activated users.\n\n    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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/integrate-applications/c_CreatingNewTransformMaps.md).\n\n    \\[Omitted image \"transf\\_tab\\_eu\\_self-reg.png\"\\] Alt text: Transformation tab of User Registration Configuration\n\n7.  Configure the **Onboarding** tab to trigger subflows for onboarding activated users.\n\n    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.\n\n    **Note:** When the **External User Onboarding** subflow triggers, the subflow sends an email to the user that contains a link to reset the password.\n\n    \\[Omitted image \"onboard\\_tab\\_eu\\_self-reg.png\"\\] Alt text: Onboarding tab of User Registration Configuration\n\n8.  Configure the **Advanced** tab to map user tables and redirection pages of the registration form.\n\n    \\[Omitted image \"advanced\\_tab\\_eu\\_self-reg.png\"\\] Alt text: Advanced tab of User Registration Configuration\n\n    |Field|Description|\n    |-----|-----------|\n    |Registration table|Name of the table where registration form information is saved.|\n    |Registration form field configuration|The record associated to the registration form in the Record Producer.|\n    |Activation table|Label and name of the table used for user activation. The activation table contains records of the users who have completed verification.|\n    |User table|Label and name of the user profile table.|\n    |Activation success page|The page to which a user redirects after the activation is successful.|\n    |Activation error page|The page to which a user redirects when the activation fails.|\n    |Post registration redirect page|The page to which user is redirected after registration.|\n    |Registration link label|The button name used for registration from the service portal. The default value is Register.|\n\n    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.\n\n\n"}}