Download the PHP package gecka/socialite-ncconnect without Composer
On this page you can find all versions of the php package gecka/socialite-ncconnect. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
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 socialite-ncconnect
NcConnect
NC Connect OAuth2 Provider for Laravel Socialite.
About
NcConnect is a Laravel Socialite provider for NC Connect, the authentication platform of the Government of New Caledonia. It implements the OpenID Connect protocol over the NC Connect V3 (Keycloak) infrastructure.
Features
- OAuth2 / OpenID Connect authentication flow
- Nonce validation on id_token (replay attack protection)
- User profile with identity claims (name, email, birthdate, gender, etc.)
- Typed accessors on the User object for NC Connect specific claims
- Token refresh support (V3 tokens expire after 30 minutes)
- Logout with post-redirect URI (RP-Initiated Logout)
- Configurable authentication method (
client_secret_basicorclient_secret_post) - Automatic environment switching (production / development)
Requirements
- PHP 8.2+
- Laravel 10+
- A registered NC Connect client (contact [email protected])
Installation
Configuration
Add to config/services.php:
Register the provider
Laravel 11+ — in app/Providers/AppServiceProvider.php:
Laravel 10 — in app/Providers/EventServiceProvider.php:
Usage
Authentication
Refreshing tokens
Access tokens expire after 30 minutes in V3. Use the built-in refreshToken() method:
Logout
The generateLogoutURL() method builds an RP-Initiated Logout URL.
The id_token_hint is available on the User object after authentication:
User object
The returned User object extends the Socialite base user with typed accessors for NC Connect claims:
| Accessor | Return type | Description |
|---|---|---|
$user->id |
string |
Unique identifier (sub) |
$user->email |
?string |
Email address |
$user->isEmailVerified() |
bool |
Whether the email is verified |
$user->getVerifiedLevel() |
int |
Verification level (0 = unverified, 1 = declarative, 2 = digital) |
$user->getPreferredUsername() |
string |
Display name |
$user->getGivenName() |
string |
All given names |
$user->getFirstName() |
string |
First given name only |
$user->getFamilyName() |
string |
Family name |
$user->getBirthdate() |
string |
Date of birth (YYYY-MM-DD) |
$user->getGender() |
string |
Gender (male/female) |
$user->getBirthplace() |
string |
Place of birth |
$user->tokenId |
?string |
ID token hint (for logout) |
$user->token |
string |
Access token |
$user->refreshToken |
?string |
Refresh token |
$user->expiresIn |
int |
Token expiry in seconds |
All attributes are also accessible via $user->getRaw() for the full userinfo response.
Scopes
Default: openid, identite_pivot, profile, email
Available: openid, profile, email, birth, identite_pivot
Authentication methods
| Method | Config value | Description |
|---|---|---|
| Client Secret Basic | client_secret_basic (default) |
Credentials sent as Basic auth header |
| Client Secret Post | client_secret_post |
Credentials sent in POST body |
Configuration reference
| Env variable | Description | Default |
|---|---|---|
NCCONNECT_CLIENT_ID |
OAuth2 client ID | — |
NCCONNECT_CLIENT_SECRET |
OAuth2 client secret | — |
NCCONNECT_REDIRECT_URI |
Callback URL after login | — |
NCCONNECT_LOGOUT_REDIRECT |
Redirect URL after logout | — |
NCCONNECT_FORCE_DEV |
Force dev endpoints in production | — |
NCCONNECT_AUTH_METHOD |
Authentication method | client_secret_basic |
Upgrading
Migrating from NC Connect V2 to V3 (Keycloak)? See UPGRADE.md.
License
This project is released under the MIT License.
Authors
- Adil Kachbat [email protected]
- Laurent Dinclaux Gecka
Built with 🥥 and ☕ by Gecka — Kanaky-New Caledonia 🇳🇨
