...
The following instructions provide information on setting up a Security Group in the Profile System, creating a Security component that includes the group, and applying the security to a site or structure group in Tridion.
Table of Contents
Table of Contents | ||
---|---|---|
|
Setting up a Security Group in the Profile System
The first step in creating External User Security for a site or structure group is to set up a Security Group in the Profile System. Security Groups belong to a organization and are editable by any user with organization administrator access to the organization.
Visit https://profile.yale.edu
Log in with your NetID and password
Click
Organizations
in the navigation at the top of the page.Find and select the organization you want to add the Security Group to.
Click the
External User Security
button in the navigation on the left side of the page.
You will be taken to the External User Security page (shown below):
...
From the External User Security page, click Add New...
(highlighted in yellow above), and some fields will pop up to add information for the group (shown below):
...
In the Name field, type in an appropriate name for the Security Group
This is the name you will plug into the Tridion Security component.
If the name of the group already exists, you will see an error message. If not, the field will let you know the name is unique (shown above).
In the Description field, type in a summary of what the Security Group is for.
Click
Add New...
in the Guest Users field (highlighted in yellow above) to begin adding external users to the group.
Note |
---|
Only use alphanumeric characters and spaces in the Name field. |
...
There are 2 options for adding a Guest User to a Security Group.
Adding existing Guest Users
This will probably only happen if you’ve previously added this user to a different Security Group.
To add an existing Guest User, type their name into the Find Existing Guest User field (highlighted in yellow above) and click on it.
Their information will populate into the fields below, and you can click
Add
(highlighted in green above) to add them to the group.
Creating new Guest Users
Name: Enter the user’s name in the Name field (highlighted in blue above).
Email: Enter the email of the external user you want to add (highlighted in red above).
Click
Add
(highlighted in green above) to add the create the user and add them to the security Group.
Once you have finished adding External Users to the Security Group, click Add
to save the group, and you are ready to create a Security component in Tridion using the group.
...
From this e-mail, the user should click the provided link (highlighted in yellow above) to set up their account and password. They will then be able to access YSM publications and systems that are secured with Auth0 and External User Security.
Creating a Security Component
The next step in securing a site or structure group for external users is to create a Security component in Tridion.
...
Creating a Security: CAS component.
...
Enter an appropriate Name for your component.
Choose
Security: CAS
from the Schema drop down menu(highlighted in yellow above).Allow the following groups access: This field allows you to select the type of security and enter the information for who gets access.
Select the radio button next to
External Role
(highlighted in orange above) to use the External Security Group you created in the last section.
In the Values field, enter the Name of the External Security Group.
The easiest way to do this is by copying and pasting from the Name field of the security group you created in https://profile.yale.edu/
You can add, delete, or sort Values with the icons to the left of the field (highlighted in red above).
Info |
---|
If you will be using multiple Security Types within this single Security component (for example, NetID and External User Security) it is crucial to use the furthest left green |
...
Once you've finished inserting your Security Types and coordinating Values, click Save and Close
(highlighted in blue above) in the Home tab, and the component is ready to be inserted onto a page in your Root folder
Applying Security to a Structure Group
Once you’ve created a Security component, you are ready to apply that Security to a structure group.
...
Creating a Security page.
...
Within the Structure Group you would like to secure, create a
New Page
, and start with the General tab.The Name of this new page should be "Security."
The File Name must be "security" (lowercase, no spaces).
Below Page Template, uncheck the box next to
Inherit from Parent
(highlighted in yellow above).Select
XML
from the Page Template dropdown (highlighted in blue above).Click on the
Component Presentations
tab of your page (highlighted in green above).In the Component Presentations tab of your page, click
Insert
.Your Building Blocks folder will pop up, select the security component you just created.
Select
Security: CAS
in the Component Template drop down menu.Click
Insert
to add the component to the page.Click
Save and Close
, then publish the page.