Creating the system notification user account

BMC Digital Workplace requires a service level user that runs background tasks such as pushing notifications to self-service users when BMC Digital Workplace Catalog requests are being processed. You must create the user account that will perform these actions, and provide the credentials for this user when you enable the enhanced catalog.

Assigning BMC Digital Workplace Catalog roles to user accounts

Before you begin

Review the information about user accounts and permissions as shown on Setting up user accounts and granting access to BMC Digital Workplace Catalog.

Review this topic thoroughly to determine whether you will be creating the default system notification user account or creating an account by providing your own information.

Best Practice

Create a unique system level account to configure the notifications for the enhanced catalog in BMC Digital Workplace.

Required information fields for the system notification user account

The following table shows an example of the fields used to create the system notification user. You should specify unique login credentials when creating the system notification user in your environment:

Field name	Key name	Examples
Full Name	fullName	System Notification Account
Login Name	loginName	sys_notification@calbroservices.com
Email Address	emailAddress	sys_notification@calbroservices.com
License Type	licenseType	Read
Group List	groups	sbe-myit-users Do not add the Administrator group to any users of the sbe-myit-users group.
Password	password	5Y5_n0tification!
Status	(Not used in scripts)	Current
(Not on user form)	forcePasswordChangeOnLogin	false

To create a system notification user account from the command line

On the BMC Digital Workplace Catalog server, go to installationLocation/sb/rxscripts/bin/users.

Open a text editor, and create a file that contains the required information for a single user as a JSON string.
Example: To create an account for Custom System Notifications, compose the following text file:

Example: System notification user

{
 "fullName": "Custom System Notifications",
 "loginName": "csn@${rx_tenant_domain}",
 "emailAddress": "csn@${rx_tenant_domain}",
 "licenseType": "Read",
 "groups": ["sbe-myit-users"],
 "forcePasswordChangeOnLogin": "false",
 "password": "%8*6x4=t2J_nR!ZQ"
}

Save the file to the /dwpCatalogInstallDir/sb/rxscripts/bin/users folder.
Example: csn.json
Run the command source ./bin/setenv.sh to load the environment variables into the current shell context.
Example
```
source ./bin/setenv.sh
```
Run the command ./bin/login.sh and pass the parameters to log in as the tenant administrator.
Example
```
./bin/login.sh hannah_admin@calbroservices.com Passw0rd!
```
Run the command ./bin/users/create.sh to load the specified JSON file to create the user account.
Example
```
./bin/users/create.sh ./csn.json
```
The system notifies you when the account is successfully created or if the process failed.

For a detailed explanation of this procedure, see Creating user accounts in a batch by using shell scripts.

To create a custom system notification user account by using Remedy Mid Tier

After you configure a Remedy Mid Tier to access the BMC Digital Workplace Catalog server, you can create a custom system notification user account by adding the record directly into the tenant User form. To integrate a Remedy Mid Tier with BMC Helix Digital Workplace Catalog and read an example of this integration, see Setting up a Remedy Mid Tier for system administration of the BMC Digital Workplace Catalog server.

Edit the values in the following URL to match your server environment, and open the URL in a web browser to open Remedy Mid Tier to access the User form on the BMC Digital Workplace Catalog server.
Example URL
```
http://<server_with_midtier>:8080/arsys/forms/<digitalworkplace_catalog-sample.com>/User
```
Log in as a service catalog administrator.
Example:
- User: hannah_admin@calbroservices.com
- Password: Passw0rd!
Click New request.
Enter the information for the user record.
Example: To create a self-service request user account for Custom System Notifications, complete the following fields:
Field name Example
Full Name Custom System Notifications
Login Name csn
Email Address csn@calbroservices.com
License Type Read
Group List sbe-myit-users
Password %8*6x4=t2J_nR!ZQ
Status Current
Click Save to create the user account.
When you are finished managing user accounts, log out of Remedy Mid Tier.

Where to go from here

You have completed the essential tasks for installing BMC Digital Workplace Catalog. Proceed to Configuring after installation of BMC Digital Workplace Catalog.

Field name	Example
Full Name	Custom System Notifications
Login Name	csn
Email Address	csn@calbroservices.com
License Type	Read
Group List	sbe-myit-users
Password	%8*6x4=t2J_nR!ZQ
Status	Current