BackEnd

WebアプリケーションにLINEログインを組み込む

投稿日:

はじめに

昨今では多くのWebサイトでTwitterやFacebookなどのアカウントを使ってログインすることができます。今回の記事ではWebアプリケーションにLINEログインを組み込む方法を紹介します。

LINEを選択した理由は以下の二点です。

  • 日本ではLINEを利用しているユーザが多い(と思われる)
  • ちょうど業務でLINEログインを実装している最中である

それでは、初めにLINEログインについて紹介します。

LINEログインとは

LINEログインとはその名の通り、ユーザのLINEのアカウントを利用して他のアプリやWebサービスにログインさせるサービスです。

LINEログインを利用することで、ユーザは簡単にアカウントを作成してログインすることができるようになり、アカウント登録の敷居を下げることができます。

LINEログインでできること

LINEログインを使えば簡単にアカウントを作成してログインできることはわかりました。しかし、LINEログインでできることはそれだけではありません。

LINEログインを利用すると以下のようなことができます。

  • ユーザ名やアイコン画像などのプロフィール情報の取得 ※1
  • LINEのユーザIDの取得 ※1
  • メールアドレスの取得 ※1
  • 関連するLINE公式アカウントと友達登録(任意)

※1 正確にはLINEログインで取得した code を利用した Social API で取得

LINEログインのフロー

LINEログイン(Webログイン)は以下のようなフローで処理されます。

  1. ユーザがWebページなどに設置されたLINEログインボタンなどをクリック(タップ)する
  2. Webアプリは必要なクエリパラメータを付加したLINEログイン画面へリダイレクトする
  3. ユーザは自分のLINEアカウントでログインし、Webアプリからの権限の要求を許可する
  4. LINEのサーバはクエリパラメータで指定された redirect_url に必要なクエリパラメータを付加してリダイレクトする
  5. Webアプリはクエリパラメータに含まれる認可コードを使って、APIでLINEのサーバにアクセストークンを要求する
  6. LINEのサーバはリクエストを検証し、問題なければアクセストークンをWebアプリに返却する

こちらにログインフローの図があります。

LINEログインの設定

LINEログインを利用するには LINE Developers にログインしてコンソールから必要な設定を行っておく必要があります。こちらからログイン画面に遷移して、LINEの登録時に設定したメールアドレスとパスワードでログインします。

プロバイダーを新規作成する

ログインするとプロバイダーリストが表示されます。

任意のプロバイダー名を入力して「確認」をクリックします。

「作成する」をクリックするとプロバイダーが作成されます。

チャネルを作成する

プロバイダーを作成したら新規チャネル作成の画面が表示されます。

「LINEログイン」のチャネルを作成します。

アイコン、アプリ名、アプリの説明などを入力して「入力内容を確認する」をクリックします。

※ WEBで使うにチェックをいれます。

「LINE Developers Agreement の内容に同意します」にチェックを入れて「作成」をクリックします。

リダイレクト先を登録する

ユーザがLINEログインした後にリダイレクトするURLを指定します。アプリの設定タブをクリックし、Callback URLを設定します(httpsで指定します)

LINEログインの実装

コンソールの設定が完了したところで、実装を見ていきましょう。

まず初めにLINEのサーバに対して認可を要求します。

認可を要求

以下のURLにクエリパラメータを付加してリダイレクトします。

https://access.line.me/oauth2/v2.1/authorize

リクエストの例は以下のとおりです。

https://access.line.me/oauth2/v2.1/authorize?response_type=code&client_id=1234123412&redirect_uri=https%3a%2f%2fline%2dlogin%2dsample%2ecom%2fauth&state=1234asdf&scope=openid&nonce=1234asd

クエリパラメータについて個別に説明します。

response_type 必ず code を指定する
client_id チャネル基本設定のChannel ID
redirect_uri アプリ設定でしていしたCallback URLと同じにする
state CSRF防止用の文字列。URLエンコードされた文字列は使用不可
scope profile、openid、emailを空白文字(%20)で区切った文字列
nonce リプレイアタック防止用の文字列

クエリパラメータの詳細はこちらをご覧ください。

ログイン後、ユーザから権限を許可されると指定した Callback URL に必要なクエリパラメータとともにリダイレクトされます。

レスポンスの例は以下のとおりです。

