Difference between revisions of "Vivi"

From Studentnet Wiki
Jump to navigation Jump to search
 
(6 intermediate revisions by 2 users not shown)
Line 3: Line 3:
 
== Setup ==
 
== Setup ==
  
 +
===Vivi Setup===
 
When setting up Vivi you will be presented with this screen:
 
When setting up Vivi you will be presented with this screen:
  
 
[[File:vivisetup.png|1150px|Vivi setup form]]
 
[[File:vivisetup.png|1150px|Vivi setup form]]
  
* SAML SSO URL: Found on the Identity Provider page found under Single Sign On in the Cloudwork dashboard 
+
* '''SAML SSO UR'''L: Found '''Cloudwork Dashboard'''>'''Single Sign On'''>'''Identity Provider'''>'''Metadata Details'''>'''Sign On Endpoint'''<br>[[File:Sign_On_Endpoint.png|300px|centre|frame|Example of Sign On Endpoint]] 
* SAML SLO URL: Found on the Identity Provider page found under Single Sign On in the Cloudwork dashboard 
+
* '''SAML SLO URL''': Found '''Cloudwork Dashboard'''>'''Single Sign On'''>'''Identity Provider'''>'''Log out Endpoint'''<br>[[File:Logout_endpoint.png|300px|centre|frame|Example of Logout URL]]
* SAML Token-Signing Certificate: You can download the certificate from the Identity Provider page found under Single Sign On in the Cloudwork dashboard, Vivi will request a PEM format,in this case you just need to use the contents of the certificate file rather than the link. Let us know how this works for you.
+
* '''SAML Token-Signing Certificate''': Download the certificate from the '''Cloudwork Dashboard'''>'''Single Sign On'''>'''Identity provider'''>'''Certificate'''>'''Download''' <br>[[File:Certificate_Download.png|centre|frame|Example Certificate Download]] Vivi will request a PEM format,in this case you just need to use the contents of the certificate file rather than the link. Let us know how this works for you.
* SAML Name Attribute: givenName  
+
* '''SAML Name Attribute''': givenName  
* SAML Email Attribute: mail
+
* '''SAML Email Attribute''': mail
 +
* '''SAML Group Attribute''': groups
 +
* '''SAML Inheritance Code Attribute''': Leave Blank and make sure require inheritance code is not enabled
  
 
You also need to work out how we define what a "Presenter" is and what a "Student" is. Usually this is just a distinction between students and teachers.
 
You also need to work out how we define what a "Presenter" is and what a "Student" is. Usually this is just a distinction between students and teachers.
  
After this send the Metadata URL to us and we can get Vivi set up on our end quickly.
+
After finishing the Vivi Setup, it will create a metadata URL in format or https://api.vivi.io/api/v1/users/saml_metadata/<organisation_id> . Save This metadata url as an XML file.
 +
 
 +
===Cloudwork Setup===
 +
 
 +
#Log in to your school's Cloudwork dashboard
 +
#Navigate to '''Single Sign On'''
 +
#Click '''Add New Service'''
 +
#Click '''Upload an XML File'''
 +
#Upload metadata file that you recieved from Vivi and fill out the '''Name''' field
 +
 
 +
[[Category:Single Sign On Services]]

Latest revision as of 02:15, 19 October 2021

Vivi is a wireless presentation tool that enables users to share, display, annotate, capture and save information in real time, from anywhere in the room.

Setup

Vivi Setup

When setting up Vivi you will be presented with this screen:

Vivi setup form

  • SAML SSO URL: Found Cloudwork Dashboard>Single Sign On>Identity Provider>Metadata Details>Sign On Endpoint
    Example of Sign On Endpoint
  • SAML SLO URL: Found Cloudwork Dashboard>Single Sign On>Identity Provider>Log out Endpoint
    Example of Logout URL
  • SAML Token-Signing Certificate: Download the certificate from the Cloudwork Dashboard>Single Sign On>Identity provider>Certificate>Download
    Example Certificate Download
    Vivi will request a PEM format,in this case you just need to use the contents of the certificate file rather than the link. Let us know how this works for you.
  • SAML Name Attribute: givenName
  • SAML Email Attribute: mail
  • SAML Group Attribute: groups
  • SAML Inheritance Code Attribute: Leave Blank and make sure require inheritance code is not enabled

You also need to work out how we define what a "Presenter" is and what a "Student" is. Usually this is just a distinction between students and teachers.

After finishing the Vivi Setup, it will create a metadata URL in format or https://api.vivi.io/api/v1/users/saml_metadata/<organisation_id> . Save This metadata url as an XML file.

Cloudwork Setup

  1. Log in to your school's Cloudwork dashboard
  2. Navigate to Single Sign On
  3. Click Add New Service
  4. Click Upload an XML File
  5. Upload metadata file that you recieved from Vivi and fill out the Name field