Universal Workflow

Auth Migration Guide ​

In an effort to support the change in campus authentication systems, the Workflow team is transitioning from the current UIP based OAuth2 model to a simplified Basic Auth approach.

Migration Steps ​

  1. Update your API Integrations
    • Request your client credentials. We'll probably reach out to you first!
    • Modify your existing API calls. It's the same old API, just different headers.
    • Visit the API documentation page for more details
  2. Change how you verify callbacks (or actually start doing it) 😉
  3. Drop the new simplified Workflow Widget in your pages
    • Implement OIDC for user authentication.
    • Install the new widget

    IMPORTANT! 🚨

    Before you deploy to production: We need the hostname of the application you'll be embedding the widget in for location verification. Otherwise, widget won't load.

  4. Test and Validate Thoroughly test your applications to ensure that everything works similarly to how they do today.
    • When testing your application, SSO over OIDC may not work as expected because your session is established with the test IdP host, while the Widget uses the production IdP host. In production, users should be automatically logged into the Widget under ideal conditions.
  5. Let us know if you have questions or how we can help!