Difference between revisions of "Operoo"

From Studentnet Wiki
Jump to navigation Jump to search
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Setting up CareMonkey SAML Integration for Parents==
+
==Caremonkey to Operoo==
 +
 
 +
Caremonkey has rebranded themselves to be named Operoo
 +
 
 +
==Updating SSO settings from Caremonkey to Operoo==
 +
Due to the rebranding from Caremonkey to Operoo, settings for Caremonkey SSO setup in Cloudwork need to be updated to match Operoo.
 +
 
 +
If you have Caremonkey SSO installed please follow these instructions to update the service to Operoo
 +
 
 +
If you have not installed Caremonkey SSO, skip these instructions and move on to '''Setting up Operoo SAML Integration for Parents'''
 +
 
 +
 
 +
#Login to '''Cloudwork Dashboard'''>'''Single Sign On'''
 +
#Click on the '''Caremonkey service'''>'''Service Details'''>'''Edit'''
 +
#For the '''Login URL''', change the '''caremonkey''' part of the url to '''operoo'''
 +
#click '''Submit'''
 +
#Navigate to '''SAML Config'''>'''Edit'''
 +
#In '''Entity Id''', change the '''caremonkey''' part to '''operoo'''
 +
#in '''Assertion Consumer Service'''>'''Location'''
 +
#Change the '''caremonkey''' part of the ACS URL to '''operoo'''
 +
#Click '''submit'''
 +
 
 +
==Setting up Operoo SAML Integration for Parents==
  
 
===How to set up Single Sign On (SSO)===
 
===How to set up Single Sign On (SSO)===
  
==== CareMonkey Information ====
+
==== Operoo Information ====
  
To set up CareMonkey you need the SchoolId and ContactType from CareMonkey:
+
To set up Operoo you need to contact Operoo asking for what value is used for signing in, the SchoolId and ContactType:
  
SchoolId will be a number e.g. 1234
+
*Sign in value is to be agreed upon with Operoo, usually SIS_ID or Email
ContactType wll be a string e.g. StudentContact or GroupCarer
+
*SchoolId will be a number e.g. 1234
 +
*ContactType wll be a string e.g. StudentContact or GroupCarer
  
 
==== Cloudwork Set Up ====
 
==== Cloudwork Set Up ====
  
To set up CareMonkey in the Cloudwork Dashboard go to ''Single Sign On'' --> ''Add New Service'' --> ''Custom SAML Service''. The details for you to add are listed here:
+
To set up Operoo in the Cloudwork Dashboard go to '''Single Sign On'''>'''Add New Service'''>'''Custom SAML Service'''. The details for you to add are listed here:
 +
*'''Name''': Operoo
 +
 
 +
*'''Entity ID''': https://groups.operoo.com/users/auth/saml/metadata?group=<<schoolid>>&user_type=<<contacttype>>
  
*NameID value: To be agreed upon with CareMonkey, usually SIS_ID or Email
+
*'''Assertion Consumer Service''': https://groups.operoo.com/users/auth/saml/callback?group=<<schoolid>>&user_type=<<contacttype>>
  
*NameID format: EmailAddress
+
*'''NameID Value''': To be agreed upon with Operoo, usually '''SIS_ID''' or '''Email'''
  
*Metadata URL for Caremonkey is in the format: https://groups.caremonkey.com/users/auth/saml/metadata?group=<<schoolid>>&user_type=<<contacttype>>
+
*'''NameID format''': '''EmailAddress'''
  
*Assertion Consumer Service URL: https://groups.caremonkey.com/users/auth/saml/callback?group=<<schoolid>>&user_type=<<contacttype>>
+
*'''Login URL''': https://groups.operoo.com/users/auth/saml?group=<<schoolid>>&user_type=<<contacttype>>
  
*Login URL to publish: https://groups.caremonkey.com/users/auth/saml?group=<<schoolid>>&user_type=<<contacttype>>
+
<br>[[File:Operoo_Example.png|300px|centre|frame|Example of an Operoo Setup]]
  
The CareMonkey Admin dashboard screen will look like this:
+
=====Email Template=====
 +
<blockquote>
 +
Hi Operoo,
  
[[File:caremonkey.png]]
+
<School Name> is wanting to setup SAML Integration for Parents with studentnet.<br>
 +
Will Parents sign in with SIS_ID or Email?<br>
 +
Could you please provide our school's Schoolid and ContactType?<br>
 +
</blockquote>
  
 
==Notes==
 
==Notes==
Organisations may enable the CareMonkey SAML Integration for Staff Members but please be aware that the Staff Members own their accounts and not the Organisation. Staff Members can still login to CareMonkey directly, even if their accounts are disabled from the Organisation's SSO. However, a CareMonkey Administrator can remove a Staff Member's access to any groups anytime.  
+
Organisations may enable the Operoo SAML Integration for Staff Members but please be aware that the Staff Members own their accounts and not the Organisation. Staff Members can still login to Operoo directly, even if their accounts are disabled from the Organisation's SSO. However, a Operoo Administrator can remove a Staff Member's access to any groups anytime.  
  
 
[[Category:Single Sign On Services]]
 
[[Category:Single Sign On Services]]

Latest revision as of 05:12, 14 October 2021

Caremonkey to Operoo

Caremonkey has rebranded themselves to be named Operoo

Updating SSO settings from Caremonkey to Operoo

Due to the rebranding from Caremonkey to Operoo, settings for Caremonkey SSO setup in Cloudwork need to be updated to match Operoo.

If you have Caremonkey SSO installed please follow these instructions to update the service to Operoo

If you have not installed Caremonkey SSO, skip these instructions and move on to Setting up Operoo SAML Integration for Parents


  1. Login to Cloudwork Dashboard>Single Sign On
  2. Click on the Caremonkey service>Service Details>Edit
  3. For the Login URL, change the caremonkey part of the url to operoo
  4. click Submit
  5. Navigate to SAML Config>Edit
  6. In Entity Id, change the caremonkey part to operoo
  7. in Assertion Consumer Service>Location
  8. Change the caremonkey part of the ACS URL to operoo
  9. Click submit

Setting up Operoo SAML Integration for Parents

How to set up Single Sign On (SSO)

Operoo Information

To set up Operoo you need to contact Operoo asking for what value is used for signing in, the SchoolId and ContactType:

  • Sign in value is to be agreed upon with Operoo, usually SIS_ID or Email
  • SchoolId will be a number e.g. 1234
  • ContactType wll be a string e.g. StudentContact or GroupCarer

Cloudwork Set Up

To set up Operoo in the Cloudwork Dashboard go to Single Sign On>Add New Service>Custom SAML Service. The details for you to add are listed here:

  • Name: Operoo
  • NameID Value: To be agreed upon with Operoo, usually SIS_ID or Email
  • NameID format: EmailAddress


Example of an Operoo Setup
Email Template

Hi Operoo,

<School Name> is wanting to setup SAML Integration for Parents with studentnet.
Will Parents sign in with SIS_ID or Email?
Could you please provide our school's Schoolid and ContactType?

Notes

Organisations may enable the Operoo SAML Integration for Staff Members but please be aware that the Staff Members own their accounts and not the Organisation. Staff Members can still login to Operoo directly, even if their accounts are disabled from the Organisation's SSO. However, a Operoo Administrator can remove a Staff Member's access to any groups anytime.