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.

Comments

Popular posts from this blog

Tired of that default login page?

UPDATE:This is no longer necessary. Go to the Control Panel > Appearance and Themes to update the login instructions. Also, the screenshot shown below does not reflect the actual default page. See updated post.

Most users never notice that the standard page shown to access Accudemia is just an example. You can always change the way it looks simply by sending us the new page.

Also, it’s possible to stop using that page and have a better integration in your own site. You can put the login frame into your page; let’s see how to do that. You might want to contact the administrator of your website in order to do this, it will be a bit complex if you have never dealt with HTML code.
Now, the only thing you have to do is include the following code in your page’s source:
<iframe frameborder="0" height="85px" width="190px" scrolling="no" src="https://collegename.accudemia.net/LoginForm.aspx?bgColor=%23FFFFFF&Layout=Vertical&Referer=http…

1-click sign-in for staff members now available

Productivity is essential when a center is busy and there's a long line of students waiting. Hopefully that's not your case, but in any case if we can save tutors, advisors or counselors a few seconds of their time, we have made their job easier and more valuable.Starting today, we're rolling out an update that lets staff members sign-in and sign-out with only one click (OK, maybe two).On the top-right part of the screen, staff members will see a button indicating whether they are signed-in or not. Clicking there will show a small popup to let them sign-in or sign-out, without having to leave the screen they are currently on.When signed-out:
When signed-in:If you are an administrator and don't think this is useful or want to disable it for any reason, you can do so in the Control Panel. Click on "User Accounts" and uncheck the option "Tutors can sign them in and out from any screen".Leave your comments below if you find this feature useful!

Make a subject area available to all students and/or in all centers without importing files!

If you go to edit a Subject Area you’ll see that you have now two new options: “Available to all Students” and “Available in All centers”.

The first option is very handy in the situation where you are using enrollment but you have a subject area that should be available to all students. Before this option, you would have to upload an import file with all the students and the corresponding subject area, but now you just check this option in and that’s it!

The second option will help you associate a subject area to all the centers in your system. Again, before this option an import file was needed in order to save this relationship.

You can also set this options via ADX when you import courses!

You can see these options in the image below…