Difference between revisions of "SynWeb"

From Studentnet Wiki
Jump to navigation Jump to search
 
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Setup Synergetic Communuty Portal==
+
==SSO Setup with SynWeb==
# Login to your school's dashboard
+
# Login to your school's '''Cloudwork dashboard'''
# Navigate to '''Single Sign On'''
+
# Navigate to '''Single Sign On'''>'''Identity provider'''>'''Certificate'''>'''Download'''
# Navigate to '''Identity Provider'''
+
# Download the certificate on that page.<br>[[File:Certificate_Download.png|centre|frame|Example Certificate Download]]
 +
# Copy that certificate onto the Synergetic machine under <synweb>/Site/Certificates/idp.crt ''' ''you may need to create this folder'' '''
 
# Log in to SQL Management Studio
 
# Log in to SQL Management Studio
 
# Run this query
 
# Run this query
 
#: SELECT SynergeticPassword FROM pvSynDatabases WHERE SynergeticUserName = 'zSynergetic_main_dbo'
 
#: SELECT SynergeticPassword FROM pvSynDatabases WHERE SynergeticUserName = 'zSynergetic_main_dbo'
# On your computer, find your Binconfig folder, where the  Community Portal is installed
+
# On your computer, find your Binconfig folder, where the  SynWeb is installed
# Run Synergetic.Application.CreateConfig.exe as an administrator and add the following values to specified fields
+
# Run '''Synergetic.Application.CreateConfig.exe''' as an administrator and add the following values to specified fields
#:: AuthenticationMode = SAML
+
#:: '''AuthenticationMode''' = SAML
#:: OverrideUserName = zSynergetic_main_dbo
+
#:: '''OverrideUserName''' = zSynergetic_main_dbo
#:: SAMLLoginBinding = POST
+
#:: '''SAMLLoginBinding''' = POST
#:: SAMLLogoutBinding = REDIRECT
+
#:: '''SAMLLogoutBinding''' = REDIRECT
#:: SAMLLoginDestination = put in the '''Sign On Endpoint''' from your school's dashboard
+
#:: '''SAMLLoginDestination''' = put in the '''Sign On Endpoint''' from your school's dashboard(This is found under '''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]]
#:: SAMLLogoutDestination = put in the '''Log Out Endpoint''' from your school's dashboard
+
#:: '''SAMLLogoutDestination''' = put in the '''Log Out Endpoint''' from your school's dashboard (This is found under '''Cloudwork Dashboard'''>'''Single Sign On'''>'''Identity Provider'''>'''Log out Endpoint''')<br>[[File:Logout_endpoint.png|300px|centre|frame|Example of Logout URL]]
#:: SAMLLoginX509CertificatePath = put in the location for the AD FS token
+
#:: '''SAMLLoginX509CertificatePath''' = ~\Site\Certificates\idp.crt
#:: SAMLSPISsuer = put in the login url for your school's community portal
+
#:: '''SAMLSPIssuer''' = <<synergetic URL>>/login.aspx
#:: SAMLComparisonMode = minimum
+
#:: '''SAMLComparisonMode''' = minimum
#:: SAMLClaimAttributeName = NameID
+
#:: '''SAMLClaimAttributeName''' = NameID
 +
 
 +
Once you have saved this configuration file, open it up in notepad (or Notepad++) and find the OverridePassword key, which should look like the below.
 +
 
 +
<OverridePassword />
 +
You will now need to remove the close and enter the password, similar to the below.
 +
 
 +
<OverridePassword>Password from the query</OverridePassword>
  
==SSO setup Cloudwork==
+
==SSO setup with Cloudwork==
  
 
# Login to your school's dashboard
 
# Login to your school's dashboard
# Navigate to Single Sign On
+
# Navigate to '''Single Sign On'''>'''Add New Service'''>'''Synweb'''
# Add new service
+
# Enter '''Your Synergtic URL'''
# Fill out the blanks
 
#:: '''Name''' = name given to service
 
#:: '''Entity ID''' = <<synergetic URL>>/login.aspx
 
#:: '''Assertion Consumer Service''' =  <<synergetic URL>>/login.aspx
 
#:: '''NameID''' = Select '''Email'''
 
#:: '''NameID Format''' = Select '''emailAddress'''
 
 
# Click Submit
 
# Click Submit
  

Latest revision as of 00:04, 21 June 2022

SSO Setup with SynWeb

  1. Login to your school's Cloudwork dashboard
  2. Navigate to Single Sign On>Identity provider>Certificate>Download
  3. Download the certificate on that page.
    Example Certificate Download
  4. Copy that certificate onto the Synergetic machine under <synweb>/Site/Certificates/idp.crt you may need to create this folder
  5. Log in to SQL Management Studio
  6. Run this query
    SELECT SynergeticPassword FROM pvSynDatabases WHERE SynergeticUserName = 'zSynergetic_main_dbo'
  7. On your computer, find your Binconfig folder, where the SynWeb is installed
  8. Run Synergetic.Application.CreateConfig.exe as an administrator and add the following values to specified fields
    AuthenticationMode = SAML
    OverrideUserName = zSynergetic_main_dbo
    SAMLLoginBinding = POST
    SAMLLogoutBinding = REDIRECT
    SAMLLoginDestination = put in the Sign On Endpoint from your school's dashboard(This is found under Cloudwork Dashboard>Single Sign On>Identity Provider>Metadata Details>Sign On Endpoint)
    Example of Sign On Endpoint
    SAMLLogoutDestination = put in the Log Out Endpoint from your school's dashboard (This is found under Cloudwork Dashboard>Single Sign On>Identity Provider>Log out Endpoint)
    Example of Logout URL
    SAMLLoginX509CertificatePath = ~\Site\Certificates\idp.crt
    SAMLSPIssuer = <<synergetic URL>>/login.aspx
    SAMLComparisonMode = minimum
    SAMLClaimAttributeName = NameID

Once you have saved this configuration file, open it up in notepad (or Notepad++) and find the OverridePassword key, which should look like the below.

<OverridePassword /> You will now need to remove the close and enter the password, similar to the below.

<OverridePassword>Password from the query</OverridePassword>

SSO setup with Cloudwork

  1. Login to your school's dashboard
  2. Navigate to Single Sign On>Add New Service>Synweb
  3. Enter Your Synergtic URL
  4. Click Submit