LINEログインを始めよう

ここでは、簡単なウェブアプリ用のスターターアプリをデプロイして、LINEログインを利用する方法を説明します。スターターアプリにアクセスすると、ユーザーのLINEアカウントでログインできます。また、ログイン時に発行されるアクセストークンを利用して、ユーザープロフィールを取得することもできます。

このページの操作をすべて行うと、LINEログインの仕組みや、LINEログインをウェブアプリに組み込む方法について、よく理解できます。

LINE SDK fo iOS/Android/Unityのスターターアプリ

始める前に

LINEログインのスターターアプリを利用するには、以下の要件を満たす必要があります。

項目説明
LINEアカウントLINEを利用するためのアカウントです。LINEアカウントは、スターターアプリを試すために必要です。LINEアカウントを作成するには、iOS版LINEまたはAndroid版LINEをダウンロードして、新規登録をしてください。登録方法について詳しくは、『LINEみんなの使い方ガイド』の「新規登録をする」を参照してください。
プロバイダープロバイダーは、アプリを提供する個人または組織を表す概念です。プロバイダーは、LINE Developersコンソールで作成します。1人のLINEユーザーは、プロバイダーごとに異なるユーザーIDを持ちます。
LINEログインのチャネルチャネルは、アプリとLINEプラットフォームを接続するための通信路です。プロバイダーの中に作成します。アプリごとに、チャネルを作成する必要があります。LINEログインのチャネルは、LINE Developersコンソールで作成します。
注:
  • LINE Developersコンソールを利用したことがない場合は、開発者として登録してからチャネルを作成します。
  • スターターアプリを利用するためにLINEログインのチャネルを作成する際は、[アプリタイプ]で、[ウェブアプリ]を選択してください。
HerokuアカウントHerokuは、ウェブアプリをホストできるサービスです。スターターアプリをHerokuにデプロイするため、Heroku以外のサーバーを用意する必要がありません。
Heroku CLIHerokuの機能を利用するには、Heroku Command Line Interface (CLI) が必要です。
Herokuの無料プランは廃止されました

Herokuの無料プランは、2022年11月27日をもって廃止されました。このスターターアプリを無料で試したい場合は、他のプラットフォームを利用してください。詳しくは、「Heroku’s Next Chapter」を参照してください。

Step 1: LINEログインのチャネルを作成する

まずは、LINEログインのチャネルを作成します。

チャネルは、アプリとLINEプラットフォームを接続するための通信路です。ウェブアプリごとに、LINE DevelopersコンソールでLINEログインのチャネルを作成します。

  1. LINE Developersコンソールにアクセスします。
  2. プロバイダーを選択し、[チャネル設定]タブから[LINEログイン]を選択します。
  3. チャネルに必要な情報を入力します。以下の項目に情報を入力してLINEログインのチャネルを作成します。
項目入力必須項目説明ユーザーに表示される画面
チャネルの種類チャネルの種類。LINEログインを選択して、LINEログインチャネルを作成します。-
プロバイダーチャネルのプロバイダーLINEログインおよびLIFFアプリ起動時の権限の同意画面
サービスを提供する地域LINEログインを組み込んだサービスを提供する地域。以下のいずれかを選択します。
  • 日本
  • タイ
  • 台湾
  • インドネシア
※複数の地域でサービスを提供する場合は、地域ごとにチャネルを作成します。
-
会社・事業者の所在国・地域チャネルを管理する会社・事業者の所在国・地域LINEログインおよびLIFFアプリ起動時の権限の同意画面
チャネルアイコンチャネルのアイコンLINEログインおよびLIFFアプリ起動時の権限の同意画面
チャネル名チャネルの名前
※チャネル名には、「LINE」またはそれに類する文字列を含めることはできません。
LINEログインおよびLIFFアプリ起動時の権限の同意画面
チャネル説明チャネルの説明LINEログインおよびLIFFアプリ起動時の権限の同意画面
アプリタイプLINEログインを組み込むアプリの種類。以下のいずれかを選択します。
  • ウェブアプリ
  • ネイティブアプリ
※ スターターアプリをデプロイする場合は、[ウェブアプリ]を選択してください。
-
メールアドレスチャネルに関する重要な更新情報を受信するメールアドレス-
プライバシーポリシーURL説明を参照アプリのプライバシーポリシーのURL。認証プロバイダーの場合は必須です。LINEログインおよびLIFFアプリ起動時の権限の同意画面
サービス利用規約URLアプリの利用規約のURLLINEログインおよびLIFFアプリ起動時の権限の同意画面
LINE開発者契約LINE開発者契約を読んで同意します。-
LINEヤフープライバシーポリシー説明を参照サービスを提供する地域]でタイを選択した場合のみ必須です。タイのプライバシーポリシーを読んで承認します。-

