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

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 sure y…

Recurring Appointments Now Available

With Accudemia v7.0 we have incredibly simplified the process of making appointments. First, we have changed the flow from an open-search approach to a step by step wizard. Second, we have simplified the number of options displayed at the same time to reduce the complexity of the screen.

Now, we are launching one of the features that was missing for this process and that's the ability to schedule recurring appointments.

In order to create a new appointment, now you need to click on "Setup Recurrence" in the last step. Then select the recurrence pattern and end date.

Two common recurrence patterns are offered: weekly on the same day of your appointment or Monday through Friday. Also, you have the option to select Custom and specify which days of the week it should repeat or every how many months.

At the bottom, you can select until when it will repeat. Either specifying the number of occurrences or the end date.  Look at the 3-month calendar on the right to preview the se…

How-to: Scheduling Appointments

Accudemia has always offered different ways to create an appointment. Each method is intended for users trying to find appointments using different criterias. For example, if you want to list all tutors available for a certain course you might want to use the New Appointment method. The Wizard lets you find the perfect appointment for you in a simple 5 step procedure instead, where you are prompted to select the dates, services, the course and tutor you want. The 3rd way is using the Manual method, which is enabled only to administrators and it allows them to select exactly what they want and bypass several validations the system might enforce using the Wizard or the New Appointment methods.Here’s a quick description on how to use each one of these features.New AppointmentYou can find it under Center Attendance > Appointments > New Appointment. The page displays a filter with the next options: Use From/To filters to view only availability in that period of time. The center can…