Using RBAC to organize and manage access to case attachments

4 Tasks

30 mins

Pega Platform 8.7 (English)

Pega Platform '24.2 Pega Platform '23 (English) Pega Platform '23 (日本語) Pega Platform 8.8 Pega Platform 8.7 (日本語) Pega Platform 8.7 (Español) Pega Platform 8.6 (English) Pega Platform 8.6 (日本語) Pega Platform 8.5

Visible to: All users

Intermediate Pega Platform 8.7 Security English

Scenario

Applicants for an open position at TGB must submit a resume as part of the application process. To ensure the security of resumes attached to a candidate case, resumes must only be accessible by recruiters and HR members.

• Create a privilege for the User and Recruiter. 
• Apply privileges to respective access roles.
• Create an attachment category to manage resumes.
• Add attachment section in the user interface.

The following table provides the credentials you need to complete the challenge.

Role	User name	Password
Senior System Architect	SSA@TGB	pega123!
User	User@TGB	pega123!
Recruiter	Recruiter@TGB	pega123!

You must initiate your own Pega instance to complete this Challenge.

Initialization may take up to 5 minutes so please be patient.

• Log In

Challenge Walkthrough

Detailed Tasks

1 Create a Privilege for User and Recruiter

1. Login with user name SSA@TGB.
2. In the header of Dev Studio, click Create > Security > Privilege to create the privilege.
3. In the Label field, enter User.
4. In the Context section, in the Apply to field, enter or select TGB-HRApps-Work-Candidate, and select the highest available unlocked ruleset version.
5. Save the privilege.
6. Repeat steps 2-5 to create a privilege named Recruiter.

2 Apply the privilege to the access role

1. In the navigation pane of Dev Studio, click Records > Security > Access Role Name to open the instances of the Access Role Name.
2. Click on HRApps:User to open the existing User access role. 
3. Save a copy of the access role name into the highest available unlocked ruleset version.
4. On the Role tab, click the Add a row icon to add a new access role.
5. In the Add access Role Object window, in the Class field enter or select TGB-HRApps-Work-Candidate.
   
6. In the Access Controls section, enter 5 in all access controls fields.
   
   Note: Entering 5 in all fields provides full access to the User access role.
7. In the Privileges section, in the Name field enter or select the User privilege, and in the Level field enter 5.
   
8. Click Save to save and dismiss the Add access Role Object window.
9. Save and check in the Access Role. 
10. Repeat steps 2-9  to add Recruiter privilege to the HRApps:Recruiter access role with the access control details as shown in the following image or table.

    Fields	Values
    Read instances	5
    Write instances	5
    Delete instances	0
    Read rules	5
    Write rules	0
    Delete rules	0
    Execute reports	5
    Execute activities	5
    Name	Recruiter
    Level	5

    

3 Create Resume attachment category

1. In the App Explorer, right-click Candidate and select Create > Process > Attachment Category.
2. In the Label field, enter Resume.
3. Click Create and open.
4. On the Security tab, in the Access control list by privilege section, add the User and Recruiter privileges.
5. In the User privilege row, select the Create, Edit, View, Delete own, and Delete any check boxes.
6. In the Recruiter privilege row, select the View check box.
   
7. On the Availability tab, clear all check boxes and select the File check box.
   
8. Click Save to save the attachment category.

4 Add attachment button to the user interface

1. In the App Explorer, open the CollectProfessionalDetails_0 section.
2. Save a copy of the section into the highest available unlocked ruleset version.
3. Add a Dynamic layout under the Embedded section. 
4. Add the Attach content control into the newly added dynamic layout.
5. Next to Attach content, click the View properties icon to open the cell properties window.
6. In the Cell Properties window, on the General tab, in the Button caption list, select Text.
7. In the Text field, enter Attach Resume.
   
8. Click Submit to save and dismiss the cell properties window.
9. Save and check in your work.
10. Verify that you have no checked out records.
    

Confirm your work

1. Log in with user name User@TGB and create a candidate case.
2. Advance the case to the Collect Professional Details step.
3. Click Attach Resume to open the attachment overlay.
4. Select a sample resume file from your desktop.
5. In the Category field, select Resume.
6. Click Attach to attach the resume to the case.
   
7. Click Submit to complete the Collect Professional Details step.
8. Click Actions > Refresh to display attachments.
9. In the Files & documents section, click the More icon and verify that Download and Delete options are displayed.
   
10. Advance the case past the Submission stage to route the case to the RecruitingWB work queue in the Conduct phone screen step.
11. Save the candidate case ID to a text file for future reference.
12. Log out from the user portal.
13. Log in with user name Recruiter@TGB.
14. On the dashboard of the user portal, click on the circle in the Case volume gadget to access open cases.
15. Locate the case ID from step 7 and click it to open the case.
16. In the Files & documents section, click the More icon and verify that only the Download option is displayed.
    

---

This Challenge is to practice what you learned in the following Module:

• Access control v1

---

Available in the following mission:

• Senior System Architect v4