Download the PHP package bmatovu/oauth-negotiator without Composer
On this page you can find all versions of the php package bmatovu/oauth-negotiator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download bmatovu/oauth-negotiator
More information about bmatovu/oauth-negotiator
Files in bmatovu/oauth-negotiator
Package oauth-negotiator
Short Description OAuth2 client token manager.
License MIT
Homepage https://github.com/mtvbrianking/oauth-negotiator
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package oauth-negotiator
OAuth Negotiator.
OAuth negotiator is a PHP Guzzle HTTP v6.x Client Middleware that will help you acquire, and refresh your access tokens automatically per application request to the OAuth2 server so you don't have to worry about non-existent or expired access tokens.
This package works by tapping into each request.
- First, checking if the request has an authorization header; if present, proceed to execute the request.
- If the request has no set authorization header, the available access token in storage is then added as the request authorization header.
- If no access token is present in storage, it shall request for a new access token from the OAuth server using the main grant type specified.
- If there's an existing access token in storage, but it's expired, and a refresh token grant was specified, it shall try to refresh the expired access token using the available refresh token.
See flowchart for detailed process illustration.
Grant types
The package supports four grant types out of box, that is; Client Credentials, Refresh Token, Password, and the Authorization Code grant type*.
You can implement your own custom grant type by simply implementing the GrantTypeInterface.
Tokens
These are the object mapping to the real life access token you would get from an OAuth Server. They implement the TokenInterface.
Token storage
The package also defaults to a file based persistent token storage, but you can still implement your custom persistent storage, say a session based token storage by implementing the TokenRepositoryInterface.
Exceptions
TokenNotFoundExceptionthrown by the token repository whenever in case of an unknown token.TokenRequestExceptionthrown by grant type on failure to acquire an access token.
Source code documentation
Installation
The package can be installed via composer.
composer require bmatovu/oauth-negotiator
Usage
Auto-load the package using composer so that it's available in your application scope.
Real documentation is still a work in progress, but for now examine the tests.
