API key explained

An application programming interface (API) key is a unique identifier used to authenticate and authorize a user, developer, or calling program to an API.[1] However, they are typically used to authenticate and authorize a project with the API rather than a human user.[2]

Usage

The API key often acts as both a unique identifier and a secret token for authentication and authorization, and will generally have a set of access rights on the API associated with it.[3]

HTTP APIs

API keys for HTTP-based APIs can be sent in multiple ways:[4]

In the query string:POST /something?api_key=abcdef12345 HTTP/1.1As a request header:GET /something HTTP/1.1X-API-Key: abcdef12345As a cookie:GET /something HTTP/1.1Cookie: X-API-KEY=abcdef12345

Security

API keys are generally not considered secure; they are typically accessible to clients, making it easy for someone to steal an API key. Once the key is stolen, it has no expiration, so it may be used indefinitely, unless the project owner revokes or regenerates the key.[2] Since API keys must only be accessible to the client and server, authentication using API keys is only considered secure when used in conjunction with other security mechanisms such as HTTPS.

Incidents

In 2017, Fallible, a Delaware-based security firm examined 16,000 android apps and identified over 300 which contained hard-coded API keys for services like Dropbox, Twitter, and Slack.[5]

References

Book sources

External links

Notes and References

  1. Web site: API Key - What is an API Key?. Last Call - RapidAPI Blog. en-US. 2019-09-20.
  2. Web site: Why and when to use API keys Cloud Endpoints with OpenAPI. Google Cloud. en. 2019-09-20.
  3. Web site: 2018-06-12 . Generating API Keys . dead . https://web.archive.org/web/20210923065718/https://www.ibm.com/docs/en/asoc/1.0.0?topic=api-generating-keys . 2021-09-23 . 2023-04-03 . www.ibm.com . en-us.
  4. Web site: API Keys. live. https://web.archive.org/web/20191017214615/https://swagger.io/docs/specification/authentication/api-keys/ . 2019-10-17 .
  5. Web site: Hundreds of popular Android apps contain hard-coded secret keys . 2022-06-20 . . en.