How can we help?

Overview

The Ellucian Banner integration uses Ellucian Ethos to provide Room Reservations with read-only access to academic terms, class sections, meeting schedules, instructors, instructional methods, section statuses, and room assignments.

This article lists the information and configuration Concept3D needs from your institution before the connection can be configured and tested.

What Is Ellucian Ethos?

Ellucian Ethos is Ellucian's integration platform and API layer. It gives authorized applications standardized access to Banner data.

Using Banner does not automatically mean your institution has Ethos access. Before beginning implementation, confirm that your institution can:

• Access Ellucian Ethos
• Create or provide an Ethos API key
• Grant the key read access to all endpoints required by the Room Reservations integration

Required Participants

Implementation typically requires these participants from your institution and Concept3D:

• A Room Reservations Platform Admin or Facilities Manager
• A Banner or Ethos administrator
• A network or security administrator who can update firewall rules
• A Concept3D Partner Success Manager

Network Requirements

Your institution must allowlist the appropriate Concept3D integration IP address so the integration can reach your Ethos environment.

Allowlist only the environment being configured. If both QA and production connections will be tested, allowlist both addresses.

Information Your Institution Must Provide

Provide the following information to your Concept3D Partner Success Manager:

• The Ethos API key for the environment being connected
• Whether the connection is for QA/testing or production
• Confirmation that the matching Concept3D integration IP address has been allowlisted
• Confirmation that the API key has read access to all required Ethos endpoints
• A Banner or Ethos technical contact for connection testing
• An academic term that can be used for validation

Security: Share the Ethos API key only through the secure credential-delivery process provided by Concept3D. Do not send the key by email or include it in a support ticket, shared document, screenshot, or chat message.

Required Data Access

The Ethos API key must provide read-only access to the information Room Reservations needs to create accurate class reservations. Room Reservations does not write changes back to Banner.

Academic Scheduling

• Academic periods and terms, including sub-periods and parts of term
• Class sections, including section code, number, title, and start and end dates
• Section statuses, such as open, closed, pending, or cancelled
• Meeting patterns or instructional events
• Meeting start and end dates
• Meeting days and times
• Instructional methods

Read access must cover the complete academic-period structure so Room Reservations can connect a section's part of term or sub-period to its parent term.

Locations

• Rooms, including each room's identifier and room number for mapping and display
• Buildings, including each building's identifier, code, and name for display

People and Course Information

• Instructors, including names and identifiers available through the Ethos Persons resource
• Courses, including the course code and title used to label reservations
• Sites or campuses

Section Capacity

• Maximum enrollment or capacity for each section

Banner Data Readiness

Before connection testing, confirm that the validation term contains representative data:

• Active class sections
• Meeting patterns with valid start and end dates
• Meeting days and times
• Room assignments
• Stable room identifiers
• Instructor names and instructional methods, when used by your institution

Classes without assigned rooms cannot be imported into Room Reservations. Pending or cancelled sections may also be excluded based on their Banner status.

Your Institution's Responsibilities

• Provide the Ethos API key through the approved secure process
• Grant the required read permissions
• Allowlist the correct Concept3D integration IP address
• Provide a representative validation term
• Correct inaccurate academic schedule data in Banner
• Maintain the Ethos API key and notify Concept3D before rotating or revoking it

Concept3D Responsibilities

• Provide the QA and production IP addresses
• Configure your institution's SIS connection
• Store connection credentials securely
• Validate authentication and required endpoint access
• Make the integration available in Room Reservations
• Assist with the initial term and room-mapping validation

Validate the Connection

Work with Concept3D to confirm that:

• Current and upcoming academic terms load successfully
• Sections can be retrieved for the validation term
• The complete set of classes for the validation term is available
• Meeting days and times are present
• Room assignments and recognizable room and building details are present
• Section statuses are available
• Instructor and instructional-method data are available when expected
• The connection does not return authentication, authorization, or firewall errors

After connection validation, continue with Map SIS Rooms to Room Reservations Spaces.

Troubleshooting

Related Articles

• SIS Integration Overview
• Map SIS Rooms to Room Reservations Spaces
• Import an Academic Class Schedule from an SIS
• Re-sync an Imported Academic Term