Welcome to the Epic Sandbox project. This project demonstrates how to use MyChart OAuth 2.0 integration and FHIR endpoints to access information. There are practical examples of FHIR endpoints available in this project.
- Introduction
- Features
- Technologies Used
- Getting Started
- Configuration
- Usage
- Demo
- FHIR Implementation Examples
- Contributions
- License
This repository can be used as a starting point for a MyChart Autho 2.0 project or as a playground project. There is seamless integration into the SMART on FHIR with AutNext.
- SMART on FHIR OAuth 2.0 authentication flow with Epic MyChart.
- Seamless integration of NextAuth for handling authentication.
- Example API routes showcasing authenticated FHIR endpoints.
- Next.js: A popular React framework that simplifies server-rendered React applications.
- NextAuth: A powerful authentication library for Next.js applications, supporting various authentication providers including OAuth 2.0.
- OAuth 2.0: A standard protocol used for secure authorization, enabling SSO and user authentication.
- Epic MyChart: An electronic health record portal that provides a patient-centered experience, including secure authentication via OAuth 2.0.
To get started with the Epic MyChart SSO Sandbox, follow these steps:
- Clone this repository to your local machine.
- Install project dependencies using your preferred package manager (
pnpm install). - Configure OAuth 2.0 credentials (see Configuration).
- Run the development server (
pnpm dev).
- To Obtain OAuth 2.0 credentials from your Epic MyChart developer account first create a Patient Facing App.
- Set redirect URI to [DOMAIN NAME]/api/auth/callback/epic-mychart
- Check the checkbox "Is this app a confidential client?"
- Check the checkbox "Does the app require persistent access?". That'll give you a refresh_token in the response.
- Create .env file and add
EPIC_MYCHART_CLIENT_IDandEPIC_MYCHART_CLIENT_SECRET
Once configured, the Epic MyChart SSO Sandbox provides a working example of integrating OAuth 2.0 authentication into a Next.js application. You can extend this sandbox to build your own application, utilizing the provided authentication flow and components.
https://epic-sandbox.vercel.app/
After a successful authentication, explore the included FHIR implementation examples to interact with health data using the Fast Healthcare Interoperability Resources (FHIR) standard.
Contributions to the Epic MyChart SSO Sandbox are welcome! If you find any issues, have suggestions for improvements, or would like to add new features, please open an issue or submit a pull request.
This project is licensed under the MIT License, allowing you to use, modify, and distribute the code for your own projects.
Feel free to explore, learn, and adapt the Epic MyChart SSO Sandbox for your authentication needs. If you have any questions or need assistance, don't hesitate to reach out to the project maintainers or the community. Happy coding!