Skip to main content

Implementing SSO (Single Sign-On)

Don't be intimidated by the seemingly daunting task of creating and easy way for your student, tutor, and admins to login to Accudemia via your school's portal.  It is far easier than it may seem.  As a support person here at Engineerica I noticed this feature is something that schools want to offer their users but are afraid to get started or maybe do not know where to do so.  Here we will go through the process of implementing SSO (Single Sign-On) easily for your institution.
Several Pre-Requisites
  1. You will need access to place hyperlinks into your webpages and create webpages/add files to your school's portal.  Usually this can be done via the Web Development Specialists at your school who can modify the files directly on your web server.  Others will need their privileges to be elevated on the school's portal or website so they can create/modify webpages on your school's website via a web-based WYSIWYG (What-You-See-Is-What-You-Get) editor.
  2. You will need to obtain your Accudemia Developer Key.  This can be done simply by a College-Level Admin account in Accudemia under the Administration section and clicking Advanced > Developers.  You will need this later once we want to create the Accudemia redirect webpage.
Let's get Started!
Now that we have the pre-requisites taken care of we can begin with actually implementing SSO.  If you don't understand how this process works, as far as from a security standpoint, you can read this article on the Accudemia Developer Documentation.  Basically your Portal already has authenticated the users and we have it pass us a secret key (token) with the user's ID to automatically login the user to Accudemia.  Now follow these steps using ASP.NET:
  1. On the root of your site, create a page called RedirectAccudemia.aspx, and put the following code:
  2. You need to configure the code above in the webpage to use your developer keys, where it says:
    The domain is the address you usually use to access Accudemia.
    The devkey is the developer key you get from Accudemia, as described in the section Before Start: Get your Developer Keys!.
    The userId is a bit harder to set up, because it depends on how your application works. You probably are using the .NET Principal class or the Session to store the current logged in user. If Principals are being used, you can leave it as is; if the user information is stored in the Session, your code might look like this:

    It all depends on how your Portal works. If you are not sure about it, please ask your Web Development Specialists for more help.
  3. Next edit the webpage in the Portal source code to add a link to Accudemia. For instance, add this on your site's menu:
    Also, you can have other links to access specific pages of Accudemia. If you want your users to see a link pointing to Create New Appointment, for example, add the following:

Done!  For a complete working example visit our mock Portal Website and login with the Student User ID of 555555555 and a password of 1234.  You can download all the source code of our mock Portal Website as well.  Additionally if you want the PHP version of the code visit here.


Popular posts from this blog

Did you know? You can create groups from filtered reports

On reports: when you create and filter a report it "automatically" creates a User Group. After creating a report that you need, where you have filtered all of the students with " MATH "(Subject Areas), selected only the " Freshman "(Student Demographic) who have visited the center for " Tutoring "(Service Type) more than 3 times on a Visitor History report you decide you want to save that group and call them " Freshman needing Math Help ." You can do this after you run that report by visiting the User Accounts > Groups section on the left-side navigation panel. Once there simply click on the Report Generated Groups tab, then click on the report you just ran, and click edit .  At this point you can name the group and hit save changes and the group will now be available for you to use as a group filter in future reports.

and Appointment Restrictions

We are excited to announce that we are introducing 2 new features today. When the students sign-in or create an appointment, now you can limit what courses and staff members to display. There are 2 types of restrictions available that you can use: The first one is the Student-Staff Member Association . This lets you assign specific staff member to specific students, so you can decide who works with who. The second one is the Service-Subject Area Association . That means that only certain courses will be displayed when a service is selected. For example, certain services like Tutoring might require all the student courses to be displayed, while a Self Study service might require the students to select a different kind of activity only for tracking purposes. The restrictions can be found under Administration > Restrictions in Accudemia 7.0. Once there, select the restriction type you want to edit. Then, 1) Select the Center you want to apply the restriction to. 2) Cli

Create Virtual Appointment Sessions

Just released! Watch the introductory video: Read this guide for more information