SSO Application Launcher Guidance Document

Created by Timothy Lockwood, Modified on Thu, Jun 15, 2023 at 7:47 AM by Johnathon Garcia

To Access the Live Google Doc use this link - https://docs.google.com/document/d/1cSYgPoiDPblQ-xbclZ-CCNZlB_aZ_YkR_7Yw-5ewmxs/edit?usp=drive_link


SSO Application 

Launcher Guide




PED STARS Admin Team

PED NOVA Help Team

Public Education Department

Version 1.3


Purpose:

The purpose of this document is to guide you on how to use the SSO Application Launcher to access the applications as a user or a district manager. Currently we only have the STARS Unique ID (UID) system in the Application Launcher. Our team does have plans to expand this but currently this is the only system using the Application Launcher.

You must activate your account on this Self-Service Page before you login to the Application Launcher. Please see the Self Service Guidance Document on how to activate your account.

User Accounts types:

There are two different types of users in the Application Launcher:

  • District Manager User: This user is usually the District’s/Charter’s STARS Coordinator. This user has the ability to give access to any application in the Application Launcher. (Currently only UID).

  • Regular Users: A regular user can only login to the Application Launcher to access the application the District Manager gives permission for them to access. 

Account Set up:

WHOM to contact:

You will contact your District’s/Charter’s STARS Coordinator and ask that they submit the STARS Authorization Form to get you an account set up. 

Your STARS Coordinator will need to provide the below information in the authorization form:

  • STARS ID (Can be found by a user who has access to UID)

  • Email 

No other information will be needed. If any additional information is needed, the STARS Admin/NOVA Team will let the STARS Coordinator know. 

For any issues please contact the PED-STARS Admin Team PED-STARSAdmin@state.nm.us or Submit a Ticket with the PED-NOVA Help Team Submit Ticket

Regular User Guidance:

Step 1: SSO URL

Go to SSO Application Launcher URL https://zis.ped.state.nm.us/SSOAuthenticator/HostLogin

Step 2: Login

Once you get to the page, you will enter your login information:

  • Username: This will be your STARS ID number or your Email Address. You can use either one to log in to this page. 

    • If your email does not work please, contact the PED STARS Admin Team to make sure your correct email is associated with your account. 

  • Password: This area will be the password you set when activating your account on the Self-Service Page.

  • If you have not activated your account, please see the Self Service Guidance Document.

 

Step 3: Available Applications/Functions

Once you have logged in to the Application Launcher you will see the below options as a District Manager:

  • Assigned Application: The link will return you to this page to see what applications have been assigned to the user logged in.

  • Logout: This is the link used to log out of the SSO Application Launcher page.

  • In the bottom area, you will see all the applications you have the ability to access. 

    • If you do not see any applications, this means you have not been given access to any applications. (Contact your District Manager to give you access. If you are unsure who this person is, begin with your STARS Coordinator.)

District Manager User Guidance:

Step 1: SSO URL

Go to SSO Application Launcher URL https://zis.ped.state.nm.us/SSOAuthenticator/HostLogin)  

Step 2: Login

Once you get to the page, you will enter your login information:

  • Username: This will be your STARS ID number or your Email Address. You can use either one to log in to this page. 

    • If your email does not work please, contact the PED STARS Admin Team to make sure your correct email is associated with your account. 

  • Password: This area will be the password you set when activating your account on the Self-Service Page.

    • If you have not activated your account, please see the Self Service Guidance Document.

 

Step 3: Available Applications/Functions

Once you have logged in to the Application Launcher you will see the below options as a District Manager:

  • Assigned Application: The link will return you to this page to see what applications have been assigned to the user logged in.

  • Application Setup: This is the option used to give and remove access for users in your District/Charter. You will have two options.

    • Application List: (Used to see current users and remove access.)See Step 4 - 5 

    • Assign Apps to AD User: (Used to set up access for users. Can also remove access.)See Step 6 - 10

  • Logout: This is the link used to log out of the SSO Application Launcher page.

  • In the bottom area, you will see all the applications you have the ability to access. 

    • If you do not see any applications, this means you have not been given access to any applications. (Use Assign Apps to AD User to give account access.)


Step 4: View Users Per Application