チャネルとプロバイダーの連携に関する注意点

一度作成したチャネルを、後から他のプロバイダーに移動することはできません。

LINEログインチャネルとMessaging APIチャネルを連携するサービスを開発する場合は、これらのチャネルを同じプロバイダーの配下に作成してください。

開発者が提供するサービスを利用するLINEユーザーには、プロバイダーごとに異なるユーザーIDが割り当てられます。異なるプロバイダーに属するチャネル間では、ユーザーIDを利用して同一ユーザーであることを確認できません。

チャネル作成時に特に注意が必要なケース

たとえば、以下のような場合には特に注意してください。

  • チャネルとプロバイダーを別々の個人または企業が管理している。
  • 1つのプロバイダー配下に、相互に関係がないサービスや企業のチャネルを作成する。
  • チャネルの運用ツール等を運営するサービス(企業)が管理するプロバイダーの配下にチャネルを作成する。

このようなケースでは、後からチャネルをプロバイダー間で移動できないことや、プロバイダーごとに異なるユーザーIDが割り当てられることに起因して、将来的に問題が発生する可能性があります。そのリスクを十分検討した上で、適切なプロバイダーの配下にチャネルを作成してください。

プロバイダーとチャネル管理のベストプラクティス

プロバイダーとチャネルについては、Admin権限の管理や、どのプロバイダー配下にチャネルを作成するべきかなどについて、具体例を交えて解説しているページがあります。

詳しくは、『LINE Developersコンソール』ドキュメントの「プロバイダーとチャネル管理のベストプラクティス」を参照してください。

Step 2: スターターアプリをデプロイする

次に、Herokuにスターターアプリをデプロイします。Step 1で作成したチャネルのチャネルIDとチャネルシークレットを利用します。以下の操作を行ってください。

  1. GitHubのline-login-starterリポジトリにアクセスします。
  2. READMEファイルの[Deploy to Heroku]ボタンをクリックします。
  3. Herokuの[Create New App]ページに必要な情報を入力します。
    • Heroku app name
      一意の名前を設定します。次のような名前を推奨します: line-login-starter-{YYYYMMDD}
    • Region
    • Config Vars
  4. Deploy app]をクリックし、アプリが正常にデプロイされたことを確認します。

Step 3: チャネルの設定確認し、コールバックURLを入力する

