User Overview
In the RTE Cockpit > User page, Admins have the ability to perform the following actions:
Search for Users
Edit Users (Email, Full Name, Role)
Action: Password Resets* and Delete
Create new Users**
*** IMPORTANT ***
*Password Reset action is only possible, by an Admin, when SSO is NOT enabled.
**When SSO is enabled; User creation, authentication, and actions like Password Resets are delegated and handled by the Identity Provider (IdP).
RTE Cockpit > Users page is accessible to Admins only.
Prerequisites for Users to Access PI Sessions
To access piplanning.io and see a PI Session, a User must be:
A member of a Team
That Team must be added to at least one PI Session
Roles
There are four User defined Roles in piplanning.io that determine a users permissions and the actions they are authorized to undertake. The Roles are:
Admin
PI Admin
Member
Observer
Admin
In addition to all the actions of the other roles below, the Admin also has comprehensive access and management rights to manage the following: ALM Connections, Billing, Settings, and access to manage SSO on Premium and Enterprise plans.
PI Admin
This role is designed for RTEs or Team Coaches with limited management access to manage Teams and PI Sessions. for the ARTs and Solution Trains on which they are assigned as "admin". Important: Users in the role of a PI Admin must be added as "admins" either to an ART or Solution Train. Please check out the PI Admin role article for detailed guidance.
Member
Active participant in PI sessions associated with their teams.
Observer
Read-only access to PI sessions. This is a Role for various stakeholders who benefit from the information communicated during PI events but do not actively participate in the Teams on each ART.
TIP: To efficiently grant multiple stakeholders outside the ART or Solution Trains, access to participate in PI Sessions, by design, it's optimal to create an Observer Team.
Create a Team named Stakeholders (or give it a similar more appropriate name).
Add Users with the Observer Role to this new [Observer] Team.
Add this new Observer Team into all relevant PI sessions, because they can then attend the PI session, and participate when the Team is added to the PI Session (tab #2 Teams).
Managing Users Natively in piplanning.io*
*The following instructions apply to piplanning.io when SSO is NOT enabled
Inviting new Users to piplanning.io
Create new User
Click the button Create new User
Enter Email Address
Provide the Full Name of the User
Select a radio button for the appropriate Role
Click Save
Create User page in RTE Cockpit > Users.
Note: Only available when SSO is NOT enabled.
Edit Users
Click the Edit button
Update Name and/or Role
See the team/s this user belongs to
Edit User page: edit the Email, Full Name, and Role.
Read Only field: Member of Teams.
Change Password*
Click the Action button
Click Change password
Type in new password and confirm
Share the new password with the user
*Change password popup is ONLY available when SSO is NOT enabled.
If SSO is enabled, the Identify Provider (IdP) manages User passwords resets.
Delete User
Click the Action button
Click Delete
Confirm Deletion
Delete this user popup.
Deleting a User will remove them from all associated Team assignments.
User Onboarding: Direct URL for User registration
On the User page you find a direct link to your piplanning.io Company instance (see image below). This is especially useful in case you have Single Sign-On (SSO) in place.
Place this URL on an intranet page or in email communication to Teams that will be participating in a PI Session.
Direct URL link to share with Users in your company so they can login to piplanning.io directly.
TIP: User Onboarding via Admin or PI Admins (RTEs): A great way to add new users, especially when you're setting up new Teams, is to directly invite new users on the Team management page.
N.B. Keep in mind you may need to update the Users Role afterwards only if their Role will not be the default Team Member Role.
Only Admins can update a Users Role.
PI Admins and Admins can invite new users to the Team.
Single Sign-On (SSO) for Authentication, On/Off Boarding Users
Single Sign-On (SSO): For stricter governance and compliance around User authentication please use SSO.
Using SSO also make the Users Onboarding and Off-boarding tasks easier for all corporate applications.
piplanning.io supports the SAML and OIDC protocols for SSO. Connect your Identity Provider (IdP) using either of these protocols and take advantage of the SSO option.
Note: SSO is only available on the Premium or Enterprise plans.