As the District Manager, you will have the ability to see all applications in the SSO Application Launcher. You can also see who has access to what applications. (We currently only have the UID application.)

You must select your Group-Org Before you can see who has access. 

After you have selected your Group-Org, you can select the Manage button.

Step 5: Remove Users Per Application

You will be given a list of the users who have access to the select application to manage. You can then remove access for a user by clicking the red x button. You will then need to confirm the removal of the user. 


Step 6: Assign/Remove Access Per User

On the Assign Apps to AD user’s page, you will be able to give yourself and other users access to available applications.

You will begin by selecting a Group-Org to Manage. This is a drop down and in most cases you will have only one option.

After you have selected your Group-Org to Manage, you will want to click the Get Users button below it. This will get you a list of available users in your District/Charter. 

Step 7: Select User

Once you click the Get Users button, you will be able to use the Search for User option or the Enter User drop down box. These options allow you to find the user to give access to a user.

  • If you do not see a user on your list there are two possible reasons.

    • First, the user has not activated their account on the Self Service site. (Refer to Self Service Guidance Document) 

    • Second, the user has activated their account but was not added to the correct Org-Group by the PED STARS Admin Team. (Please contact the STARS Admin Team to verify the user is in the correct Org-Group).

Step 8a: Select Application

Once you have selected a user to give or remove access from, you can now select the application you wish to use for them. Once you select the Select Application dropdown you will have options to what application you want to give access to.

  • STARS Unique ID: This system will allow users to search, assign, or resolve possible matching STARS IDs for students and staff. 

  • Data Validation Dashboard: This system will allow users to view validations PED has set up to check your data for possible data quality issues. Currently we are focusing on Ed-Fi validations submitted via an Ed-Fi API.


Step 8b: Select Role Per Application

After the Application has been selected, you can select a Role to give the user. Below is an example of the UID application, each application will work very similarly. (See Application Roles section for Role definition.) 

(After selecting an Application, you can also remove access by clicking the Remove Application Button.)




Step 9: Assign District/Charter/School

Based on your Org-Group you selected, the Select Organization will automatically reflect the same Organization. 

The Box on the left tells you what sites are available to select.

The Box on the right tells you what sites the user has access.

Step 10: District vs School Level

You will select the sites by clicking on the locations you want to give access. You can then click the arrows in the middle to move locations back and forth. 

If you select the TypeCode = 01, this will give the user access to the full District/Charter and all locations.

If you select the TypeCode = 02, this will give the user access to that specific location only.

Once you have everyone set up with the correct location, you will click the Save Selection button in the middle.

The user is now set up with the application and should see the icon. The user may need to log out and log back in to see the application.

Application Roles:

STARS Unique ID Roles (UID):

Role Name

Definition

SchoolResCoord

This role will be used if a user needs access to 1 or more schools. This role can assign new IDs, only to the schools assigned.

DistSearchUser

This role will be used if a user needs access to search for STARS IDs only. This role cannot assign new IDs.

DistResCoord

This role will be used if a user needs access to an entire District/Charter. This role can assign new IDs to any school in their District/Charter.

StateResCoord

This role will be used at the PED state level to assign new IDs. This role is only for PED staff.

Data Validation Dashboard:

Role Name

Definition

School

This role will be used if a user needs access to 1 or more schools. They will be able to view validation errors only for the assigned schools.

DistrictSchool

This role will be used if a user needs access to the entire district. They will be able to view validation errors for all schools within the district assigned. The role can also drill down to school level validations as well.

District

This role will be used if a user needs access to the entire district. They will be able to view validation summaries for all schools within the district assigned. This role cannot drill down to individual schools. 

Change Log:

Version 1.0:

  • Document was created

Version 1.1:

  • Removed the steps from the Table of Contents. Also, added the other method of removing access as a District Manager. Also, moved Regular Users ahead of District Manager Users.

Version 1.2:

  • Moved to a Google Document. Re-created the cover page to work with Google Docs.

Version 1.3:

  • Included Instructions for adding the data validation dashboard.

Support Contact:

For assistance and questions, please contact the PED-STARS Admin Team: PED-STARSAdmin@state.nm.us 

or Submit a Ticket with the PED-NOVA Help Team Submit Ticket

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article