Using Shibboleth with WordPress

Requirements

This guide assumes you are running a WordPress installation where you want to use Shibboleth to authenticate NC State users.

Make sure your copy of WordPress is updated to the latest version.
Make sure the server that is running your site is configured to run the Shibboleth SP software. Either by follow the installation notes in this documentation, or by getting hosting services from OIT or another campus group where they can configure Shibboleth for you.
Your Shibboleth SP should be following our suggested attribute mappings.

NCSU Mars plugin - A custom WordPress Plugin maintained by ITECS for use on NCSU WordPress sites. It supports local logins as well as Shibboleth logins. (NCSU login required to view the github repo.)
Shibboleth plugin - How to configure the WordPress Shibboleth plugin in our environment. Old instructions may be out of date.

If you attempt to login to your WordPress site and you get stuck in a loop without getting back to WordPress, see: Apache 2.4 Require All Granted Problem
If you are running Wordpress and you have the entire site protected by Shibboleth, you may run into an issue where the site loses your session and repeatedly logs in to the IdP. See: Shibboleth Protected Site Problem
If you've just added an .htaccess entry on a new site and you are getting 500 Internal Server Errors on all pages, see: Apache 2.4 ShibCompatWith24 Problem
If you're running on our cPanel hosting and you cannot login due to 404 Not Found Errors, see: cPanel Rewrite Inherit Problem