uPortal 5.2.0

Overview

uPortal 5.2 marks the transition point moving from the Jira issue tracker to the GitHub issue tracker. Please discuss issues on the uPortal-user mailing list and direct issue reports to the GitHub issue tracker.

uPortal 5.2 has added category and favorite filtering to the portlet registry, enabling new display strategies for the uPortal UI.

uPortal 5.2 fixed an issue with OIDC tokens ensuring that multi-valued custom claims are returned correctly.

uPortal 5.2 include several significant library updates bringing new fixes to uPortal core.

Important Note ⚠️

uPortal 5.2.0 fixes a bug in the OIDC Token (the /userinfo REST API) where custom claims with multi-valued attributes were not represented correctly in the JWT. This API is very new (first seen in version 5.1), but if you're using this API already and you're passing custom claims in the Id Token, you will need to update your code to match the changes in the JWT.

The value(s) of custom claims are now JSON arrays.

Before the Change

{
  "iss": "http://localhost:8080/uPortal",
  "sub": "admin",
  "aud": "http://localhost:8080/uPortal",
  "exp": 1533358725,
  "iat": 1533326325,
  "name": "Amy Administrator",
  "given_name": "Amy",
  "family_name": "Administrator",
  "email": "[email protected]",
  "phone_number": "(555) 555-5555",
  "groups": [
    "Portal Administrators"
  ],
  "myCustomClaim": "mySpecialValue"
}

After the Change

{
  "iss": "http://localhost:8080/uPortal",
  "sub": "admin",
  "aud": "http://localhost:8080/uPortal",
  "exp": 1533358725,
  "iat": 1533326325,
  "name": "Amy Administrator",
  "given_name": "Amy",
  "family_name": "Administrator",
  "email": "[email protected]",
  "phone_number": "(555) 555-5555",
  "groups": [
    "Portal Administrators"
  ],
  "myCustomClaim": [
    "mySpecialValue"
  ]
}

uPortal 5.1.2

Changelog

Fixes