ウェブアプリ用のLINEログインのチャネルを使用する場合は、[アプリタイプ]と[コールバックURL]が正しく設定されている必要があります。

  1. LINE Developersコンソールで、Step 1で作成したチャネルを選択します。
  2. チャネル基本設定]タブをクリックし、[アプリタイプ]に[ウェブアプリ]が表示されていることを確認します。
  3. LINEログイン設定]タブをクリックし、[コールバックURL]にHerokuのコールバックURL(https://{Heroku app name}.herokuapp.com/auth)を入力します。

LINEログインのチャネル基本設定

LINEログインチャネルの[チャネル基本設定]タブで表示される情報は以下のとおりです。

項目説明
チャネルIDチャネルを区別するための識別子
サービスを提供する地域LINEログインサービスを提供する地域(チャネル作成時のみ設定可能)
会社・事業者の所在国・地域チャネルを管理する会社・事業者の所在国・地域
チャネルアイコンチャネルのアイコン
チャネル名チャネルの名称
チャネル説明チャネルの詳細説明
メールアドレスチャネルに関する重要なお知らせを受信するメールアドレス
プライバシーポリシーURLアプリのプライバシーポリシーのURL
サービス利用規約URLアプリの利用規約のURL
アプリタイプLINEログインを組み込むアプリの種類
権限このチャネルがアクセスできるユーザー情報の種類
チャネルシークレットアプリに対して、チャネルへのアクセスを許可したことを示す秘密鍵
アサーション署名キーアサーション署名キーペアに紐づいたUUID
あなたのユーザーIDLINEアカウントのユーザーID
リンクされたLINE公式アカウントチャネルにリンクされたLINE公式アカウント。友だち追加オプションで使用するLINE公式アカウントを選択します。同じプロバイダーに存在するMessaging APIチャネルと連携しているLINE公式アカウントのみを選択できます。
多言語対応言語を追加することで、チャネルを多言語対応にすることができます。
メールアドレス取得権限OpenID Connectを使用して、ユーザーのメールアドレスを要求できます。
チャネルの削除チャネルの削除

Step 4: ウェブアプリを試す

  1. ウェブアプリのURL(https://{Heroku app name}.herokuapp.com)にアクセスします。以下のように表示されます。
    LINEログインのスターターアプリのログイン画面
  2. Log in]をクリックします。
    LINEログインの標準的なページにリダイレクトされます。リダイレクト先のURLは、https://access.line.me/oauth2/v2.1/で始まり、多くのクエリパラメータが含まれています。クエリパラメータについて詳しくは、「ウェブアプリにLINEログインを組み込む」を参照してください。
  3. LINEにログインし、ウェブアプリに必要な権限を与えることを同意します。

LINEアカウントでログインすると、LINEユーザーのプロフィール画像、表示名、およびステータスメッセージが表示されます。(iOSまたはAndroidを使用していて、すでにLINEアカウントでログイン済みの場合は、自動的にウェブアプリにログインされます。)

スターターアプリのその他の機能を試す

ウェブアプリにログインした後で以下のボタンをクリックすると、ウェブアプリのその他の機能を試すことができます。

  • ユーザーのアクセストークンを検証する
  • ユーザーのアクセストークンを更新する
  • アクセストークンを取り消す(ユーザーをログアウトさせる)

ログを確認する

Heroku CLIを使用して、ウェブアプリのログを確認します。

  1. コマンドラインからHerokuにログインします。
    sh
    $ heroku login
    
  2. ログを確認します。
    sh
    $ heroku logs --app {Heroku app name} --tail
    

Step 5: ウェブアプリをカスタマイズする

スターターアプリをローカルコンピューターにダウンロードして、テストしたり修正したりできます。修正後は、任意のウェブサーバーにアプリをデプロイできます。ここでは、Step 1でデプロイしたHerokuアプリに変更を加えて、再デプロイする方法について説明します。

以下のソフトウェアをインストール済みであることを確認します。

  • JDK 1.8以降
  • Maven™ 3.0以降
  • Git™
  1. GitHubのline-login-starterリポジトリをクローンします。
    sh
    git clone https://github.com/line/line-login-starter.git
    
  2. cdコマンドを実行して、line-login-starterディレクトリに移動します。
  3. Heroku用リモートをローカルリポジトリに追加します。
    sh
    $ heroku git:remote -a {Heroku app name}
    
  4. 変更を加えてコミットします(任意)。
    sh
    $ git add .
    $ git commit -m "First commit"
    
  5. 変更をHerokuのmasterブランチにプッシュします。
    sh
    $ git push heroku master
    

Step 6: チャネルを公開する(任意)

LINEログインのチャネルは「開発中」のステータスで作成されます。チャネルが「開発中」の場合は、AdminまたはTesterの権限(詳しくは、「権限を管理する」を参照)を持つユーザーのみがLINEログインを利用できます。そのほかのユーザーもLINEログインを利用できるようにするには、ステータスを「公開済み」に変更してください。ステータスを「公開済み」にするには、LINE DevelopersコンソールでLINEログインのチャネルを表示し、ページ上部の[開発中]をクリックします。

LINEログインのテストのために使用する場合は、ステータスを変更する必要はありません。アプリのLINEログインを一般のユーザーが利用できるようにするときに限り、ステータスを「公開済み」に変更してください。なお、ステータスを「公開済み」に変更した場合、「開発中」に戻すことはできないため注意してください。

ステータスが「開発中」のLINEログインチャネルでのテスト方法

ステータスが「開発中」のLINEログインチャネルでテストを行う場合、チャネルでのテストが可能な権限が付与された開発者アカウントに、LINEアカウントが紐づけられている必要があります。開発者アカウントに紐づくビジネスIDにLINEアカウントを連携することで、開発者アカウントにLINEアカウントを紐づけることができます。

開発者アカウントには必ず1対1でビジネスIDが紐づけられていますが、ビジネスIDへのLINEアカウントの連携は任意です。そのため、ビジネスIDとLINEアカウントが連携されていない場合があります。LINEログインのテストを行う場合には、ビジネスIDとLINEアカウントが連携されているかを確認してください。

LINEログインのテストを行う際には、開発アカウントと紐づいているLINEアカウントでログインをする必要があります。ビジネスIDに登録しているメールアドレスとパスワードでは、ログインはできないことに注意してください。

ビジネスIDとLINEアカウントの連携について詳しくは、『LINE Developersコンソールドキュメント』の「ビジネスIDにLINEアカウントを連携させる」を参照してください。

次のステップ