Set up Minga in Skyward prior to inputting API details into Minga People
Permission Level: Owner | District Manager
Typically a representative from your IT Department at your site or district can access Skyward and provide the required information as seen in the steps below to connect to your SIS.
Step 1: Set Up Minga as a Secured User
-
Navigate to Product Setup > Skyward Contact Access > Security > Secured User.
-
Click Add
-
Select the Organization button
-
Enter "Minga" then click Add Entered Name to Secured Users.
-
Enter Address information (optional) and Save.
-
Enter Contact name, phone, and/or email (optional) and Continue Add.
-
Enter Security Info and Save.
-
Note: Minga must be an Active Secured User but does not need any other permissions and the password will not be used.
-
Step 2: Generate an API Key and Secret
-
Highlight Otus in the Secured User list and click the API button in the lower right corner of the screen.
-
Click Generate a New Secret.
-
Copy and paste the Key and Secret into a document. (Do not take a screenshot)
Step 3: Locate the API URL to Share
-
Navigate to Product Setup > Skyward Contact Access > District Setup > Configuration > API Configuration.
-
Copy the OneRoster API URL and add it to the document with the Key and Secret.
Step 5: Input Details into Minga
-
Log into app.minga.io
-
Go to People > Rostering
-
Select OneRoster API and Other from the drop down menus and enable automatic rostering
-
Input required fields:
-
URL: This is the OneRoster API URL for your Skyward application.
-
API Key
-
Client Secret
-
School ID: This is the School ID to ensure Minga requests the appropriate roster in the event that multiple schools share the same SIS.
-
-
Once you've completed the form click Save and Test Connection / URL to ensure Minga is able to connect to your SIS and exchange information.
Step 6: Configure Sync Settings in Minga
Sync Settings in Minga
You can enable student, teacher, staff and admin rostering separately as well as include Primary Parent Contact Info depending on what data you want to synchronize in Minga.
Minga can automatically update information for existing users (for example if a student's name was changed in the SIS then their name would be automatically updated in Minga). By default Minga will Skip users that are already setup in Minga. To automatically update their information toggle on Auto update.
Minga can also automatically Archive (delete) users that are no longer included in the rostering data (for example when a student leaves the school) by toggling on Archive.
Please note*: Minga recommends having the Auto update and Archive settings toggled off at first until you have verified your rostering is syncing correctly in your Minga. Then toggle them on accordingly to ensure up-to-date rostering.
Get notified of Roster Sync Results
Owners can set up an email notification with all of the information from the daily roster sync. This will allow technical owners to get assurance that the sync is working or to troubleshoot immediately if any issues are detected.
Click Save