Tyk API Gateway app
Pull request Compare This branch is 1916 commits behind TykTechnologies:master.
Latest commit f64201b Aug 14, 2014 @lonelycode lonelycode Merge pull request #2 from espebra/master
Fixed some typos
Permalink
Failed to load latest commit information.
apps
templates
utils Updated release script Aug 13, 2014
.gitignore
LICENSE.md Added license Aug 13, 2014
README.md
Vagrantfile
analytics.go
api.go
api_definition_manager.go
api_definition_test.go
api_test.go Made tests first class so they are easier to run Aug 13, 2014
auth_manager.go
config.go Made tests first class so they are easier to run Aug 13, 2014
gateway_test.go Made tests first class so they are easier to run Aug 13, 2014
handler_error.go
handler_proxy.go
handler_success.go
main.go First main commit Aug 13, 2014
middleware_access_rights.go
middleware_api_security_handler.go Linted and formatted Jul 15, 2014
middleware_basic_auth_check.go
middleware_check_HMAC_signature.go
middleware_key_exists.go
middleware_key_expired_check.go Middleware linted Jul 10, 2014
middleware_oauth2_key_exists.go Linted and formatted Jul 15, 2014
middleware_rate_limiting.go
middleware_version_check.go
notifications.go
oauth_manager.go Formatted Aug 7, 2014
oauth_manager_test.go
quickstart.conf Fixed significant bug where proxy wouldn;t work with virtual host ser… Jul 30, 2014
session_manager.go Formatted Aug 7, 2014
storage_handlers.go Analytics now a goroutine to speed up response time Jul 24, 2014
tykReverseProxy.go Formatted Aug 7, 2014

README.md

Tyk API Gateway

Tyk is a lightweight, open source API Gateway and enables you to control who accesses your API, when they access it and how they access it. Tyk will also record detailed analytics on how your users are interacting with your API and when things go wrong.


What is an API Gateway?

An API Gateway sits in front of your application(s) and manages the heavy lifting of authorisation, access control and throughput limiting to your services. Ideally, it should mean that you can focus on creating services instead of implementing management infrastructure. For example if you have written a really awesome web service that provides geolocation data for all the cats in NYC, and you want to make it public, integrating an API gateway is a faster, more secure route that writing your own authorisation middleware.

Key Features of Tyk

Tyk offers powerful, yet lightweight features that allow fine gained control over your API ecosystem.

  • RESTFul API - Full programatic access to the internals makes it easy to manage your API users, keys and Api Configuration from within your systems
  • Multiple access protocols - Out of the box, Tyk supports Token-based, HMAC Signed, Basic Auth and Keyless access methods
  • Rate Limiting - Easily rate limit your API users, rate limiting is granular and can be applied on a per-key basis
  • Quotas - Enforce usage quotas on users to manage capacity or charge for tiered access
  • Granular Access Control - Grant api access on a version by version basis, grant keys access to multiple API's or just a single version
  • Key Expiry - Control how long keys are valid for
  • API Versioning - API Versions can be easily set and deprecated at a specific time and date
  • Blacklist/Whitelist/Ignored endpoint access - Enforce strict security models on a version-by-version basis to your access points
  • Analytics logging - Record detailed usage data on who is using your API's (raw data only)
  • Zero downtime restarts - Tyk configurations can be altered dynamically and the service restarted without affecting any active request

Tyk is written in Go, which makes it fast and easy to set up. Its only dependencies are a Mongo database (for analytics) and Redis, though it can be deployed without wither (not recommended).

Why?

Tyk was built because other open source API Gateways in the market come with dependencies and bloat, attempting to be too many things to too many people. tyk is focused, simple and does one thing well - protecting your API from unauthorised access.

Documentation

All the documentation can be found on our main site at http://tyk.io/about/

License

Tyk is released under the MPL v2.0 please see the LICENSE.md file for a full version of the license.

Contribute / Build

To get started contributing, clone the repo to your local go workspace, change into the new tyk directory and run go get, this should retrieve all the dependencies.

We are working to increase test coverage of features, currently the majority of auth methods and middleware are tested, however it could always be better.

Any changes that are submitted with a pull request should come with a test and be in a separate branch. Basically, use this checklist:

  • Do your changes have tests?
  • Have you run the tests?
  • Did they pass?
  • Have you written a test for your feature?
  • Does it pass after merge?

If you can answer yes to all of the above, feel free to submit a pull request :-)

A note on the tests

Currently in order for tests to pass, a redis host is required. We know, this is terrible and should be handled with an interface, and it is, however in the current version there is a hard requirement for the application to have its default memory setup to use redis as part of a deployment, this is to make it easier to install the application for the end-user. Future versions will work around this, or we may drop the memory requirement.