• Beans are now loaded from properties/ContextOverrides during Gradle *init tasks (#1207)
• The post-content layout region has been restored to working order (#1216)

Refactor

• Rendering thread pool now uses commons pool version 2 (#1228)
• SmartLDAP has been cleaned up and refactored (#1198)
• Commons collections is now purely transitive through spring (#1224)
• Jline has been dropped as a dependency (#1235)

Documentation

• Clarify use of Android Open Source Code Style (#1182)
• Reflect that uPortal 5 has been released (#1188)
• Correct typo in soffit documentation (#1199)

Style

• Annotate Java with @Overrides (#1192)

Test

• Leverage assertTrue (#1189)

Chore

• Update dependencies (#1196, #1197, #1201, #1098, #1204, #1205, #1209, #1212, #1213, #1215, #1214, #1219, #1220, #1223, #1226, #1227, #1230, #1231, #1232, #1233, #1228, #1234, #1238)

uPortal 5.1.1

This is a patch release (maintenance update) for uPortal 5.1. It includes a several fixes and improvements.

Change Log

• Important fix for a regression introduced with version 5.1.0 where several admin portlets would return HTTP 405 at various points
• Improvements to the CODE_OF_CONDUCT docs
• Add several missing @Override annotations throughout the codebase
• Update the Spring Framework version to 4.3.17
• Update to Node.js version 10 and npm version 5
• Update the org.json:json dependency to version 20180130
• Updates to the code style documentation
• Update several documentation links
• Update several Gradle plugins to newer versions

There is additional detail in the JIRA Release Notes.

This update should be safe to apply to any uPortal 5.1.x implementation.

Thanks to everyone who contributed!

uPortal 5.0.8

This is a patch release (maintenance update) for uPortal 5.0. It includes a couple valuable fixes.

Change Log

• Important fix for a regression introduced with version 5.0.7 where several admin portlets would return HTTP 405 at various points
• Revised ticketValidationFilter bean to use serverName instead of service

There is additional detail in the JIRA Release Notes.

This update should be safe to apply to any uPortal 5.0.x implementation.

Thanks to everyone who contributed!

uPortal 5.1.0

Release Notes

The uPortal Community and the uPortal Steering Committee announce version 5.1.0 of uPortal: the leading open source enterprise portal framework built by and for higher education institutions, K-12 schools, and research communities.

Version 5.1.0 is a new minor release for the uPortal 5 line. It includes all the bug fixes and documentation updates in patch versions 5.0.1 through 5.0.7, plus several new features. There is a full list of completed tickets in JIRA.

New Features

This is a list of the changes included with this version that are not present in any release of 5.0.x.

• Provide four (4) new layout options based on CSS Flexbox: 2-, 3-, 4-, and 6-column
• Provide a simple, secure way of sharing identity and role information to REST APIs based on OpenID Connect
• Convert the "footer sitemap" feature (Respondr) from an XSL template to a portlet, allowing admins to control its presence (or absence) more easily and with more nuance (e.g. present for some users based on role)
• Provide a mechanism for configuring which Soffit data model elements are included in the request; include none of them by default
• Reserve use of certain accessibility landmarks for main uPortal skin only
• Provide documentation in French 🇫🇷

Thanks to everyone who contributed!

uPortal 5.0.7

This is a patch release (maintenance update) for uPortal 5.0. It includes a couple new fixes & improvements.

Change Log

• Validate the initialFilter parameter in the Portlet Marketplace portlet
• Update a failing unit test (UpdatePreferencesServletTest.java)

There is additional detail in the JIRA Release Notes.

This update should be safe to apply to any uPortal 5.0.x implementation.

Thanks to everyone who contributed!

uPortal 5.1.0 Milestone 6

• Fixes and improvements to OpenID Connect provider (#1163)

uPortal 5.1.0 Milestone 5

Features

• uPortal now provided identity and group information to external APIs in the portal ecosystem through Open ID Connect. (#1162, UP-5009)

Fixes

• uPortal now validates initial filter is a valid category (#1147, UP-5006)
• Add missing indexes on up_user and ss_user tables (#1125)
• Ensure only a single main element added to accessibility tree (#1158, UP-5007)

Documentation

• The uPortal manual includes a new section for the OpenID Connect provider, with overview of use cases and an implementer guide. (Page, #1162, UP-5009)
• The uPortal manual has a new Glossary section to document uPortal jargon. (Page, #1156)
• The load balancer section of uPortal now includes details on setting the remote IP valve (Page, #1161)
• Soffit documentation now has a sequence diagram giving an overview of the communication (Page, #1159)

Refactors

• Convert FragmentDefinition.index to FragmentDefinition.id (#1155, UP-5008)
• Various libraries uPortal leverages have been updated (#1139, #1149, #1151, #1150, #1152, #1153)

uPortal 5.1.0 Milestone 4

Resolves an edge case where a group who's name is an extension of another group's name would be incorrectly picked up by AdHocGroupTester (#1146)

uPortal 5.0.6

This is another patch release (maintenance update) for uPortal 5.0. It includes several new fixes & improvements.

Change Log

• Fix support for configuring available locales in the uP5 style (e.g. inside PORTAL_HOME) 🇫🇷
• Fix an issue with unusable database connections in the connection pool by correcting the configuration of validationQuery
• Fix support for configuring guest_user_names in the uP5 style (e.g. inside PORTAL_HOME)
• Purge associated entries in the org.apereo.portal.groups.GroupMemberImpl.parentGroups cache when a user re-authenticates
• Fix a logical error in AdHocGroupTester that produces an incorrect result when the name of one group is a substring on another group

There is additional detail in the JIRA Release Notes.

This update should be safe to apply to any uPortal 5.0.x implementation.

Thanks to everyone who contributed!