mediawiki/guzzle-json-auth

Authenticate with a JSON endpoint using a configurable Guzzle client

mediawiki-guzzle-json-auth

Authenticate your MediaWiki with a JSON endpoint using a configurable Guzzle client, _(*1)

, _(*2)

Install

Requirements

• PHP >= 5.4
• Composer
• MediaWiki 1.22

Via Composer

``` bash $ composer require mediawiki/guzzle-json-auth, <sub>(*3)</sub>

## Usage

To Setup the authentication, add the following lines to your
LocalSettings.php and change the values to your needs:

```` php
# Setup GuzzleJsonAuth
$wgGuzzleJsonAuthUrl = 'http://yourapplication.com/your_json_endpoint';

$wgGuzzleJsonRequestBaseKey = 'User';
$wgGuzzleJsonRequestUsernameKey = 'username';
$wgGuzzleJsonRequestPasswordKey = 'password';

$wgGuzzleJsonResponseBaseKey = 'user';
$wgGuzzleJsonResponseUsernameKey = 'username';
$wgGuzzleJsonResponseRealNameKey = 'real_name';
$wgGuzzleJsonResponseEmailKey = 'email';

// Load and initialize the GuzzleJsonAuth extension
require_once("$IP/extensions/GuzzleJsonAuth/GuzzleJsonAuth.php");
$wgAuth = new \MediaWiki\GuzzleJsonAuth\GuzzleJsonAuth();
````

Authenticated users will be created in your Wikis database,
but without password.

The authentication endpoint needs to return at least tne
username, real name and email of the authenticated user as result.
If the authentication failed, it must not return the username,
otherwise it the user will be logged in nonetheless.

This extension will fall back to local authentication,
if the user could not be authenticated externally.

## Change log

Please see [CHANGELOG.md](CHANGELOG.md) for more information what has changed recently.

## Testing

``` bash
$ phpunit

Contributing

Please see CONTRIBUTING for details., <sub>(*4)</sub>

Security

If you discover any security related issues, please email ravage@bluewin.ch instead of using the issue tracker., <sub>(*5)</sub>

Credits

• Marc Würth
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*6)</sub>