OAuth2.0 연동 편집하기

== 개요 ==
OAuth2.0을 위키에 물리는 방법에 대해 다루는 문서.

이 문서는 미디어위키에 내가 직접 만든 OAuth2.0 인증 서버를 연동하여 로그인 기능을 구현하는 과정을 설명한다.

== 전제 조건 ==

* 미디어위키 버전: 1.35 이상
* PHP 버전: 7.4 이상
* OAuth2 제공자(Authorization Server)는 RFC 6749를 준수
* 사용자 정보를 제공하는 <code>/userinfo</code> 엔드포인트 존재

== 과정 ==
{| class="wikitable"
!과정
!설명
!비고
|-
|확장기능 설치
|PluggableAuth(인증 플러그인 인터페이스), OAuth2Client(OAuth2 인증 연동용)를 설치한다.
|<syntaxhighlight lang="bash">
# extensions 디렉토리에서 다음의 코드를 차례대로 실행.
cd /var/www/html/mediawiki/extensions

# PluggableAuth 확장
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/PluggableAuth
cd PluggableAuth
git checkout REL1_43 # 버전 맞춰주는 과정.
composer install --no-dev

# OAuth2Client 확장
cd ..
git clone https://github.com/United-Earth-Team/MW-OAuth2Client.git OAuth2Client
cd OAuth2Client
composer install --no-dev --no-plugins --no-scripts # SSL 문제로.. 무시하기 위해서.
</syntaxhighlight>
|-
|LocalSettings.php
|일단 임시로 박아놓는다.
|<syntaxhighlight lang="php">
wfLoadExtension( 'PluggableAuth' );
wfLoadExtension( 'OAuth2Client' );

$wgPluggableAuth_Class = "OAuth2Client";

// 클라이언트 등록 정보
$wgOAuth2Client['client']['id'] = 'mediawiki-client-id';
$wgOAuth2Client['client']['secret'] = 'mediawiki-client-secret';
$wgOAuth2Client['client']['redirect_uri'] = 'https://smwiki.info/index.php/Special:PluggableAuthLogin';

// OAuth2 인증 서버 엔드포인트
$wgOAuth2Client['authorization']['endpoint'] = 'https://auth.example.com/oauth/authorize';
$wgOAuth2Client['token']['endpoint'] = 'https://auth.example.com/oauth/token';
$wgOAuth2Client['userinfo']['endpoint'] = 'https://auth.example.com/api/userinfo';

// 사용자 매핑 필드
$wgOAuth2Client['userinfo']['username'] = 'username';
$wgOAuth2Client['userinfo']['email'] = 'email';
$wgOAuth2Client['userinfo']['realname'] = 'realname'; // 선택

// 로그인 UI 설정
$wgPluggableAuth_EnableAutoLogin = false;
$wgPluggableAuth_ButtonLabel = "로그인 (OAuth2)";
</syntaxhighlight>
|-
|확인
|설치가 잘 되었는지 확인.
PluggableAuth와 
OAuth2Client이 잘 있나 확인.
|[[특수:버전]]
|-
|값 기입
|
|
|}

== OAuth2 서버 설정 ==
OAuth2 서버(내가 만든 인증 제공자)에 클라이언트 등록:

* 클라이언트 ID: <code>mediawiki-client-id</code>
* 리디렉션 URI: <code>https://smwiki.info/index.php/Special:PluggableAuthLogin</code>
* 권한 범위 (scope): <code>openid email profile</code> 등

[[분류:관리용 문서]]