Skip to content
/ nango Public
forked from NangoHQ/nango

Get OAuth tokens for APIs - fast & secure.

License

Notifications You must be signed in to change notification settings

matiaslb/nango

 
 

Repository files navigation

+ Looking for Pizzly? You are in the right place. Pizzly has been renamed Nango. Using Pizzly v0.2.x? Check out: https://docs.nango.dev/migration +

Get OAuth tokens for APIs. Fast & secure.

Pre-built OAuth flows & secure token management for 40+ APIs. 100% open source.


Explore the docs »

All supported APIs · Docs · Website · Contribute an API · Report Bug · Slack Community

⭐ Nango at a glance

Nango is a service that contains everything you need to work with APIs that use OAuth.

It contains:

  • a full OAuth dance for 40+ APIs
  • a frontend SDK to trigger new OAuth flows
  • a backend SDK & REST API to retrieve fresh access tokens for your API calls

Nango is easy to try in 5 minutes and can be deployed in 15:

  • 1-liner to start a new OAuth flow in your frontend:
let result = await nango.auth('github', '<user-id>');
  • 1-liner to retrieve a token (with our SDK or REST API):
let token = await nango.getToken('github', '<user-id>');

👾 Out of the box support for 40+ APIs

40+ APIs are preconfigured to work out-of-the-box. Including:

  • CRM: Front, Hubspot, Salesforce, etc.
  • Accounting: Xero, Sellsy, Zoho Books, etc.
  • Developer tools: GitHub, GitLab, Linear, Jira etc.
  • Communication: Gmail, Microsoft Teams, Slack, Zoom etc.
  • Productivity: Asana, Airtable, Google Drive, Google Calendar, Trello, Google sheets, ClickUp etc.
  • Social: Twitter, LinkedIn, Reddit, Facebook etc.
  • and more...

If your favorite API is missing open a GitHub issue or contribute it right away: The API configurations are just simple entries in a YAML file.

🛡️ Small, self-contained & ready for production

Nango is purposely small, focused on its one task and easy to deploy in production:

  • Runs as a single docker container
  • Updates easily (docker pull)
  • Secured with an API key
  • Managed with a CLI
  • Cloud hosting available

Nango's community continuously maintains & expands API templates.

🚀 Quickstart

In <5mins, learn how to access & manage OAuth tokens for any API, using Github as an example. Ready? Go! ⏰

First, clone and start Nango:

git clone https://github.com/NangoHQ/quickstart.git && cd quickstart
docker compose up # Keep the tab open

In a new tab, add any Github OAuth App to Nango (optionally register your own Github OAuth App):

npx nango config:create github-dev github 57876b21174fed02b905 e43242c9a67fa06141e8d219c2364283d14f9ad1 "user,public_repo"

Authorize Github on this example page. Nango will securely retrieve, store and refresh OAuth credentials. Now try:

npx nango token:get 1 github-dev

Congrats 🥳 You have a fresh token to access the Github API! Let's make sure it works (❗️replace TOKEN):

curl -XGET -G "https://api.github.com/users/bastienbeurier/repos" \
    -H "Authorization: Bearer TOKEN"

(In practice, you should use our backend SDK or REST API to fetch tokens from your codebase.)

Wanna go live? Go through the more detailed Step-By-Step Guide. You can self-host Nango or use Nango Cloud.

🔍 Where to learn more

🐻 History

Pizzly (the original name of this project) was initially developed by the team at Bearer with contributions of more than 40 individuals. Over time the focus of Bearer shifted and they could no longer maintain Pizzly. In late 2022 the team at Nango adopted the project and has since maintained and evolved it together with the growing Nango community.

About

Get OAuth tokens for APIs - fast & secure.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 80.1%
  • JavaScript 12.3%
  • HTML 6.1%
  • Shell 1.2%
  • Dockerfile 0.3%