> For the complete documentation index, see [llms.txt](https://docs.1kosmos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.1kosmos.com/integrations/identity-verification/epic-identity-verification-in-mychart-and-epiccare-link/configuring-1kosmos-as-an-identity-verification-vendor-in-epic.md).

# Configuring 1Kosmos as an identity verification vendor in Epic

After creating your OIDC client and workflow, you will need to request a download of the 1Kosmos application in Epic. This can be done in parallel with the rest of set up. Reach out to your 1Kosmos representative for assistance. After 1Kosmos approves the application download, you will use the information provided within Epic complete the integration set up. \
\
&#x20;For Epic’s documentation on adding identity verification for MyChart, see [Toolbox ID Verification for MyChart.](https://galaxy.epic.com/?#Browse/page=1!68!50!100366832)&#x20;

For Epic’s documentation on adding identity verification for EpicCare Link, reach out to your Epic representative.&#x20;

#### Client ID and client secret&#x20;

These are generated when you create the OIDC client. You can find them in the application details page.

#### Well-known configuration URI&#x20;

Navigate to Settings > General > Authorization Server&#x20;

Your Well-Known Config URI will be formatted as:\
[https://\<yourtenant>.1kosmos.net/oauth2/community/default/.well-known/openid-configuration](about:blank)&#x20;

Replace \<yourtenant> with your actual tenant name.&#x20;

#### Scopes&#x20;

* openid&#x20;
* profile
* identity\_assurance
* idv\_flow\_\[access\_code]. Replace access\_code with the access code generated during workflow creation. &#x20;

#### Branding information&#x20;

* Button Color: #5342FF
* Text Color: #FFFAF1
* Button Logo: [1Kosmos Logo](https://6858402.fs1.hubspotusercontent-na1.net/hubfs/6858402/Brand%20Assets/1K-Wordmark-White.webp)&#x20;

#### Expected user claims&#x20;

After an identity verification, 1Kosmos returns the claims from the workflow back to MyChart. You configure how these claims are returned in the JSON snippet in your OIDC Client. For example, if you use the suggested JSON in [Setting up an OIDC Client in 1Kosmos](broken://spaces/5DFSjLrGww16mwRQ5csY/pages/3j5VCzDEovit1L0eCToo), the return might look like this:&#x20;

`{` &#x20;

`"sub": "USERNAME",`&#x20;

`"firstname": "FIRST_NAME",` &#x20;

`"lastname": "LAST_NAME",` &#x20;

`"birthdate": "BIRTHDATE",` &#x20;

`"ssn": "SSN",`&#x20;

`"at_hash": "AT_HASH_VALUE",` &#x20;

`"aud": "AUDIENCE_VALUE",` &#x20;

`"exp": EXPIRATION_TIMESTAMP,` &#x20;

`"iat": ISSUED_AT_TIMESTAMP,` &#x20;

`"iss": "ISSUER_URI"` &#x20;

`}`&#x20;

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.1kosmos.com/integrations/identity-verification/epic-identity-verification-in-mychart-and-epiccare-link/configuring-1kosmos-as-an-identity-verification-vendor-in-epic.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
