Getting Started
Learn about our Authentication Framework
The Authentication Framework protects access to user data via modern, battle-tested, tech industry standards such as OAuth 2.0 and OpenID Connect (OIDC) (which we continue to update as those standards evolve).
See Authentication Framework for details.
Authentication framework purpose
The Authentication Framework is the underlying foundation for consuming all Jack Henry Enterprise APIs (e.g. the Wires API and EDPP AP).
The Authentication Framework does not use API keys nor does it share usernames and passwords with 3rd party developers.
Instead, it provides authorized API access via an Access Token and provides authenticated information about the user via an Identity Token.
OAuth 2.0 and OpenID Connect
The Authentication Framework protects user data using the OAuth 2.0 industry standard. With OAuth, users can delegate scoped access to third parties who wish to act on the user’s behalf. The user’s login credentials are never shared with the third party. Instead, authorization is provided to third party apps via an access token.
The Authentication Framework provides user identity information using the OpenID Connect (OIDC) industry standard. OpenID Connect is an identity layer built on top of the OAuth 2.0 protocol. With OpenID Connect, third party apps are provided authenticated information about the user in the form of an identity token.
Tokens
OAuth 2.0 and OpenID Connect are based on the concept of tokens. There are 3 main types:
- Access Token
- Identity Token
- Refresh Token
External resources for OAuth 2.0 and OpenID Connect
If you want to learn more about OAuth 2.0 and OpenID Connect, these external resources may be useful:
- Guide: An Illustrated Guide to OAuth and OpenID Connect
- Video: OAuth 2.0 and OpenID Connect (in plain English)
- Article: OpenID Connect explained
- Spec: OpenID Connect Core 1.0 incorporating errata set 1
API credentials
Obtaining
Testing/development credentials are only available to JH partner banks and VIP participating vendors.
- If you are a partner bank, please submit For Clients Case and ask it to be routed to EIS Adoption.
- For VIP participants, submit a Vendor/Partner Portal case.
Usage
Client Authentication:
client_id
client_secret
client_id
and client_secret
values secret and not leak it through some kind of frontend, client-accessible JavaScript call.Do not share credentials via unsecured channels (e.g. email or instant messaging)
Similarly, do not commit credentials to your source code repository.