リクエストのクエリパラメータに付加した state の値とレスポンスのクエリパラメータに付加された state の値を比較し、一致すれば code の値を使ってアクセストークンを要求します。

アクセストークンを要求

アクセストークンは認可要求で取得した code の値をPOST APIで送って取得します。APIのエンドポイントは以下のとおりです。

https://api.line.me/oauth2/v2.1/token

このAPIのリクエストヘッダには Content-type: application/x-www-form-urlencode を含めます。

リクエストボディには以下の情報を含めます。

grant_type 必ず authorization_code を指定する
code 認可要求で取得した code
redirect_uri コールバックURL
client_id チャネル基本設定のChannel ID
client_secret チャネル基本設定のChannel Secret

LINEのサーバの検証が通ると以下のようにアクセストークン等のデータが返却されます。

レスポンスデータの内、id_token はユーザ情報を含むJWTトークンです。このトークンには認可要求の scope に応じてユーザID、ユーザ名、プロフィール画像、メールアドレスなどが含まれます。

レスポンスデータの詳細はこちらをご覧ください。

IDトークンを検証する

IDトークンはユーザ情報を含むJWTです。このトークンはヘッダー、ペイロード、署名がピリオドで区切られており、それぞれbase64urlエンコードされています。

これらの3つの内、ペイロードにはユーザ情報が含まれています。ペイロードの中身についてはこちらをご確認ください。

IDトークンの検証の流れは以下のとおりです。

  1. IDトークンをピリオドで分割する
  2. それぞれをbase64urlでデコードする
  3. base64urlでエンコードされたヘッダー、ピリオド、及びペイロードをつなげた文字列をチャネルシークレットを鍵としてハッシュ値を算出し、デコードした署名と一致することを検証する
  4. ペイロードに含まれる iss の値が https//access.line.me であることを検証する
  5. ペイロードに含まれる aud の値がチャネルIDと一致することを検証する
  6. ペイロードに含まれる exp の値が検証時点より後のタイムスタンプであることを検証する
  7. ペイロードに含まれる nonce の値が認可リクエストでクエリパラメータに指定した文字列と一致することを検証する

さいごに

WebアプリケーションにLINEログインを組み込む方法を紹介しました。今後、機会があれば Messaging API についても紹介できればと思います。

おすすめ書籍

世界一わかりやすい LINE公式アカウントマスター養成講座 ITの常識が変わる! 成長する企業はなぜSSO(シングルサインオン)を導入するのか

blog-page_footer_336




blog-page_footer_336




-BackEnd
-, , ,

執筆者:


comment

メールアドレスが公開されることはありません。 が付いている欄は必須項目です

CAPTCHA


関連記事

laravel logo

LaravelのFacade(ファサード)とは? 何気なく使用していた裏側の仕組みを解説!

1 はじめに1.1 Facadeを使用しているクラス2 Facadeの仕組み3 Facadeの作成3.1 サンプルコードに必要な実装3.2 Serviceの作成3.3 Facadeクラスの作成3.4 ...

rails

Shrineを使って画像をアップロードする

1 はじめに2 Shrineとは2.1 簡単な説明2.2 作者2.3 特徴3 下準備3.1 Gemを追加3.2 初期設定3.3 テーブルを作成する4 実装4.1 Uploaderの実装4.2 Mode ...

laravel logo

Laravel Authのパスワードリセット機能をカスタマイズする

1 はじめに2 準備2.1 Auth2.2 mailhog3 ユーザー登録とログイン4 パスワードリセットのカスタマイズ4.1 ルーティング確認4.2 view編集4.3 認証処理の編集5 リセット画 ...

RSpecの個人的Tips集〜その1〜

1 はじめに2 テストコードの実行をスキップする3 共通のテストコードを用意する4 外部APIの返却値をスタブにする5 さいごに はじめに みなさん、テストコードは書かれているでしょうか? 私も極力書 ...

laravel logo

[Laravel] ログの扱い方 [5.8]

1 はじめに2 環境3 Monologについて4 コード上で設定する方法5 config/logging.phpで設定する方法6 おまけ:ログレベルについて7 さいごに8 おすすめ書籍 はじめに こん ...

フォロー

blog-page_side_responsive

2019年9月
1234567
891011121314
15161718192021
22232425262728
2930  

アプリ情報

私たちは無料アプリもリリースしています、ぜひご覧ください。 下記のアイコンから無料でダウンロードできます。