Ethos Integration Settings

The Ellucian Ethos Integration Settings allow administrators to configure the connection between ProcessMaker and Ellucian Ethos. Admin access is required, and this setup must be completed before the API Monitor can begin monitoring configured Ethos APIs.


Establish Connection to Ethos

Follow these steps to define the base configuration for your Ethos integration.

  1. Login using the provided URL and Admin credentials.

  2. In the Workspace Name setting, enter the name of your workspace. This is used internally to identify the integration environment.

  3. In the Ellucian Ethos Integration Base URL setting, enter the URL for accessing Ellucian Ethos APIs.

  4. In the Ellucian Ethos Integration API Key setting, enter the API key used to authenticate requests to the Ethos API. This should be generated from your Ellucian Ethos environment and kept secure.

  5. From the Time Zone setting, select the appropriate time zone for your institution. This ensures that all scheduled checks and timestamped logs align with your local time.

  6. Click Save Setup to save the changes.


Configure Endpoints

To begin monitoring your Ethos APIs, define the specific endpoints (resources) you want to track. Follow these steps to add and configure each API resource, including its version, optional filters, and status. Once configured, these endpoints will be monitored based on your scheduled checks.

  1. Login using the provided URL and Admin credentials.

  2. Click the Designer option from the top menu.

  3. From the Assets panel, hover over the Collections icon, and then select View All Collections.

  4. Find the Collection named api-check-services.

  5. Click on the Records icon to view this Collection.

  6. Click +Record to add a new record to the Collection.

  7. In the Resource field, enter the name of the Ethos API endpoint to monitor (e.g., institution-jobs).

  8. In the Version field, enter the API version to use (e.g., v1.0). This should match the version defined in your Ethos environment.

  9. Optionally, use the Criteria field to filter based on specific query parameters.

  10. Optionally, in the Filter field, define any custom filter to apply. If no filter is needed, enter none.

  11. Use the toggle labeled Enabled to activate or deactivate this API endpoint.

  12. Once all fields are configured, click the Save button to apply the settings.

  13. Repeat these steps to add additional endpoints.

  14. Setup to save the changes.

Last updated