Extension:WikimediaApiPortalOAuth

From mediawiki.org
MediaWiki extensions manual
WikimediaApiPortalOAuth
Release status: stable
Implementation User interface
Description Extension to provide user interface and API client support to the Wikimedia API Portal
MediaWiki 1.35+
License GNU General Public License 2.0 or later
Download
  • $wgWikimediaApiPortalOAuthMetaApiURL
  • $wgWikimediaApiPortalOAuthMetaRestURL
  • wikimediaapiportaloauth-manage-oauth
Quarterly downloads 1 (Ranked 148th)
Translate the WikimediaApiPortalOAuth extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The WikimediaApiPortalOAuth extension is designed to connect the API Portal with the OAuth server on Meta-Wiki by providing a user interface for creating and managing OAuth 2.0 clients. This extension requires the ability to connect to a wiki acting as an OAuth controller and running OAuth 1.36 or later.

Download

The extension can be retrieved directly from Git [?]:

  • Browse code
  • Some extensions have tags for stable releases.
  • Each branch is associated with a past MediaWiki release. There is also a "master" branch containing the latest alpha version (might require an alpha version of MediaWiki).

Extract the snapshot and place it in the extensions/WikimediaApiPortalOAuth/ directory of your MediaWiki installation.

If you are familiar with Git and have shell access to your server, you can also obtain the extension as follows:

cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/WikimediaApiPortalOAuth.git

Installation

WikimediaApiPortalOAuth requires MediaWiki 1.35 or later.

  • Download and place the file(s) in a directory called WikimediaApiPortalOAuth in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
wfLoadExtension( 'WikimediaApiPortalOAuth' );
  • Yes Done - Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration

On the wiki where WikimediaApiPortalOAuth is installed, set $wgWikimediaApiPortalOAuthMetaRestURL to the URL for rest.php on the OAuth controller wiki. For example, in the case of the beta Wikimedia API Portal, the OAuth controller wiki is the beta instance of Meta-Wiki (https://meta.wikimedia.beta.wmflabs.org/w/rest.php). To allow WikimediaApiPortalOAuth to make requests to the OAuth server, set $wgRestAllowCrossOriginCookieAuth to true on the OAuth controller wiki.

Variable name Required? Default Type Description
$wgWikimediaApiPortalOAuthMetaRestURL Optional https://meta.wikimedia.org/w/rest.php String URL for rest.php on the OAuth controller wiki

Usage

The Special:AppManagement page provides a simplified set of options for creating and managing OAuth 2.0 clients. The extension supports creating two types of OAuth 2.0 clients:

  • owner-only clients
  • clients with authorization code, client credentials, and refresh token grant types

For more information about OAuth 2.0, visit OAuth/For Developers.