Download the PHP package cilogon/oauth2-orcid without Composer
On this page you can find all versions of the php package cilogon/oauth2-orcid. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download cilogon/oauth2-orcid
More information about cilogon/oauth2-orcid
Files in cilogon/oauth2-orcid
Package oauth2-orcid
Short Description ORCID OAuth 2.0 Client Provider for The PHP League OAuth2-Client
License NCSA
Informations about the package oauth2-orcid
ORCID Provider for the OAuth 2.0 Client
This package provides ORCID OAuth 2.0 support for the PHP League's OAuth 2.0 Client.
ORCID provides a persistent digital identifier for researchers. See Getting Started for information on integrating your application with ORCID. You will eventually need to register your application to get an ORCID client id and client secret for your integration.
This package is compliant with PSR-1, PSR-4 and PSR-12. If you notice compliance oversights, please send a patch via pull request.
Requirements
The following versions of PHP are supported.
- PHP 7.1 (v1.x)
- PHP 7.2 (v1.x)
- PHP 7.3 (v1.x)
- PHP 7.4 (v2.x)
- PHP 8.0 (v2.x)
- PHP 8.1 (v2.x)
Installation
To install, use composer:
Usage
Authorization Code Flow
Sandbox vs Production
In order to authenticate ORCID users and read associated attributes, you would typically use the Production Registry. However, for special integrations, you may want to register for a Sandbox application. To use the Sandbox
environment, set a 'sandbox' parameter to true
when creating the provider.
Note that you can use this in combination with the Member API (below).
Public API vs Member API
If you are an ORCID member, you can use the Member API instead of the Public API. To use the Member API, set a 'member' parameter to true
when creating the provider. The Member API provides an additional id_token field 'amr' (AuthnMethodRef). The value is either 'mfa' for users who have enabled two-factor authentication on their ORCID account, or 'pwd' otherwise. When using the Public API, getAmr()
returns null
.
`
Note that you can use this in combination with the Sandbox environment (above).
Refreshing a Token
Refreshing an ORCID token requires the value of the current access token as the Bearer Token for authentication. So your application needs to use both the current access token AND the refresh token to get a new access token (and associated refresh token).
License
The University of Illinois/NCSA Open Source License (NCSA). Please see License File for more information.