GitHub ログインを連携する
自分のサービスの利用者が GitHub アカウントで登録できるようにするには、GitHub 側に自分のサービスを登録して、Client ID と Client secret を受け取る必要があります。
このページは、Client ID と Client secret を受け取る手順を案内します。受け取った二つの値を WEEGLOO に入れる方法はClient ID と Client secret を WEEGLOO に入れるにあります。
GitHub で Client ID と Client secret を受け取る
GitHub にログインしたあと、以下の二つのステップを順に進めてください。ここで行う作業に費用はかかりません。
OAuth App を登録する
Client ID と Client secret は、ここで登録する一つのアプリに入っています。
-
開発者設定の画面(https://github.com/settings/developers (新しいタブで開きます))を開いてください。
-
左メニューで OAuth Apps を押してください。
-
New OAuth app を押してください。
-
Application name に、利用者に見せる名前を入力してください(例:
ぬくもりクローゼット)。 -
Homepage URL に自分のサイトのアドレスを入力してください(例:
https://nukumori-closet.com)。まだサイトがない場合は、これから使うアドレスを書いておいてください。あとから修正できます。フォームに一緒にある Application description は任意の項目で、書くと利用者にそのまま表示されるので、利用者が読む文章として書いてください。
-
Redirect URI の欄に、下のアドレスを貼り付けてください。自分の Space を選ぶと識別子が埋まります。
Spacehttps://auth.weegloo.com/v1/spaces/{spaceId}/login/oauth2/code/github自分の Space がどれか分からず、AI エージェントに連携を任せている場合は、エージェントに尋ねる方法もあります。チャットで「GitHub ログインに登録するリダイレクトアドレスを教えて」とリクエストすると、完成したアドレスを受け取れます。
-
Register application を押してください。
Client ID と Client secret をコピーする
Register application を押すと、いま登録したアプリの設定画面が開きます。Client ID はここにすでに表示されていて、Client secret はボタンを押していま作ります。
-
Client ID に書かれている値をコピーしておいてください。
-
Client secrets の見出しの右にある Generate a new client secret を押してください。
-
作られた値の右にあるコピーアイコンを押して、secret をコピーしておいてください。
この画面を離れると secret を二度と見られません
Client ID はこの画面に残り続けるので、いつでも見直せますが、secret はそうではありません。なくした場合は Generate a new client secret で新しく作り、受け取り直した値を WEEGLOO にもう一度入力してください。secret は名前のとおり秘密の値です。他の人に教えたり、公開された場所に書き残したりしないでください。
ログインにはメールアドレスの公開が必要です
GitHub ログインには条件が一つ付きます。ログインする GitHub アカウントが、メールアドレスを公開している必要があります。
WEEGLOO は、利用者が GitHub でログインするときにそのアカウントの公開メールアドレスもあわせて受け取り、会員に保存します。同じ Space では一つのメールアドレスで一度だけ登録できます。公開メールアドレスを指定していないアカウントではこの値が渡されず、そこで登録が止まります。
止まると、利用者は WEEGLOO が表示する案内画面を見ることになります。メールアドレスを取得できなかったことと、何をすればよいかが利用者の言語で書かれていて、自分のサイトへ戻るボタンも付いています。
このときログイン結果は自分のサイトまで届きません。ですから、自分のサイトのコードではこの状況に気づくことも、代わりに処理することもできません。
この問題は利用者が自分で解決する必要があります。利用者が GitHub アカウントの設定(https://github.com/settings/profile (新しいタブで開きます))で Public profile を開くと、Public email の項目があります。ここで表示するメールアドレスを選べば、次のログインから通ります。まだ選んでいないアカウントには Select a verified email to display とだけ書かれています。
自分のサイトでできるのは、GitHub でログインする場所にこの条件をあらかじめ書いておき、利用者が行き詰まる前に知らせることです。
Client ID と Client secret を WEEGLOO に入れる
これで Client ID と Client secret が手元にあります。ここから先は、これまでどのように作業してきたかによって分かれます。
コンテンツスタジオで直接設定していた場合は、次のように進めてください。
- サービス会員ログインのソーシャルログインを有効にする手順に戻ってください。
- GitHub を有効にしてください。
- Step 2 の Client ID の欄に Client ID を入力してください。
- Client Secret の欄に Client secret を入力してください。
- 保存 を押してください。
AI エージェントに連携を任せていて、Client ID と Client secret を受け取ってくるように案内された場合は、受け取った二つの値をそのままチャットに貼り付けて、作業を続けてください。残りの設定はエージェントが引き続き処理します。
次にやること
- サービス会員ログイン: 受け取った値をコンテンツスタジオに入力し、会員ログインの残りの設定を終えます。
- メンバーのロールと権限: 登録した会員が何を見て使えるかを定める ServiceUserRole を作ります。
- Auth API: ログインを自分のサイトのコードに組み込むときに必要となる、リクエスト形式などの技術仕様を扱います。