LINEログインを始めよう

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

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

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

プラットフォームごとにLINEログインのスターターアプリを試すことができます：

• スターターアプリを試してみる - LINE SDK for iOS Swift
• サンプルアプリを試してみる - LINE SDK for Android
• スターターアプリを試してみる - LINE SDK for Unity

始める前に

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

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

Herokuの無料プランは廃止されました

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

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	❌	アプリの利用規約のURL	LINEログインおよびLIFFアプリ起動時の権限の同意画面
LINE開発者契約	✅	LINE開発者契約 (opens new window)を読んで同意します。	-
LINEヤフープライバシーポリシー	説明を参照	［サービスを提供する地域］でタイを選択した場合のみ必須です。タイのプライバシーポリシー (opens new window)を読んで承認します。	-

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

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

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

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

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

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

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

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

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

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

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

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

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

1. GitHubのline-login-starter (opens new window)リポジトリにアクセスします。
2. READMEファイル (opens new window)の［Deploy to Heroku］ボタンをクリックします。
3. Herokuの［Create New App］ページに必要な情報を入力します。
   • Heroku app name
     一意の名前を設定します。次のような名前を推奨します: line-login-starter-{YYYYMMDD}
   • Region
   • Config Vars
     • 次の形式のコールバックURL：https://{Heroku app name}.herokuapp.com/auth
     • チャネルID（LINE Developersコンソールで確認できます）
     • チャネルシークレット（LINE Developersコンソールで確認できます）
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
あなたのユーザーID	LINEアカウントのユーザーID
リンクされたLINE公式アカウント	チャネルにリンクされたLINE公式アカウント。友だち追加オプションで使用するLINE公式アカウントを選択します。同じプロバイダーに存在するMessaging APIチャネルと連携しているLINE公式アカウントのみを選択できます。
多言語対応	言語を追加することで、チャネルを多言語対応にすることができます。
メールアドレス取得権限	OpenID Connectを使用して、ユーザーのメールアドレスを要求できます。
チャネルの削除	チャネルの削除

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

1. ウェブアプリのURL（https://{Heroku app name}.herokuapp.com）にアクセスします。以下のように表示されます。

2. ［Log in］をクリックします。

   LINEログインの標準的なページにリダイレクトされます。リダイレクト先のURLは、https://access.line.me/oauth2/v2.1/で始まり、多くのクエリパラメータが含まれています。クエリパラメータについて詳しくは、「ウェブアプリにLINEログインを組み込む」を参照してください。

3. LINEにログインし、ウェブアプリに必要な権限を与えることを同意します。

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

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

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

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

ログを確認する

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

1. コマンドラインからHerokuにログインします。

   $ heroku login
   

2. ログを確認します。

   $ heroku logs --app {Heroku app name} --tail
   

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

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

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

• JDK 1.8以降
• Maven™ 3.0以降
• Git™

1. GitHubのline-login-starter (opens new window)リポジトリをクローンします。

   git clone https://github.com/line/line-login-starter.git
   

2. cdコマンドを実行して、line-login-starterディレクトリに移動します。

3. Heroku用リモートをローカルリポジトリに追加します。

   $ heroku git:remote -a {Heroku app name}
   

4. 変更を加えてコミットします（任意）。

   $ git add .
   $ git commit -m "First commit"
   

5. 変更をHerokuのmasterブランチにプッシュします。

   $ 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アカウントを連携させる」を参照してください。

次のステップ

• ウェブアプリにLINEログインを組み込む
• iOSアプリにLINEログインを組み込む - Swift
• AndroidアプリにLINEログインを組み込む
• UnityゲームにLINEログインを組み込む