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

Accudemia 7.0 Released

We are happy to announce that, as we have previously announced, we have released Accudemia 7.0 to all our customers. Here are the resources you can use to get started: User Manual: Knowledge Base: Videos: Upcoming webinars: Or watch the recorded webinar:

Create Virtual Appointment Sessions

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

Referrals and Early Alert System Quick Start

I decided to write a quick step-by-step guide to start using the Referral and Early Alert System (AREAS). I hope it will help you get started with the software in just a couple minutes. In this post everything is done by hand, that means that you are going to have to type all student names, subject areas and all the information you might need. Once you have the whole thing up and running you probably will import all the other information; so I suggest you to start creating one or 2 students, one or 2 instructors, and so on. If it’s the first time you access Accudemia, maybe you went through the initial Configuration Wizard which let’s you setup the basic stuff. In this guide we will verify all the required information is there, and create it if it is not. 1. Create the Staff Accounts: It’s always a good point to start; once you have created the administrator accounts in Accudemia they can help you to setup all the other things. You can do it from the User Accounts menu. Just make su