この記事はデジタル創作サークル UniProject Advent Calendar 2025 3 日目の記事です。

背景

当サークルでは現在、内製のメンバー管理・認証基盤アプリケーションの UniQUE なるものを制作しています。

UniQUE を作る上で以下の機能が必要になります。

OIDC/OAuth2.0
メンバー管理
- メンバー登録申請の管理

このメンバー登録申請は従来まで Google Form で管理しており、申請してきたのに Discord 鯖にいないので承認できないという人がそこそこいました。
そこで、UniQUE では Discord サーバーに自動的に追加したいなと思い、API を漁ってみました。

guilds.join スコープ

OAuth のリンクジェネレーターをみてみると、guilds.join なるスコープがあることがわかります。

これを使えばなんとなく参加させられるような気がします。

Add Guild Member

Discord のドキュメントに、こんな記述があります。

Adds a user to the guild, provided you have a valid oauth2 access token for the user with the guilds.join scope. Returns a 201 Created with the guild member as the body, or 204 No Content if the user is already a member of the guild. Fires a Guild Member Add Gateway event.

つまり、OAuth2.0 のアクセストークンがあれば、そのアプリの Bot がいるサーバーに参加させることができるようです。

curl でやってみる

OAuth のトークンの取得は割愛します。

curl -H "Authorization: Bot <Botのトークン>" -XPUT https://discord.com/api/v10/guilds/{guild.id}/members/{user.id} -d `{
  "access_token": "<OAuth2.0 トークン>"
}`

これで、参加させることができました！

最後に

当サークルでは、この Discord 連携機能も用いて OIDC を活用したサークル内認証基盤を構築中です。
もし興味がありましたら、下記リンクからご参加いただけますと幸いです！

⭐︎ 公式 HP ↓

⭐︎ 公式 Discord サーバー ↓